Compartir a través de

Método IInkExtendedProperties::Add (msinkaut.h)

  • Artículo

Crea y agrega un objeto IInkExtendedProperty a la colección IInkExtendedProperties .

Sintaxis

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

Parámetros

[in] Guid

Nombre del nuevo objeto IInkExtendedProperty . El nombre se expresa como un BSTR que representa el identificador único global (GUID) en el formato siguiente:

{dfc71f44-354b-4ca1-93d7-7459410b6343} (Incluyendo llaves)

Para obtener más información sobre el tipo de datos BSTR, vea Uso de la biblioteca COM.

[in] Data

Datos del nuevo objeto IInkExtendedProperty .

Para obtener más información sobre la estructura VARIANT, vea Uso de la biblioteca COM.

[out, retval] InkExtendedProperty

Cuando este método vuelve, contiene un puntero a la nueva propiedad extendida.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_POINTER
 Un parámetro contenía un puntero no válido.
E_INVALIDARG
 El usuario no especificó datos.
CO_E_CLASSSTRING
 Formato GUID no válido.
E_INK_EXCEPTION
 Se produjo una excepción dentro del método .
TPC_E_INVALID_STROKE
 El trazo no es válido.

Comentarios

Nota No se puede almacenar un objeto IInkExtendedProperty vacío. El objeto debe contener datos para poder almacenarlos. Por ejemplo, si intenta agregar propiedades extendidas a un trazo para su uso posterior, se produce una excepción si la propiedad extendida no contiene datos.
 
Los siguientes tipos son aceptables:
  • Matriz byte o CHAR
  • Matrices de enteros, floats, enteros grandes, dobles, fechas o decimales
  • Booleans (pero no matrices de booleanos)
  • BSTR (pero no matrices de BSTR)
  • Matrices de variantes. Todas las matrices de variantes pasadas como IInkExtendedProperty deben ser del mismo tipo y ser todas numéricas. Por ejemplo, no se admiten matrices variantes de BSTRS, matrices de matrices, VT_NULL y VT_EMPTY.
Nota Si llama a este método con el parámetro Guid establecido en un GUID que ya existe en la colección IInkExtendedProperties , los nuevos datos reemplazarán la propiedad extendida existente para ese GUID en lugar de agregar un segundo elemento.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado msinkaut.h
Library InkObj.dll

Consulte también

IInkExtendedProperties (Interfaz)

InkStrokes (colección)