Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Modifie le rectangle de la 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 renvoyée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
Un paramètre contenait un pointeur non valide. |
|
Les coordonnées du rectangle ne sont pas valides (par exemple, largeur/hauteur de 0). |
|
Impossible de mettre à jour les mappages au milieu d’un trait. |
|
Une exception s’est produite à l’intérieur de la méthode. |
|
Le rectangle d’entrée de fenêtre se chevauche avec 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é à tout moment connu.
Pour réinitialiser le rectangle d’entrée de la fenêtre à son comportement par défaut (un rectangle vide avec des {0,0,0,0}{0,0,0,0} coordonnées), passez l’appel à SetWindowInputRectangle, et non NULL.
Vous ne pouvez pas passer dans 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 chevaucher un contrôle de fractionnement 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 la nouvelle entrée de la fonction sous-jacente, ce qui entraîne des résultats inattendus. Veillez à éviter un appel reentrant lors de la gestion 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-Esc). Il s’agit d’un problème avec les applications de modèle d’appartement à thread unique.
Exigences
| Prérequis | Valeur |
|---|---|
| Client minimum requis | Windows XP Tablet PC Edition [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| plateforme cible | Windows |
| En-tête | msinkaut.h |