Constantes PacketPropertyGuids

Define valores que especificam as propriedades do pacote. O Tablet PCAPI usa GUIDs (identificadores global exclusivos) para identificar propriedades de pacote, que no COM são cadeias de caracteres constantes.

No C++, você pode acessar essas constantes no arquivo de cabeçalho Msinkaut.h, que está localizado no <diretório systemdrive>:\Program Files\Microsoft SDKs\Windows\v6.0\Include se você instalou o SDK no local padrão. No C++, essas constantes são WCHARs, não BSTRs. Converta-os em BSTRs antes do uso. Para obter mais informações sobre o tipo de dados BSTR, consulte Usando a biblioteca COM.

A tabela a seguir lista os campos guid (identificador global exclusivo) da propriedade de pacote disponível. Use esses GUIDs para especificar quais propriedades o pacote contém quando você cria o contexto do tablet. Para determinar o intervalo e a resolução de uma propriedade, chame o método GetPropertyMetrics . As constantes na tabela abaixo começando com "STR_" são representações de cadeia de caracteres das constantes binárias correspondentes mostradas na mesma célula da tabela.

Constante Descrição
STR_GUID_X ou GUID_PACKETPROPERTY_GUID_X
A coordenada x no espaço de coordenadas do tablet. Cada pacote contém essa propriedade por padrão. A origem (0,0) do tablet é o canto superior esquerdo.
STR_GUID_Y ou GUID_PACKETPROPERTY_GUID_Y
A coordenada y no espaço de coordenadas do tablet. Cada pacote contém essa propriedade por padrão. A origem (0,0) do tablet é o canto superior esquerdo.
STR_GUID_Y ou GUID_PACKETPROPERTY_GUID_Y
A coordenada y no espaço de coordenadas do tablet. Cada pacote contém essa propriedade por padrão. A origem (0,0) do tablet é o canto superior esquerdo.
STR_GUID_Z ou GUID_PACKETPROPERTY_GUID_Z
A coordenada z ou a distância da ponta da caneta da superfície do tablet. O tipo de enumeração TabletPropertyMetricUnit determina a unidade de medida para essa propriedade.
STR_GUID_PAKETSTATUS ou GUID_PACKETPROPERTY_GUID_PACKET_STATUS
Contém um ou mais dos seguintes valores de sinalizador:
  • O cursor está tocando a superfície de desenho (Valor = 1).
  • O cursor é invertido. Por exemplo, a extremidade da borracha da caneta está apontando para a superfície (Valor = 2).
  • Não usado (Valor = 4).
  • O botão de barril é pressionado (Valor = 8).
STR_GUID_TIMERTICK ou GUID_PACKETPROPERTY_GUID_TIMER_TICK
A hora em que o pacote foi gerado.
STR_GUID_TIMERTICK ou GUID_PACKETPROPERTY_GUID_TIMER_TICK
A hora em que o pacote foi gerado.
STR_GUID_SERIALNUMBER ou GUID_PACKETPROPERTY_GUID_SERIAL_NUMBER
A propriedade de pacote para identificar o pacote.
Esse é o mesmo valor que você usa para recuperar o pacote da fila de pacotes.
STR_GUID_NORMALPRESSURE ou GUID_PACKETPROPERTY_GUID_NORMAL_PRESSURE
A pressão da ponta da caneta perpendicular à superfície do tablet.
Quanto maior a pressão na ponta da caneta, mais tinta é desenhada.
STR_GUID_TANGENTPRESSURE ou GUID_PACKETPROPERTY_GUID_TANGENT_PRESSURE
A pressão da ponta da caneta ao longo do plano da superfície do tablet.
STR_GUID_BUTTONPRESSURE ou GUID_PACKETPROPERTY_GUID_BUTTON_PRESSURE
A pressão em um botão sensível à pressão.
STR_GUID_XTILTORIENTATION ou GUID_PACKETPROPERTY_GUID_X_TILT_ORIENTATION
O ângulo entre o plano y,z e a caneta e o plano do eixo y.
Aplica-se a um cursor de caneta.
O valor é 0 quando a caneta é perpendicular à superfície de desenho e é positiva quando a caneta está à direita do perpendicular.
STR_GUID_YTILTORIENTATION ou GUID_PACKETPROPERTY_GUID_Y_TILT_ORIENTATION
O ângulo entre o plano x,z e a caneta e o plano do eixo x.
Aplica-se a um cursor de caneta.
O valor é 0 quando a caneta é perpendicular à superfície de desenho e é positiva quando a caneta está para cima ou para longe do usuário.
STR_GUID_AZIMUTHORIENTATION ou GUID_PACKETPROPERTY_GUID_AZIMUTH_ORIENTATION
A rotação no sentido horário do cursor sobre o eixo z por meio de um intervalo circular completo.
STR_GUID_ALTITUDEORIENTATION ou GUID_PACKETPROPERTY_GUID_ALTITUDE_ORIENTATION
O ângulo entre o eixo da caneta e a superfície do tablet.
O valor é 0 quando a caneta é paralela à superfície e 90 quando a caneta é perpendicular à superfície.
Os valores são negativos quando a caneta é invertida.
STR_GUID_TWISTORIENTATION ou GUID_PACKETPROPERTY_GUID_TWIST_ORIENTATION
A rotação no sentido horário do cursor sobre seu próprio eixo.
STR_GUID_PITCHROTATION ou GUID_PACKETPROPERTY_GUID_PITCH_ROTATION
A propriedade de pacote que indica se a dica está acima ou abaixo de uma linha horizontal perpendicular à superfície de gravação.
Nota: Isso requer um digitalizador 3D.
O valor será positivo se a dica estiver acima da linha e negativa se estiver abaixo da linha. Por exemplo, se você segurar a caneta na sua frente e escrever em uma parede imaginária, o tom será positivo se a ponta estiver acima de uma linha que se estende de você até a parede.
STR_GUID_ROLLROTATION ou GUID_PACKETPROPERTY_GUID_ROLL_ROTATION
A rotação no sentido horário da caneta em torno de seu próprio eixo.
Nota: Isso requer um digitalizador 3D.
STR_GUID_YAWROTATION ou GUID_PACKETPROPERTY_GUID_YAW_ROTATION
O ângulo da caneta à esquerda ou à direita ao redor do centro de seu eixo horizontal quando a caneta é horizontal.
Nota: Isso requer um digitalizador 3D.
Se você segurar a caneta na sua frente e escrever em uma parede imaginária, zero guinada indica que a caneta é perpendicular à parede. O valor será negativo se a dica estiver à esquerda de perpendicular e positiva se a dica estiver à direita do perpendicular.
STR_GUID_YAWROTATION ou GUID_PACKETPROPERTY_GUID_YAW_ROTATION
O ângulo da caneta à esquerda ou à direita ao redor do centro de seu eixo horizontal quando a caneta é horizontal.
Nota: Isso requer um digitalizador 3D.
Se você segurar a caneta na sua frente e escrever em uma parede imaginária, zero guinada indica que a caneta é perpendicular à parede. O valor será negativo se a dica estiver à esquerda de perpendicular e positiva se a dica estiver à direita do perpendicular.
STR_GUID_WIDTH ou GUID_PACKETPROPERTY_GUID_WIDTH
A largura da área de contato em um digitalizador de toque.
STR_GUID_HEIGHT ou GUID_PACKETPROPERTY_GUID_HEIGHT
A altura da área de contato em um digitalizador de toque.
STR_GUID_FINGERCONTACTCONFIDENCE ou GUID_PACKETPROPERTY_GUID_FINGERCONTACTCONFIDENCE
O nível de confiança de que havia contato com o dedo em um digitalizador de toque.
STR_GUID_DEVICE_CONTACT_ID ou GUID_PACKETPROPERTY_GUID_DEVICE_CONTACT_ID
O identificador de contato do dispositivo para um pacote.

Comentários

Observação

Todos os valores de pacote provenientes do hardware do tablet são inteiros de tamanho de 32 bits.

 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
parâmetro
Msinkaut.h (também requer Msinkaut_i.c)

Confira também

Método IsPacketPropertySupported

Método GetPropertyMetrics

IInkTablet Interface