Compartilhar via

Método IInkTablets::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

Quando este método retorna, contém VARIANT_TRUE se uma propriedade conhecida tiver suporte do 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 reentrante 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 teclas Alt-Tab ou Alt-Esc). Esse é um problema com aplicativos de modelo de apartment de thread único.
 

Valor retornado

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 qualquer um deles não der suporte à propriedade , ele retornará VARIANT_FALSE. Chame IsPacketPropertySupported em um objeto IInkTablet individual para determinar se o dispositivo dá suporte a uma propriedade conhecida.
 

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 GetPacketData

Classe IInkTablet

IInkTablets

Coleção InkTablets

Método SetPacketValuesByProperty