IInkExtendedProperties ::Add, méthode (msinkaut.h)

Article
02/29/2024

Crée et ajoute un objet IInkExtendedProperty à la collection IInkExtendedProperties .

Syntaxe

HRESULT Add(
  [in]          BSTR                 Guid,
  [in]          VARIANT              Data,
  [out, retval] IInkExtendedProperty **InkExtendedProperty
);

Paramètres

[in] Guid

Nom du nouvel objet IInkExtendedProperty . Le nom est exprimé sous la forme d’un BSTR qui représente l’identificateur global unique (GUID) au format suivant :

{dfc71f44-354b-4ca1-93d7-7459410b6343} (Y compris les accolades)

Pour plus d’informations sur le type de données BSTR, consultez Utilisation de la bibliothèque COM.

[in] Data

Données du nouvel objet IInkExtendedProperty .

Pour plus d’informations sur la structure VARIANT, consultez Utilisation de la bibliothèque COM.

[out, retval] InkExtendedProperty

Lorsque cette méthode est retournée, contient un pointeur vers la nouvelle propriété étendue.

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	L’utilisateur n’a pas spécifié de données.
CO_E_CLASSSTRING	Format GUID non valide.
E_INK_EXCEPTION	Une exception s’est produite à l’intérieur de la méthode .
TPC_E_INVALID_STROKE	Le trait n’est pas valide.

Remarques

Note Vous ne pouvez pas stocker un objet IInkExtendedProperty vide. L’objet doit contenir des données avant de pouvoir être stocké. Par exemple, si vous essayez d’ajouter des propriétés étendues à un trait pour une utilisation ultérieure, une exception est levée si la propriété étendue ne contient aucune donnée.

Les types suivants sont acceptables :

Tableau d’octets ou CHAR
Tableaux d’entiers, de floats, d’entiers grands, de doubles, de dates ou de décimales
Booleans (mais pas les tableaux de booléens)
BSTR (mais pas tableaux de BSTR)
Tableaux de variantes. Tous les tableaux de variantes passés en tant que IInkExtendedProperty doivent être du même type et être tous numériques. Par exemple, les tableaux de variantes de BSTRS, les tableaux de tableaux, les VT_NULL et les VT_EMPTY ne sont pas pris en charge.

Note Si vous appelez cette méthode avec le paramètre GUID défini sur un GUID qui existe déjà dans la collection IInkExtendedProperties , les nouvelles données remplacent la propriété étendue existante pour ce GUID au lieu d’ajouter un deuxième élément.

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

IInkExtendedProperties, interface

InkStrokes Collection

Partager via