Compartilhar via

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

  • Artigo

Cria e adiciona um objeto IInkExtendedProperty à coleção IInkExtendedProperties .

Sintaxe

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

Parâmetros

[in] Guid

O nome do novo objeto IInkExtendedProperty . O nome é expresso como um BSTR que representa o GUID (identificador global exclusivo) no seguinte formato:

{dfc71f44-354b-4ca1-93d7-7459410b6343} (Incluindo chaves)

Para obter mais informações sobre o tipo de dados BSTR, consulte Usando a biblioteca COM.

[in] Data

Os dados do novo objeto IInkExtendedProperty .

Para obter mais informações sobre a estrutura VARIANT, consulte Usando a biblioteca COM.

[out, retval] InkExtendedProperty

Quando esse método retorna, contém um ponteiro para a nova propriedade estendida.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_POINTER
 Um parâmetro continha um ponteiro inválido.
E_INVALIDARG
 O usuário não especificou os dados.
CO_E_CLASSSTRING
 Formato GUID inválido.
E_INK_EXCEPTION
 Ocorreu uma exceção dentro do método .
TPC_E_INVALID_STROKE
 O traço é inválido.

Comentários

Nota Não é possível armazenar um objeto IInkExtendedProperty vazio. O objeto deve conter dados antes de poder ser armazenado. Por exemplo, se você tentar adicionar propriedades estendidas a um traço para uso posterior, uma exceção será gerada se a propriedade estendida não contiver dados.
 
Os seguintes tipos são aceitáveis:
  • Matriz de bytes ou CHAR
  • Matrizes de inteiros, floats, inteiros grandes, duplos, datas ou decimais
  • Boolianos (mas não matrizes de boolianos)
  • BSTRs (mas não matrizes de BSTRs)
  • Matrizes de Variantes. Todas as matrizes de variantes passadas como IInkExtendedProperty devem ser do mesmo tipo e ser todas numéricas. Por exemplo, não há suporte para matrizes variantes de BSTRS, matrizes de matrizes, VT_NULL e VT_EMPTY.
Nota Se você chamar esse método com o parâmetro Guid definido como um GUID que já existe na coleção IInkExtendedProperties , os novos dados substituirão a propriedade estendida existente para esse GUID em vez de adicionar um segundo elemento.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho msinkaut.h
Biblioteca InkObj.dll

Confira também

IInkExtendedProperties Interface

Coleção InkStrokes