IInkTablet::GetPropertyMetrics-Methode (msinkaut.h)

Artikel
08/25/2023

Ruft die Metrikdaten für eine angegebene Eigenschaft ab.

Syntax

HRESULT GetPropertyMetrics(
  [in]  BSTR                     propertyName,
  [out] long                     *Minimum,
  [out] long                     *Maximum,
  [out] TabletPropertyMetricUnit *Units,
  [out] float                    *Resolution
);

Parameter

[in] propertyName

Die Eigenschaft, für die Sie Metriken bestimmen möchten.

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

[out] Minimum

Der Mindestwert in logischen Einheiten, den das Tablet für diese Eigenschaft meldet. Ein Tablet, das x-Werte von 0 bis 9000 meldet, weist beispielsweise ein logisches Minimum von 0 auf.

[out] Maximum

Der maximale Wert in logischen Einheiten, den das Tablet für diese Eigenschaft meldet. Beispielsweise würde ein Tablet, das x-Werte von 0 bis 9000 meldet, ein logisches Maximum von 9000 aufweisen.

[out] Units

Die physischen Einheiten der Eigenschaft, z. B. Zoll oder Grad. Eine Liste der Eigenschafteneinheiten finden Sie unter dem TabletPropertyMetricUnit-Enumerationstyp .

[out] Resolution

Gibt den Auflösungs- oder Inkrementwert für den Einheitenmember an. Beispielsweise weist ein Tablet, das 400 Punkte pro Zoll (dpi) meldet, den Auflösungswert 400 auf.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
TPC_E_UNKNOWN_PROPERTY	Das Tablet unterstützt die angegebene Eigenschaft nicht.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
CO_E_CLASSSTRING	Ungültiges GUID-Format.
E_INVALIDARG	Unbekannte Eigenschaftszeichenfolge.
E_INK_EXCEPTION	Während der Verarbeitung ist eine Ausnahme aufgetreten.

Hinweise

Die Eigenschaften, für die Sie Metriken abrufen, können den Zeitpunkt umfassen, zu dem ein Paket generiert wurde, oder den Abwärtsdruck der Stiftspitze auf der Tablet-Oberfläche.

Eine vollständige Liste der Eigenschaften, für die Sie Metriken abrufen können, finden Sie unter PacketProperty-Konstanten .

Hinweis Der Zugriff auf diese Eigenschaft in bestimmten Nachrichtenhandlern kann dazu führen, dass die zugrunde liegende Funktion erneut eingegeben 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, WMNCACTIVATE, 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.

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