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

Définit le rectangle de fenêtre, en pixels, dans lequel l’encre 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 du traitement de l’un 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 des combinaisons de touches Alt+Tab ou Alt+Échap). 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

IInkOverlay

InkOverlay, classe