Share via

PacketPropertyGuids (constantes)

  • Artículo

Define valores que especifican las propiedades del paquete. Tablet PCAPI usa identificadores únicos globales (GUID) para identificar las propiedades de paquete, que en COM son cadenas constantes.

En C++, puede acceder a estas constantes en el archivo de encabezado Msinkaut.h, que se encuentra en el <directorio systemdrive>:\Program Files\Microsoft SDKs\Windows\v6.0\Include si instaló el SDK en la ubicación predeterminada. En C++, estas constantes son WCHAR, no BSTR. Conviértalos en BSTR antes de usarlos. Para obtener más información sobre el tipo de datos BSTR, vea Uso de la biblioteca COM.

En la tabla siguiente se enumeran los campos de identificador único global (GUID) de la propiedad de paquete disponible. Use estos GUID para especificar qué propiedades contiene el paquete al crear el contexto de tableta. Para determinar el intervalo y la resolución de una propiedad, llame al método GetPropertyMetrics . Las constantes de la tabla siguiente a partir de "STR_" son representaciones de cadena de las constantes binarias correspondientes que se muestran en la misma celda de tabla.

Constante Descripción
STR_GUID_X o GUID_PACKETPROPERTY_GUID_X
 Coordenada x en el espacio de coordenadas de la tableta. Cada paquete contiene esta propiedad de forma predeterminada. El origen (0,0) de la tableta es la esquina superior izquierda.
STR_GUID_Y o GUID_PACKETPROPERTY_GUID_Y
 Coordenada y en el espacio de coordenadas de la tableta. Cada paquete contiene esta propiedad de forma predeterminada. El origen (0,0) de la tableta es la esquina superior izquierda.
STR_GUID_Y o GUID_PACKETPROPERTY_GUID_Y
 Coordenada y en el espacio de coordenadas de la tableta. Cada paquete contiene esta propiedad de forma predeterminada. El origen (0,0) de la tableta es la esquina superior izquierda.
STR_GUID_Z o GUID_PACKETPROPERTY_GUID_Z
 Coordenada z o distancia de la punta del lápiz desde la superficie de la tableta. El tipo de enumeración TabletPropertyMetricUnit determina la unidad de medida de esta propiedad.
STR_GUID_PAKETSTATUS o GUID_PACKETPROPERTY_GUID_PACKET_STATUS
 Contiene uno o varios de los siguientes valores de marca:
  • El cursor está tocando la superficie de dibujo (Valor = 1).
  • El cursor se invierte. Por ejemplo, el extremo del borrador del lápiz apunta hacia la superficie (Valor = 2).
  • No se usa (Valor = 4).
  • Se presiona el botón de barril (Valor = 8).
STR_GUID_TIMERTICK o GUID_PACKETPROPERTY_GUID_TIMER_TICK
 Hora en que se generó el paquete.
STR_GUID_TIMERTICK o GUID_PACKETPROPERTY_GUID_TIMER_TICK
 Hora en que se generó el paquete.
STR_GUID_SERIALNUMBER o GUID_PACKETPROPERTY_GUID_SERIAL_NUMBER
 Propiedad packet para identificar el paquete.
Este es el mismo valor que se usa para recuperar el paquete de la cola de paquetes.
STR_GUID_NORMALPRESSURE o GUID_PACKETPROPERTY_GUID_NORMAL_PRESSURE
 Presión de la punta del lápiz perpendicular a la superficie de la tableta.
Cuanto mayor sea la presión sobre la punta del lápiz, más tinta que se dibuja.
STR_GUID_TANGENTPRESSURE o GUID_PACKETPROPERTY_GUID_TANGENT_PRESSURE
 Presión de la punta del lápiz a lo largo del plano de la superficie de la tableta.
STR_GUID_BUTTONPRESSURE o GUID_PACKETPROPERTY_GUID_BUTTON_PRESSURE
 Presión sobre un botón sensible a la presión.
STR_GUID_XTILTORIENTATION o GUID_PACKETPROPERTY_GUID_X_TILT_ORIENTATION
 Ángulo entre el plano y,z y el plano del eje y y.
Se aplica a un cursor de lápiz.
El valor es 0 cuando el lápiz es perpendicular a la superficie de dibujo y es positivo cuando el lápiz está a la derecha de perpendicular.
STR_GUID_YTILTORIENTATION o GUID_PACKETPROPERTY_GUID_Y_TILT_ORIENTATION
 Ángulo entre el plano x,z y el plano del lápiz y el plano del eje x.
Se aplica a un cursor de lápiz.
El valor es 0 cuando el lápiz es perpendicular a la superficie de dibujo y es positivo cuando el lápiz está hacia arriba o lejos del usuario.
STR_GUID_AZIMUTHORIENTATION o GUID_PACKETPROPERTY_GUID_AZIMUTH_ORIENTATION
 Rotación en el sentido de las agujas del reloj del cursor sobre el eje Z a través de un intervalo circular completo.
STR_GUID_ALTITUDEORIENTATION o GUID_PACKETPROPERTY_GUID_ALTITUDE_ORIENTATION
 Ángulo entre el eje del lápiz y la superficie de la tableta.
El valor es 0 cuando el lápiz es paralelo a la superficie y 90 cuando el lápiz es perpendicular a la superficie.
Los valores son negativos cuando el lápiz se invierte.
STR_GUID_TWISTORIENTATION o GUID_PACKETPROPERTY_GUID_TWIST_ORIENTATION
 Rotación en el sentido de las agujas del reloj del cursor sobre su propio eje.
STR_GUID_PITCHROTATION o GUID_PACKETPROPERTY_GUID_PITCH_ROTATION
 Propiedad de paquete que indica si la punta está por encima o por debajo de una línea horizontal que es perpendicular a la superficie de escritura.
Nota: Esto requiere un digitalizador 3D.
El valor es positivo si la punta está por encima de la línea y negativa si está por debajo de la línea. Por ejemplo, si mantiene el lápiz delante de usted y escribe en una pared imaginaria, el tono es positivo si la punta está por encima de una línea que se extiende desde usted a la pared.
STR_GUID_ROLLROTATION o GUID_PACKETPROPERTY_GUID_ROLL_ROTATION
 Rotación en el sentido de las agujas del reloj del lápiz alrededor de su propio eje.
Nota: Esto requiere un digitalizador 3D.
STR_GUID_YAWROTATION o GUID_PACKETPROPERTY_GUID_YAW_ROTATION
 Ángulo del lápiz a la izquierda o derecha alrededor del centro de su eje horizontal cuando el lápiz es horizontal.
Nota: Esto requiere un digitalizador 3D.
Si mantiene el lápiz delante de usted y escribe en una pared imaginaria, cero yaw indica que el lápiz es perpendicular a la pared. El valor es negativo si la punta está a la izquierda de perpendicular y positiva si la punta está a la derecha de perpendicular.
STR_GUID_YAWROTATION o GUID_PACKETPROPERTY_GUID_YAW_ROTATION
 Ángulo del lápiz a la izquierda o derecha alrededor del centro de su eje horizontal cuando el lápiz es horizontal.
Nota: Esto requiere un digitalizador 3D.
Si mantiene el lápiz delante de usted y escribe en una pared imaginaria, cero yaw indica que el lápiz es perpendicular a la pared. El valor es negativo si la punta está a la izquierda de perpendicular y positiva si la punta está a la derecha de perpendicular.
STR_GUID_WIDTH o GUID_PACKETPROPERTY_GUID_WIDTH
 Ancho del área de contacto en un digitalizador táctil.
STR_GUID_HEIGHT o GUID_PACKETPROPERTY_GUID_HEIGHT
 Alto del área de contacto en un digitalizador táctil.
STR_GUID_FINGERCONTACTCONFIDENCE o GUID_PACKETPROPERTY_GUID_FINGERCONTACTCONFIDENCE
 El nivel de confianza de que había contacto con el dedo en un digitalizador táctil.
STR_GUID_DEVICE_CONTACT_ID o GUID_PACKETPROPERTY_GUID_DEVICE_CONTACT_ID
 Identificador de contacto del dispositivo para un paquete.

Comentarios

Nota

Todos los valores de paquete procedentes del hardware de la tableta son enteros de tamaño de 32 bits.

 

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows XP Tablet PC Edition [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Encabezado
Msinkaut.h (también requiere Msinkaut_i.c)

Consulte también

IsPacketPropertySupported (método)

GetPropertyMetrics (método)

IInkTablet (interfaz)