IInkTablets ::Item, méthode (msinkaut.h)

Article
03/06/2024

Récupère l’objet IInkTablet à l’index spécifié dans la collection InkTablets .

Syntaxe

HRESULT Item(
  [in]          long       Index,
  [out, retval] IInkTablet **Tablet
);

Paramètres

[in] Index

Index de base zéro de l’objet IInkTablet à obtenir.

[out, retval] Tablet

Lorsque cette méthode retourne, contient un pointeur vers l’objet IInkTablet à l’index spécifié dans la collection InkTablets .

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_FAIL	Une erreur non spécifiée s'est produite.
CO_E_CLASSTRING	Format GUID non valide.
DISP_E_TYPEMISMATCH	L’un des paramètres n’est pas un type VARIANT valide.
E_INVALIDARG	Argument non valide.
E_UNEXPECTED	Type de paramètre ou de propriété inattendu.
REGDB_CLASSNOTREG	Objet de type non inscrit.
E_OUTOFMEMORY	Impossible d’allouer de la mémoire pour terminer l’opération.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode.
TPC_E_RECOGNIZER_NOT_REGISTERED	La clé de Registre recognizers est endommagée ou votre environnement ne prend pas en charge la reconnaissance de l’écriture manuscrite.

Remarques

Une erreur se produit si l’index ne correspond à aucun membre existant de la collection.

Note Cette fonction peut être réentrée lorsqu’elle est appelée dans certains gestionnaires de messages, 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-Esc). 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 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

Voir aussi

IInkTablet, interface

IInkTablets

InkTablets Collection

Partager via