Compartir a través de

Método IInkTablet::GetPropertyMetrics (msinkaut.h)

  • Artículo

Recupera los datos de métricas de una propiedad especificada.

Sintaxis

HRESULT GetPropertyMetrics(
  [in]  BSTR                     propertyName,
  [out] long                     *Minimum,
  [out] long                     *Maximum,
  [out] TabletPropertyMetricUnit *Units,
  [out] float                    *Resolution
);

Parámetros

[in] propertyName

Propiedad para la que desea determinar las métricas.

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

[out] Minimum

Valor mínimo, en unidades lógicas, que la tableta notifica para esta propiedad. Por ejemplo, una tableta que informa de valores x de 0 a 9000 tiene un mínimo lógico de 0.

[out] Maximum

Valor máximo, en unidades lógicas, que la tableta notifica para esta propiedad. Por ejemplo, una tableta que informa de valores X de 0 a 9000 tendría un máximo lógico de 9000.

[out] Units

Unidades físicas de la propiedad, como pulgadas o grados. Para obtener una lista de unidades de propiedad, vea el tipo de enumeración TabletPropertyMetricUnit .

[out] Resolution

Especifica el valor de resolución o incremento para el miembro de unidades . Por ejemplo, una tableta que informa de 400 puntos por pulgada (ppp) tiene un valor de resolución de 400.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
TPC_E_UNKNOWN_PROPERTY
 La tableta no admite la propiedad especificada.
E_FAIL
 Se ha producido un error no especificado.
E_POINTER
 Un parámetro contenía un puntero no válido.
CO_E_CLASSSTRING
 Formato GUID no válido.
E_INVALIDARG
 Cadena de propiedad desconocida.
E_INK_EXCEPTION
 Se produjo una excepción durante el procesamiento.

Comentarios

Las propiedades para las que se recuperan las métricas pueden incluir el tiempo que se generó un paquete o la presión descendente de la punta del lápiz en la superficie de la tableta.

Para obtener una lista completa de las propiedades para las que puede recuperar métricas, consulte las constantes PacketProperty .

Nota El acceso a esta propiedad dentro de determinados controladores de mensajes puede dar lugar a que se vuelva a escribir la función subyacente, lo que provoca resultados inesperados. Tenga cuidado de evitar una llamada reentrant al controlar cualquiera de los siguientes mensajes: WM_ACTIVATE, WM_ACTIVATEAPP, WMNCACTIVATE, WM_PAINT; WM_SYSCOMMAND si wParam está establecido en SC_HOTKEY o SC_TASKLIST; y WM_SYSKEYDOWN (al procesar combinaciones de teclas Alt-Tab o Alt-Esc). Se trata de un problema con las aplicaciones de modelo de apartamento de un solo subproceso.
 

Requisitos

   
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

Consulte también

GetPacketDescriptionPropertyMetrics (método)

GetPacketValuesByProperty (método)

IInkTablet (interfaz)

SetPacketValuesByProperty (método)

TabletPropertyMetricUnit (enumeración)