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

  • Artigo

Recupera os dados de métricas de uma propriedade especificada.

Sintaxe

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

Parâmetros

[in] propertyName

A propriedade para a qual você deseja determinar as métricas.

Para obter mais informações sobre o tipo de dados BSTR, consulte Usando a biblioteca COM.

[out] Minimum

O valor mínimo, em unidades lógicas, que o tablet relata para essa propriedade. Por exemplo, um tablet que relata valores x de 0 a 9000 tem um mínimo lógico de 0.

[out] Maximum

O valor máximo, em unidades lógicas, que o tablet relata para essa propriedade. Por exemplo, um tablet que relata valores x de 0 a 9000 teria um máximo lógico de 9000.

[out] Units

As unidades físicas da propriedade, como polegadas ou graus. Para obter uma lista de unidades de propriedade, consulte o tipo de enumeração TabletPropertyMetricUnit .

[out] Resolution

Especifica o valor de resolução ou incremento para o membro de unidades . Por exemplo, um tablet que relata 400 pontos por polegada (dpi) tem um valor de resolução de 400.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
TPC_E_UNKNOWN_PROPERTY
 O tablet não dá suporte à propriedade especificada.
E_FAIL
 Ocorreu um erro não especificado.
E_POINTER
 Um parâmetro continha um ponteiro inválido.
CO_E_CLASSSTRING
 Formato GUID inválido.
E_INVALIDARG
 Cadeia de caracteres de propriedade desconhecida.
E_INK_EXCEPTION
 Ocorreu uma exceção durante o processamento.

Comentários

As propriedades para as quais você recupera métricas podem incluir o tempo em que um pacote foi gerado ou a pressão descendente da ponta da caneta na superfície do tablet.

Para obter uma lista completa das propriedades para as quais você pode recuperar métricas, consulte as constantes PacketProperty .

Nota Acessar essa propriedade em determinados manipuladores de mensagens pode fazer com que a função subjacente seja reinserida, causando resultados inesperados. Tome cuidado para evitar uma chamada reentrante ao lidar com qualquer uma das seguintes mensagens: WM_ACTIVATE, WM_ACTIVATEAPP, WMNCACTIVATE WM_PAINT; WM_SYSCOMMAND se wParam estiver definido como SC_HOTKEY ou SC_TASKLIST; e WM_SYSKEYDOWN (ao processar combinações de teclas Alt-Tab ou Alt-Esc). Esse é um problema com aplicativos de modelo de apartment de thread único.
 

Requisitos

   
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

Confira também

Método GetPacketDescriptionPropertyMetrics

Método GetPacketValuesByProperty

IInkTablet Interface

Método SetPacketValuesByProperty

Enumeração TabletPropertyMetricUnit