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

Artículo
02/29/2024

Recupera los datos del paquete para un intervalo de paquetes dentro del objeto IInkStrokeDisp .

Sintaxis

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

Parámetros

[in, optional] Index

Opcional. Punto inicial del índice de base cero en un paquete dentro del trazo. El valor predeterminado ISC_FirstElement, definido en el tipo de enumeración InkSelectionConstants , especifica el primer paquete.

[in, optional] Count

Opcional. Número de conjuntos de datos de paquetes de punto que se deben devolver, empezando por el paquete especificado en el parámetro startingIndex . El valor predeterminado ISC_AllElements, definido en el tipo de enumeración InkSelectionConstants , especifica todos los puntos que componen los datos del trazo.

[out, retval] PacketData

Cuando este método vuelve, contiene una matriz de enteros de 32 bits con signo que contiene los datos de paquete de los puntos solicitados en el trazo. La matriz contiene los datos del primer punto, luego los datos del segundo punto, etc.

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

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_FAIL	Se ha producido un error no especificado.
E_OUTOFMEMORY	No se puede asignar el objeto auxiliar del controlador stroke.
E_INVALIDARG	El trazo no es válido.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .
E_UNEXPECTED	Tipo de propiedad o parámetro inesperado.

Comentarios

Si el número de paquetes del trazo es menor que la suma de los parámetros startingIndex y pointCount , la matriz de datos devuelta contiene información de paquetes para menos puntos que el recuento solicitado.

Para recuperar la descripción de los datos del paquete, use la propiedad PacketDescription del trazo. Esta propiedad devuelve una matriz de identificador único global (GUID) que indica qué valores de propiedad devuelve el método GetPacketData para cada punto. Las constantes PacketProperty contienen los GUID de propiedad de paquete disponibles.

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