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

Artigo
08/25/2023

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