IInkPicture ::SetWindowInputRectangle, méthode (msinkaut.h)

Modifie le rectangle de fenêtre, en pixels, dans lequel l’entrée manuscrite est dessinée.

Syntaxe

HRESULT SetWindowInputRectangle(
  [in] IInkRectangle *WindowInputRectangle
);

Paramètres

[in] WindowInputRectangle

Rectangle, en coordonnées de fenêtre, sur lequel l’encre est dessinée.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_POINTER
Un paramètre contenait un pointeur non valide.
E_INVALIDARG
Les coordonnées du rectangle ne sont pas valides (par exemple, largeur/hauteur de 0).
E_INK_COLLECTOR_BUSY
Impossible de mettre à jour les mappages au milieu d’un trait.
E_INK_EXCEPTION
Une exception s’est produite à l’intérieur de la méthode .
E_INK_OVERLAPPING_INPUT_RECT
Le rectangle d’entrée de fenêtre chevauche le rectangle d’entrée de fenêtre d’un InkCollector activé.

Remarques

L’erreur E_INK_OVERLAPPING_INPUT_RECT est retournée si le rectangle d’entrée de fenêtre d’un collecteur d’encre activé (défini avec la propriété Enabled ) chevauche le rectangle d’entrée de fenêtre d’un autre collecteur d’encre activé.

Note Le chevauchement peut se produire sans erreur tant qu’un seul des rectangles d’entrée est activé à un moment connu.
 
Par défaut, le rectangle d’entrée de fenêtre est défini sur {0,0,0,0}. Ce rectangle par défaut correspond à la taille de la fenêtre entière.

Pour rétablir le comportement par défaut du rectangle d’entrée de fenêtre (rectangle vide avec des {0,0,0,0}coordonnées ), passez {0,0,0,0} l’appel à SetWindowInputRectangle, et non à NULL.

Vous ne pouvez pas passer un rectangle où la valeur de la propriété Right est inférieure à la valeur de la propriété Left ; ou où la valeur de la propriété Bottom est inférieure à la valeur de la propriété Top . Par exemple, un rectangle avec des paramètres de {500, 500, 400, 400} n’est pas valide.

Attention Si vous définissez le rectangle d’entrée de fenêtre pour qu’il chevauche un contrôle de séparateur ou les bordures de la fenêtre, des résultats imprévisibles peuvent se produire lorsque la fenêtre est redimensionnée.
 
Note L’appel de cette méthode dans certains gestionnaires de messages peut entraîner une nouvelle entrée de la fonction sous-jacente, ce qui entraîne des résultats inattendus. Veillez à éviter un appel de réentrant lors de la gestion des messages suivants : WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT ; WM_SYSCOMMAND si wParam est défini sur SC_HOTKEY ou SC_TASKLIST ; et WM_SYSKEYDOWN (lors du traitement Alt-Tab ou Alt-Esc combinaisons de touches). Il s’agit d’un problème avec les applications de modèle d’appartement à thread unique.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête msinkaut.h
Bibliothèque InkObj.dll

Voir aussi

Propriété activée

GetWindowInputRectangle, méthode

IInkPicture

Inkpicture