Metodo IInkExtendedProperties::Add (msinkaut.h)

Articolo
03/05/2024

Crea e aggiunge un oggetto IInkExtendedProperty all'insieme IInkExtendedProperties .

Sintassi

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

Parametri

[in] Guid

Nome del nuovo oggetto IInkExtendedProperty . Il nome viene espresso come BSTR che rappresenta l'identificatore univoco globale (GUID) nel formato seguente:

{dfc71f44-354b-4ca1-93d7-7459410b6343} (incluse parentesi graffe)

Per altre informazioni sul tipo di dati BSTR, vedere Uso della libreria COM.

[in] Data

Dati per il nuovo oggetto IInkExtendedProperty .

Per altre informazioni sulla struttura VARIANT, vedere Uso della libreria COM.

[out, retval] InkExtendedProperty

Quando termina, questo metodo contiene un puntatore alla nuova proprietà estesa.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Un parametro contiene un puntatore non valido.
E_INVALIDARG	L'utente non ha specificato i dati.
CO_E_CLASSSTRING	Formato GUID non valido.
E_INK_EXCEPTION	Si è verificata un'eccezione all'interno del metodo .
TPC_E_INVALID_STROKE	Il tratto non è valido.

Commenti

Nota Non è possibile archiviare un oggetto IInkExtendedProperty vuoto. L'oggetto deve contenere dati prima di poterli archiviare. Ad esempio, se si tenta di aggiungere proprietà estese a un tratto per un uso successivo, viene generata un'eccezione se la proprietà estesa non contiene dati.

I tipi seguenti sono accettabili:

Matrice di byte o CHAR
Matrici di numeri interi, float, interi di grandi dimensioni, double, date o decimali
Valori booleani (ma non ma matrici di valori booleani)
Richieste BSTR (ma non ma matrici di route BSTR)
Matrici di varianti. Tutte le matrici di varianti passate come IInkExtendedProperty devono essere dello stesso tipo e essere tutte numeriche. Ad esempio, le matrici varianti di BSTRS, matrici di matrici, VT_NULL e VT_EMPTY non sono supportate.

Nota Se si chiama questo metodo con il parametro Guid impostato su un GUID già esistente nell'insieme IInkExtendedProperties , i nuovi dati sostituiranno la proprietà estesa esistente per tale GUID anziché aggiungere un secondo elemento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll

Vedi anche

Interfaccia IInkExtendedProperties

Insieme InkStrokes

Condividi tramite