IInkTablets::IsPacketPropertySupported-Methode (msinkaut.h)

Artikel
08/25/2023

Bestimmt, ob eine Eigenschaft eines Tablet-Geräts oder eine Sammlung von Tablet-Geräten unterstützt wird, die mit einer GUID (Globally Unique Identifier) gekennzeichnet sind. Verwenden Sie beispielsweise diese Methode, um zu ermitteln, ob alle Tabletten in einer Sammlung den Tangentialdruck von einem Stift unterstützen.

Syntax

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

Parameter

[in] packetPropertyName

Die GUID für die PacketProperty-GUIDs des angeforderten Tablets. Verwenden Sie eine definierte BSTR-Konstante aus den PacketProperty-Konstanten .

Weitere Informationen zum BSTR-Datentyp finden Sie unter Verwenden der COM-Bibliothek.

[out, retval] Supported

Wenn diese Methode zurückgibt, enthält VARIANT_TRUE , wenn eine bekannte Eigenschaft vom Tablet oder den Tablets unterstützt wird; andernfalls VARIANT_FALSE.

Hinweis Diese Methode kann erneut eingegeben werden, wenn sie innerhalb bestimmter Nachrichtenhandler aufgerufen wird, was zu unerwarteten Ergebnissen führt. Achten Sie darauf, einen erneuten Aufruf zu vermeiden, wenn Sie eine der folgenden Nachrichten behandeln: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND, wenn wParam auf SC_HOTKEY oder SC_TASKLIST festgelegt ist; und WM_SYSKEYDOWN (bei der Verarbeitung Alt-Tab oder Alt-Esc Tastenkombinationen). Dies ist ein Problem mit Singlethread-Apartmentmodellanwendungen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
CO_E_CLASSSTRING	Ungültiges GUID-Format.
E_INK_EXCEPTION	Während der Verarbeitung ist eine Ausnahme aufgetreten.
E_INVALIDARG	Das Flag ist ungültig.

Hinweise

Hinweis Wenn diese Methode für die InkTablets-Auflistung aufgerufen wird, fragt sie alle Tablets im System ab. Wenn einer von ihnen die -Eigenschaft nicht unterstützt, wird VARIANT_FALSE zurückgegeben. Rufen Sie IsPacketPropertySupported für ein einzelnes IInkTablet-Objekt auf, um zu bestimmen, ob das Gerät eine bekannte Eigenschaft unterstützt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

GetPacketData-Methode

IInkTablet-Klasse

IInkTablets

InkTablets-Auflistung

SetPacketValuesByProperty-Methode

Freigeben über