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

Artigo
02/29/2024

Recupera os dados do pacote para um intervalo de pacotes dentro do objeto IInkStrokeDisp .

Sintaxe

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

Parâmetros

[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 conjuntos de dados de pacotes de ponto que devem ser retornados, começando com o pacote especificado no parâmetro startingIndex . 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] PacketData

Quando este método retorna, contém uma matriz de inteiros de 32 bits com sinal que contém os dados do pacote para os pontos solicitados no traço. A matriz contém os dados do primeiro ponto, depois os dados do segundo ponto e assim por diante.

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.
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 o objeto auxiliar do manipulador stroke.
E_INVALIDARG	O traço é inválido.
E_INK_EXCEPTION	Ocorreu uma exceção dentro do método .
E_UNEXPECTED	Parâmetro ou tipo de propriedade inesperado.

Comentários

Se o número de pacotes no traço for menor que a soma dos parâmetros startingIndex e pointCount , a matriz de dados retornada conterá informações de pacote para menos pontos do que a contagem solicitada.

Para recuperar a descrição dos dados do pacote, use a propriedade PacketDescription do traço. Essa propriedade retorna uma matriz de GUID (identificador global exclusivo) que indica quais valores de propriedade são retornados pelo método GetPacketData para cada ponto. As constantes PacketProperty contêm os GUIDs de propriedade de pacote disponíveis.

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