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

Artigo
02/29/2024

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