InkCollector.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 InkCollector
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.

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.

Remarque :
Cette fonction peut être exécutée à nouveau si elle est appelée dans certains gestionnaires de messages et provoquer des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Cette fonction peut être exécutée à nouveau si elle est appelée dans certains gestionnaires de messages et provoquer des résultats inattendus. Prenez soin d'éviter un appel réentrant lors de la gestion de l'un des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam a la valeur SC_HOTKEY ou SC_TASKLIST, et WM_SYSKEYDOWN (lors de l'utilisation des raccourcis clavier Alt+Tab ou Alt+Echap). Cette opération pose problème dans les applications de modèle de thread unique cloisonné.

Exemples

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

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

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

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