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.
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 |
|---|---|
|
Réussite. |
|
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 chevauche le rectangle d’entrée de fenêtre d’un InkCollector activé. |
Notes
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.
Pour réinitialiser le rectangle d’entrée de fenêtre à son comportement par défaut (un 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 lorsque 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 saisie de la fonction sous-jacente, ce qui entraîne des résultats inattendus. Veillez à éviter un appel de réentrée 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+Échap). Il s’agit d’un problème avec les applications de modèle d’appartement à thread unique.
Spécifications
| Client minimal pris en charge | Windows XP Édition Tablet 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 |