InkPicture.SetWindowInputRectangle, méthode

Article
11/05/2008

Mise à jour : November 2007

Définit le rectangle de la fenêtre, en pixels, dans lequel l'entrée manuscrite est tracée.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Sub SetWindowInputRectangle ( _
    windowInputRectangle As Rectangle _
)
'Utilisation
Dim instance As InkPicture
Dim windowInputRectangle As Rectangle

instance.SetWindowInputRectangle(windowInputRectangle)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public:
void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public void SetWindowInputRectangle(
    Rectangle windowInputRectangle
)

public function SetWindowInputRectangle(
    windowInputRectangle : Rectangle
)

Paramètres

windowInputRectangle
Type : System.Drawing.Rectangle
Rectangle de saisie en coordonnées de fenêtre.

Notes

Par défaut, le rectangle de saisie de la fenêtre a la valeur {0,0,0,0}. Ce rectangle par défaut correspond à la taille de la fenêtre.

Pour redéfinir le rectangle de saisie de la fenêtre sur un rectangle vide avec les coordonnées par défaut, passez {0,0,0,0} dans l'appel à la méthode SetWindowInputRectangle, plutôt que la valeur nullune référence null (Nothing en Visual Basic) (Nothing en Microsoft® Visual Basic® .NET).

Vous ne pouvez pas passer un rectangle dont la valeur de la propriété Right (page pouvant être en anglais) est inférieure à celle de la propriété Left (page pouvant être en anglais) ou dont la valeur de la propriété Bottom (page pouvant être en anglais) est inférieure à celle de la propriété Top (page pouvant être en anglais). Par exemple, un rectangle avec les paramètres {500, 500, 400, 400} n'est pas valide.

Un rectangle situé dans un espace dont les coordonnées sont négatives peut être spécifié mais il ne correspond à rien, car il produit toujours une fenêtre sur laquelle il n'est pas possible d'écrire.

Attention :
Si vous définissez le rectangle de saisie de la fenêtre pour qu'il chevauche un contrôle Splitter (page pouvant être en anglais) ou les bordures de la fenêtre, des résultats imprévisibles peuvent se produire lors du redimensionnement de la fenêtre

Exemples

Cet exemple C# appelle la méthode SetWindowInputRectangle pour affecter la taille de la fenêtre de l'objet InkPicture (theInkPicture), à laquelle il est attaché, à la zone d'entrée manuscrite.

[C#]

using Microsoft.Ink;
//...
InkPicture theInkCollector;
public Form1()
{
    // Initialization
    theInkCollector = new InkPicture(Handle);
    Rectangle theRect = new Rectangle(0,0,0,0);
    theInkPicture.SetWindowInputRectangle(theRect);
    //...
}

Cet exemple Microsoft® Visual Basic® .NET appelle la méthode SetWindowInputRectangle pour affecter la taille de la fenêtre de l'objet InkPicture (theInkPicture), à laquelle il est attaché, à la zone d'entrée manuscrite.

[Visual Basic]

Imports Microsoft.Ink
Dim theInkPicture As InkPicture
Public Sub Form1()
    'Initialization
    Dim theRect As Rectangle
    theInkPicture = New InkPicture(Handle)
    theRect = New Rectangle(0,0,0,0)
    theInkPicture.SetWindowInputRectangle(theRect)
    '...
End Sub

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.