InkOverlay.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 InkOverlay
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 pour la saisie.

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 entière.

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 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 InkOverlay, theInkOverlay, à laquelle il est attaché, à la zone d'entrée manuscrite.

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

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

Imports Microsoft.Ink
Dim theInkOverlay As InkOverlay
Public Sub Form1()
    'Initialization
    Dim theRect As Rectangle
    theInkOverlay = New InkOverlay(Handle)
    theRect = New Rectangle(0,0,0,0)
    theInkOverlay.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.