Share via


PacketPropertyGuids-Konstanten

Definiert Werte, die die Paketeigenschaften angeben. Die Tablet PCAPI verwendet global eindeutige Bezeichner (GUIDs), um Paketeigenschaften zu identifizieren, die in COM konstante Zeichenfolgen sind.

In C++ können Sie auf diese Konstanten in der Headerdatei Msinkaut.h zugreifen, die <sich im Verzeichnis systemdrive>:\Programme\Microsoft SDKs\Windows\v6.0\Include befindet, wenn Sie das SDK am Standardspeicherort installiert haben. In C++ sind diese Konstanten WCHARs, keine BSTRs. Konvertieren Sie sie vor der Verwendung in BSTRs. Weitere Informationen zum BSTR-Datentyp finden Sie unter Verwenden der COM-Bibliothek.

In der folgenden Tabelle sind die verfügbaren GUID-Felder (Globally Unique Identifier) der Paketeigenschaft aufgeführt. Verwenden Sie diese GUIDs, um anzugeben, welche Eigenschaften das Paket enthält, wenn Sie den Tabletkontext erstellen. Um den Bereich und die Auflösung einer Eigenschaft zu bestimmen, rufen Sie die GetPropertyMetrics-Methode auf. Die Konstanten in der folgenden Tabelle, die mit "STR_" beginnen, sind Zeichenfolgendarstellungen der entsprechenden Binärkonstanten, die in derselben Tabellenzelle angezeigt werden.

Dauerhaft BESCHREIBUNG
STR_GUID_X oder GUID_PACKETPROPERTY_GUID_X
Die x-Koordinate im Tablet-Koordinatenraum. Jedes Paket enthält diese Eigenschaft standardmäßig. Der Ursprung (0,0) des Tablets ist die obere linke Ecke.
STR_GUID_Y oder GUID_PACKETPROPERTY_GUID_Y
Die y-Koordinate im Tablet-Koordinatenraum. Jedes Paket enthält diese Eigenschaft standardmäßig. Der Ursprung (0,0) des Tablets ist die obere linke Ecke.
STR_GUID_Y oder GUID_PACKETPROPERTY_GUID_Y
Die y-Koordinate im Tablet-Koordinatenraum. Jedes Paket enthält diese Eigenschaft standardmäßig. Der Ursprung (0,0) des Tablets ist die obere linke Ecke.
STR_GUID_Z oder GUID_PACKETPROPERTY_GUID_Z
Die Z-Koordinate oder der Abstand der Stiftspitze von der Tablet-Oberfläche. Der TabletPropertyMetricUnit-Enumerationstyp bestimmt die Maßeinheit für diese Eigenschaft.
STR_GUID_PAKETSTATUS oder GUID_PACKETPROPERTY_GUID_PACKET_STATUS
Enthält mindestens einen der folgenden Flagwerte:
  • Der Cursor berührt die Zeichnungsoberfläche (Wert = 1).
  • Der Cursor ist invertiert. Beispielsweise zeigt das Radiererende des Stifts auf die Oberfläche (Wert = 2).
  • Nicht verwendet (Wert = 4).
  • Die Lauftaste wird gedrückt (Wert = 8).
STR_GUID_TIMERTICK oder GUID_PACKETPROPERTY_GUID_TIMER_TICK
Der Zeitpunkt, zu dem das Paket generiert wurde.
STR_GUID_TIMERTICK oder GUID_PACKETPROPERTY_GUID_TIMER_TICK
Der Zeitpunkt, zu dem das Paket generiert wurde.
STR_GUID_SERIALNUMBER oder GUID_PACKETPROPERTY_GUID_SERIAL_NUMBER
Die Paketeigenschaft zum Identifizieren des Pakets.
Dies ist derselbe Wert, den Sie zum Abrufen des Pakets aus der Paketwarteschlange verwenden.
STR_GUID_NORMALPRESSURE oder GUID_PACKETPROPERTY_GUID_NORMAL_PRESSURE
Der Druck der Stiftspitze senkrecht zur Tablet-Oberfläche.
Je größer der Druck auf die Stiftspitze, desto mehr Freihand wird gezeichnet.
STR_GUID_TANGENTPRESSURE oder GUID_PACKETPROPERTY_GUID_TANGENT_PRESSURE
Der Druck der Stiftspitze entlang der Ebene der Tablet-Oberfläche.
STR_GUID_BUTTONPRESSURE oder GUID_PACKETPROPERTY_GUID_BUTTON_PRESSURE
Der Druck auf einen druckempfindlichen Knopf.
STR_GUID_XTILTORIENTATION oder GUID_PACKETPROPERTY_GUID_X_TILT_ORIENTATION
Der Winkel zwischen der y-, z-Ebene und der Stift- und y-Achsenebene.
Gilt für einen Stiftcursor.
Der Wert ist 0, wenn sich der Stift senkrecht zur Zeichenfläche befindet, und ist positiv, wenn sich der Stift rechts von senkrecht befindet.
STR_GUID_YTILTORIENTATION oder GUID_PACKETPROPERTY_GUID_Y_TILT_ORIENTATION
Der Winkel zwischen der x-, z-Ebene und der Stift- und X-Achsenebene.
Gilt für einen Stiftcursor.
Der Wert ist 0, wenn sich der Stift senkrecht zur Zeichnungsoberfläche befindet, und ist positiv, wenn der Stift nach oben oder vom Benutzer entfernt ist.
STR_GUID_AZIMUTHORIENTATION oder GUID_PACKETPROPERTY_GUID_AZIMUTH_ORIENTATION
Die Drehung des Cursors im Uhrzeigersinn um die Z-Achse durch einen vollständigen Kreisbereich.
STR_GUID_ALTITUDEORIENTATION oder GUID_PACKETPROPERTY_GUID_ALTITUDE_ORIENTATION
Der Winkel zwischen der Achse des Stifts und der Oberfläche des Tablets.
Der Wert ist 0, wenn der Stift parallel zur Oberfläche ist, und 90, wenn sich der Stift senkrecht zur Oberfläche befindet.
Die Werte sind negativ, wenn der Stift invertiert wird.
STR_GUID_TWISTORIENTATION oder GUID_PACKETPROPERTY_GUID_TWIST_ORIENTATION
Die Drehung des Cursors im Uhrzeigersinn um seine eigene Achse.
STR_GUID_PITCHROTATION oder GUID_PACKETPROPERTY_GUID_PITCH_ROTATION
Die Paketeigenschaft, die angibt, ob sich die Spitze oberhalb oder unterhalb einer horizontalen Linie befindet, die senkrecht zur Schreiboberfläche steht.
Hinweis: Dazu ist ein 3D-Digitizer erforderlich.
Der Wert ist positiv, wenn sich die Spitze oberhalb der Linie befindet, und negativ, wenn sie sich unterhalb der Zeile befindet. Wenn Sie beispielsweise den Stift vor sich halten und auf eine imaginäre Wand schreiben, ist die Tonhöhe positiv, wenn sich die Spitze über einer Linie befindet, die sich von Ihnen zur Wand erstreckt.
STR_GUID_ROLLROTATION oder GUID_PACKETPROPERTY_GUID_ROLL_ROTATION
Die Drehung des Stifts im Uhrzeigersinn um die eigene Achse.
Hinweis: Dazu ist ein 3D-Digitizer erforderlich.
STR_GUID_YAWROTATION oder GUID_PACKETPROPERTY_GUID_YAW_ROTATION
Der Winkel des Stifts nach links oder rechts um die Mitte seiner horizontalen Achse, wenn der Stift horizontal ist.
Hinweis: Dazu ist ein 3D-Digitizer erforderlich.
Wenn Sie den Stift vor sich halten und auf eine imaginäre Wand schreiben, bedeutet null gähnen, dass der Stift senkrecht zur Wand steht. Der Wert ist negativ, wenn die Spitze links von senkrecht und positiv ist, wenn sich die Spitze rechts von senkrecht befindet.
STR_GUID_YAWROTATION oder GUID_PACKETPROPERTY_GUID_YAW_ROTATION
Der Winkel des Stifts nach links oder rechts um die Mitte seiner horizontalen Achse, wenn der Stift horizontal ist.
Hinweis: Dazu ist ein 3D-Digitizer erforderlich.
Wenn Sie den Stift vor sich halten und auf eine imaginäre Wand schreiben, bedeutet null gähnen, dass der Stift senkrecht zur Wand steht. Der Wert ist negativ, wenn die Spitze links von senkrecht und positiv ist, wenn sich die Spitze rechts von senkrecht befindet.
STR_GUID_WIDTH oder GUID_PACKETPROPERTY_GUID_WIDTH
Die Breite des Kontaktbereichs auf einem Touch-Digitizer.
STR_GUID_HEIGHT oder GUID_PACKETPROPERTY_GUID_HEIGHT
Die Höhe des Kontaktbereichs auf einem Touch-Digitizer.
STR_GUID_FINGERCONTACTCONFIDENCE oder GUID_PACKETPROPERTY_GUID_FINGERCONTACTCONFIDENCE
Das Maß an Vertrauen, dass es fingerkontakt auf einem Touchdigisierer gab.
STR_GUID_DEVICE_CONTACT_ID oder GUID_PACKETPROPERTY_GUID_DEVICE_CONTACT_ID
Der Gerätekontaktbezeichner für ein Paket.

Hinweise

Hinweis

Alle Paketwerte, die von der Tablet-Hardware stammen, sind ganze 32-Bit-Größen.

 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Header
msinkaut.h (erfordert auch Msinkaut_i.c)

Weitere Informationen

IsPacketPropertySupported-Methode

GetPropertyMetrics-Methode

IInkTablet-Schnittstelle