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

  • Artigo

Determina se há suporte para uma propriedade de um dispositivo tablet ou uma coleção de dispositivos tablet, identificados com um GUID (identificador global exclusivo). Por exemplo, use esse método para determinar se todos os tablets em uma coleção dão suporte à pressão tangencial de uma caneta.

Sintaxe

HRESULT IsPacketPropertySupported(
  [in]          BSTR         packetPropertyName,
  [out, retval] VARIANT_BOOL *Supported
);

Parâmetros

[in] packetPropertyName

O GUID para os GUIDs PacketProperty do tablet ou tablets solicitados. Use uma constante BSTR definida das constantes PacketProperty .

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

[out, retval] Supported

VARIANT_TRUE se houver suporte para uma propriedade conhecida pelo tablet ou tablets; caso contrário, VARIANT_FALSE.

Nota Esse método pode ser inserido novamente quando chamado em determinados manipuladores de mensagens, causando resultados inesperados. Tome cuidado para evitar uma chamada reentrada ao lidar com qualquer uma das seguintes mensagens: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND se wParam estiver definido como SC_HOTKEY ou SC_TASKLIST; e WM_SYSKEYDOWN (ao processar combinações de chave de Alt-Tab ou Alt-Esc). Esse é um problema com aplicativos de modelo de apartment de thread único.
 

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.
CO_E_CLASSSTRING
 Formato GUID inválido.
E_INK_EXCEPTION
 Ocorreu uma exceção durante o processamento.
E_INVALIDARG
 O sinalizador é inválido.

Comentários

Nota Quando esse método é chamado na coleção InkTablets , ele consulta todos os tablets no sistema. Se algum deles não der suporte à propriedade, ele retornará FALSE. Chame IsPacketPropertySupported em um objeto IInkTablet individual para determinar se o dispositivo dá suporte a uma propriedade conhecida.
 

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

Confira também

Método GetPacketData

IInkTablet Interface

Método SetPacketValuesByProperty