Metodo IInkTablet::IsPacketPropertySupported (msinkaut.h)

Articolo
03/13/2024

Determina se è supportata una proprietà di un dispositivo tablet o una raccolta di dispositivi tablet, identificata con un identificatore univoco globale (GUID). Ad esempio, usare questo metodo per determinare se tutti i tablet in una raccolta supportano una pressione tangente da una penna.

Sintassi

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

Parametri

[in] packetPropertyName

GUID per il GUID PacketProperty del tablet o tablet richiesto. Usare una costante BSTR definita dalle costanti PacketProperty .

Per altre informazioni sul tipo di dati BSTR, vedere Uso della libreria COM.

[out, retval] Supported

VARIANT_TRUE se una proprietà nota è supportata da tablet o tablet; in caso contrario, VARIANT_FALSE.

Nota Questo metodo può essere nuovamente immesso quando viene chiamato all'interno di determinati gestori messaggi, causando risultati imprevisti. Prestare attenzione a evitare una chiamata reentrant durante la gestione di uno dei messaggi seguenti: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND se wParam è impostato su SC_HOTKEY o SC_TASKLIST; e WM_SYSKEYDOWN (durante l'elaborazione di combinazioni di tasti Alt-Tab o Alt-Esc). Si tratta di un problema con applicazioni di modello a thread singolo.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Un parametro contiene un puntatore non valido.
CO_E_CLASSSTRING	Formato GUID non valido.
E_INK_EXCEPTION	Si è verificata un'eccezione durante l'elaborazione.
E_INVALIDARG	Il flag non è valido.

Commenti

Nota Quando questo metodo viene chiamato nell'insieme InkTablets , esegue una query su tutti i tablet nel sistema. Se uno di essi non supporta la proprietà, restituisce FALSE. Chiamare IsPacketPropertySupported in un singolo oggetto IInkTablet per determinare se il dispositivo supporta una proprietà nota.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	msinkaut.h
Libreria	InkObj.dll

Vedi anche

Metodo GetPacketData

Interfaccia IInkTablet

Metodo SetPacketValuesByProperty

Condividi tramite