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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
Contém um ou mais dos seguintes valores de sinalizador:
|
|
A hora em que o pacote foi gerado. |
|
A hora em que o pacote foi gerado. |
|
A propriedade de pacote para identificar o pacote. Esse é o mesmo valor que você usa para recuperar o pacote da fila de pacotes. |
|
A pressão da ponta da caneta perpendicular à superfície do tablet. Quanto maior a pressão na ponta da caneta, mais tinta é desenhada. |
|
A pressão da ponta da caneta ao longo do plano da superfície do tablet. |
|
A pressão em um botão sensível à pressão. |
|
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. |
|
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. |
|
A rotação no sentido horário do cursor sobre o eixo z por meio de um intervalo circular completo. |
|
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. |
|
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. |
|
A largura da área de contato em um digitalizador de toque. |
|
A altura da área de contato em um digitalizador de toque. |
|
O nível de confiança de que havia contato com o dedo em um digitalizador de toque. |
|
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 |
|
Confira também