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

Artículo
08/25/2023

Recupera los datos de una propiedad de paquete conocida de uno o varios paquetes del trazo.

Sintaxis

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

Parámetros

[in] PropertyName

Identificador de las constantes PacketProperty que se usaron para seleccionar qué datos de paquete se recuperan.

Para obtener más información sobre el tipo de datos BSTR, vea Uso de la biblioteca COM.

[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 puntos que componen los datos del trazo. 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] PacketValues

Cuando este método devuelve, contiene una matriz de enteros de 32 bits con signo que especifica el valor de packetProperty solicitado para cada punto solicitado a partir del trazo.

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.
TPC_E_INVALID_STROKE	El trazo no es válido.
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 la matriz de datos de paquetes.
E_INVALIDARG	Índice, recuento o propiedad de paquete no válidos.
E_INK_EXCEPTION	Se produjo una excepción dentro del método .
CO_E_CLASSSTRING	Formato GUID no válido.

Comentarios

Es posible que una propiedad de paquete específica no esté disponible en un objeto IInkStrokeDisp determinado. Un pc tablet puede tener más de una tableta para la entrada del usuario. La colección InkTablets contiene una lista de todas las tabletas conectadas al pc tablet. Utilice el método IsPacketPropertySupported para determinar si una propiedad de paquete determinada es compatible con un objeto IInkTablet específico o todas las tabletas disponibles. Además, use la propiedad DesiredPacketDescription del recopilador de tintas para controlar qué propiedades de paquete se recopilan en nuevos trazos.

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