Compartilhar via


Método IInkStrokeDisp::GetPacketValuesByProperty (msinkaut.h)

Recupera os dados de uma propriedade de pacote conhecida de um ou mais pacotes no traço.

Sintaxe

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

Parâmetros

[in] PropertyName

O identificador das constantes PacketProperty que foi usado para selecionar quais dados de pacote são recuperados.

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

[in, optional] Index

Opcional. O ponto de partida do índice baseado em zero para um pacote dentro do traço. O valor padrão ISC_FirstElement, definido no tipo de enumeração InkSelectionConstants , especifica o primeiro pacote.

[in, optional] Count

Opcional. O número de pontos que compõem os dados de traço. O valor padrão ISC_AllElements, definido no tipo de enumeração InkSelectionConstants , especifica todos os pontos que compõem os dados de traço.

[out, retval] PacketValues

Quando este método retorna, contém uma matriz de inteiros de 32 bits com sinal que especifica o valor do PacketProperty solicitado para cada ponto solicitado do traço.

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

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
TPC_E_INVALID_STROKE
O traço é inválido.
E_POINTER
Um parâmetro continha um ponteiro inválido.
E_FAIL
Ocorreu um erro não especificado.
E_OUTOFMEMORY
Não é possível alocar a matriz de dados de pacotes.
E_INVALIDARG
Propriedade de índice, contagem ou pacote inválida.
E_INK_EXCEPTION
Ocorreu uma exceção dentro do método .
CO_E_CLASSSTRING
Formato GUID inválido.

Comentários

Uma propriedade de pacote específica pode não estar disponível em um objeto IInkStrokeDisp específico. Um Tablet pc pode ter mais de um tablet para entrada do usuário. A coleção InkTablets contém uma lista de todos os tablets anexados ao Tablet PC. Use o método IsPacketPropertySupported para determinar se uma propriedade de pacote específica tem suporte por um objeto IInkTablet específico ou por todos os tablets disponíveis. Além disso, use a propriedade DesiredPacketDescription do coletor de tinta para controlar quais propriedades de pacote são coletadas em novos traços.

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

Propriedade DesiredPacketDescription

IInkStrokeDisp Interface

IInkTablet Interface

Coleção InkTablets

Método IsPacketPropertySupported

Enumeração ItemSelectionConstants

Constantes PacketPropertyGuids