Costanti PacketPropertyGuids

  • Articolo

Definisce i valori che specificano le proprietà del pacchetto. Tablet PCAPI usa identificatori univoci globali (GUID) per identificare le proprietà dei pacchetti, che in COM sono stringhe costanti.

In C++, è possibile accedere a queste costanti nel file di intestazione Msinkaut.h, che si trova nella <directory systemdrive>:\Programmi\Microsoft SDKs\Windows\v6.0\Include se è stato installato l'SDK nel percorso predefinito. In C++, queste costanti sono WCHAR, non BSTR. Convertirli in route BSTR prima dell'uso. Per altre informazioni sul tipo di dati BSTR, vedere Uso della libreria COM.

Nella tabella seguente sono elencati i campi identificatore univoco globale (GUID) della proprietà del pacchetto disponibile. Usare questi GUID per specificare le proprietà contenute nel pacchetto quando si crea il contesto del tablet. Per determinare l'intervallo e la risoluzione di una proprietà, chiamare il metodo GetPropertyMetrics . Le costanti nella tabella seguente che iniziano con "STR_" sono rappresentazioni di stringa delle costanti binarie corrispondenti visualizzate nella stessa cella della tabella.

Costante Descrizione
STR_GUID_X o GUID_PACKETPROPERTY_GUID_X
 Coordinata x nello spazio delle coordinate del tablet. Ogni pacchetto contiene questa proprietà per impostazione predefinita. L'origine (0,0) del tablet è l'angolo superiore sinistro.
STR_GUID_Y o GUID_PACKETPROPERTY_GUID_Y
 Coordinata y nello spazio delle coordinate del tablet. Ogni pacchetto contiene questa proprietà per impostazione predefinita. L'origine (0,0) del tablet è l'angolo superiore sinistro.
STR_GUID_Y o GUID_PACKETPROPERTY_GUID_Y
 Coordinata y nello spazio delle coordinate del tablet. Ogni pacchetto contiene questa proprietà per impostazione predefinita. L'origine (0,0) del tablet è l'angolo superiore sinistro.
STR_GUID_Z o GUID_PACKETPROPERTY_GUID_Z
 Coordinata z o distanza della punta della penna dalla superficie del tablet. Il tipo di enumerazione TabletPropertyMetricUnit determina l'unità di misura per questa proprietà.
STR_GUID_PAKETSTATUS o GUID_PACKETPROPERTY_GUID_PACKET_STATUS
 Contiene uno o più dei valori di flag seguenti:
  • Il cursore tocca la superficie di disegno (Valore = 1).
  • Il cursore viene invertito. Ad esempio, l'estremità della gomma della penna punta verso la superficie (Valore = 2).
  • Non usato (valore = 4).
  • Il pulsante della canna viene premuto (Valore = 8).
STR_GUID_TIMERTICK o GUID_PACKETPROPERTY_GUID_TIMER_TICK
 Ora in cui è stato generato il pacchetto.
STR_GUID_TIMERTICK o GUID_PACKETPROPERTY_GUID_TIMER_TICK
 Ora in cui è stato generato il pacchetto.
STR_GUID_SERIALNUMBER o GUID_PACKETPROPERTY_GUID_SERIAL_NUMBER
 Proprietà del pacchetto per l'identificazione del pacchetto.
Si tratta dello stesso valore usato per recuperare il pacchetto dalla coda di pacchetti.
STR_GUID_NORMALPRESSURE o GUID_PACKETPROPERTY_GUID_NORMAL_PRESSURE
 Pressione della punta della penna perpendicolare alla superficie del tablet.
Maggiore è la pressione sulla punta della penna, maggiore è l'inchiostro disegnato.
STR_GUID_TANGENTPRESSURE o GUID_PACKETPROPERTY_GUID_TANGENT_PRESSURE
 Pressione della punta della penna lungo il piano della superficie del tablet.
STR_GUID_BUTTONPRESSURE o GUID_PACKETPROPERTY_GUID_BUTTON_PRESSURE
 Pressione su un pulsante sensibile alla pressione.
STR_GUID_XTILTORIENTATION o GUID_PACKETPROPERTY_GUID_X_TILT_ORIENTATION
 Angolo tra il piano y,z e la penna e il piano dell'asse y.
Si applica a un cursore penna.
Il valore è 0 quando la penna è perpendicolare alla superficie di disegno ed è positiva quando la penna è a destra di perpendicolare.
STR_GUID_YTILTORIENTATION o GUID_PACKETPROPERTY_GUID_Y_TILT_ORIENTATION
 Angolo tra il piano x,z e la penna e il piano dell'asse x.
Si applica a un cursore penna.
Il valore è 0 quando la penna è perpendicolare alla superficie di disegno ed è positiva quando la penna è verso l'alto o lontano dall'utente.
STR_GUID_AZIMUTHORIENTATION o GUID_PACKETPROPERTY_GUID_AZIMUTH_ORIENTATION
 Rotazione in senso orario del cursore sull'asse z attraverso un intervallo circolare completo.
STR_GUID_ALTITUDEORIENTATION o GUID_PACKETPROPERTY_GUID_ALTITUDE_ORIENTATION
 Angolo tra l'asse della penna e la superficie del tablet.
Il valore è 0 quando la penna è parallela alla superficie e 90 quando la penna è perpendicolare alla superficie.
I valori sono negativi quando la penna viene invertita.
STR_GUID_TWISTORIENTATION o GUID_PACKETPROPERTY_GUID_TWIST_ORIENTATION
 Rotazione in senso orario del cursore sull'asse specifico.
STR_GUID_PITCHROTATION o GUID_PACKETPROPERTY_GUID_PITCH_ROTATION
 Proprietà del pacchetto che indica se la punta è sopra o sotto una linea orizzontale perpendicolare alla superficie di scrittura.
Nota: Questo richiede un digitalizzatore 3D.
Il valore è positivo se il suggerimento è sopra la riga e negativo se è sotto la riga. Ad esempio, se tieni la penna davanti a te e scrivi su una parete immaginaria, il passo è positivo se la punta è sopra una linea che si estende da te alla parete.
STR_GUID_ROLLROTATION o GUID_PACKETPROPERTY_GUID_ROLL_ROTATION
 Rotazione in senso orario della penna attorno al proprio asse.
Nota: Questo richiede un digitalizzatore 3D.
STR_GUID_YAWROTATION o GUID_PACKETPROPERTY_GUID_YAW_ROTATION
 Angolo della penna a sinistra o a destra intorno al centro dell'asse orizzontale quando la penna è orizzontale.
Nota: Questo richiede un digitalizzatore 3D.
Se tieni la penna davanti a te e scrivi su una parete immaginaria, zero yaw indica che la penna è perpendicolare al muro. Il valore è negativo se la punta è a sinistra di perpendicolare e positiva se la punta è a destra di perpendicolare.
STR_GUID_YAWROTATION o GUID_PACKETPROPERTY_GUID_YAW_ROTATION
 Angolo della penna a sinistra o a destra intorno al centro dell'asse orizzontale quando la penna è orizzontale.
Nota: Questo richiede un digitalizzatore 3D.
Se tieni la penna davanti a te e scrivi su una parete immaginaria, zero yaw indica che la penna è perpendicolare al muro. Il valore è negativo se la punta è a sinistra di perpendicolare e positiva se la punta è a destra di perpendicolare.
STR_GUID_WIDTH o GUID_PACKETPROPERTY_GUID_WIDTH
 Larghezza dell'area di contatto su un digitalizzatore tocco.
STR_GUID_HEIGHT o GUID_PACKETPROPERTY_GUID_HEIGHT
 Altezza dell'area di contatto su un digitalizzatore tocco.
STR_GUID_FINGERCONTACTCONFIDENCE o GUID_PACKETPROPERTY_GUID_FINGERCONTACTCONFIDENCE
 Livello di confidenza con cui si è verificato un contatto con il dito su un digitalizzatore touch.
STR_GUID_DEVICE_CONTACT_ID o GUID_PACKETPROPERTY_GUID_DEVICE_CONTACT_ID
 Identificatore del contatto del dispositivo per un pacchetto.

Commenti

Nota

Tutti i valori dei pacchetti provenienti dall'hardware del tablet sono numeri interi a 32 bit.

 

Requisiti

Requisito valore
Client minimo supportato
 Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato
 Nessuno supportato
Intestazione
Msinkaut.h (richiede anche Msinkaut_i.c)

Vedi anche

Metodo IsPacketPropertySupported

Metodo GetPropertyMetrics

Interfaccia IInkTablet