InjectedInputPointerOptions Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Especifica as várias opções, ou modificadores, usadas para simular a entrada do ponteiro por meio de InjectedInputMouseInfo, InjectedInputPenInfo e InjectedInputTouchInfo.
Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.
public enum class InjectedInputPointerOptions
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
enum class InjectedInputPointerOptions
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
public enum InjectedInputPointerOptions
var value = Windows.UI.Input.Preview.Injection.InjectedInputPointerOptions.none
Public Enum InjectedInputPointerOptions
- Herança
-
InjectedInputPointerOptions
- Atributos
Requisitos do Windows
Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v3.0)
|
Campos
Canceled | 32768 | Indica que o ponteiro está partindo de maneira anormal, como quando o sistema recebe entrada inválida para o ponteiro ou quando um dispositivo com ponteiros ativos parte abruptamente. Se o aplicativo que recebe a entrada estiver em uma posição para fazer isso, ele deverá tratar a interação como não concluída e reverter quaisquer efeitos do ponteiro. |
CaptureChanged | 2097152 | Indica que esse ponteiro foi capturado por (associado a) outro elemento e o elemento original perdeu a captura. |
Confidence | 16384 | Indica uma sugestão do dispositivo de origem sobre se o ponteiro representa uma interação pretendida ou acidental, que é especialmente relevante para ponteiros de toque em que uma interação acidental (como com a palma da mão) pode disparar a entrada. A presença desse sinalizador indica que o dispositivo de origem tem alta confiança de que essa entrada faz parte de uma interação pretendida. |
FirstButton | 16 | Indica uma ação primária. Um ponteiro de toque tem esse sinalizador definido quando está em contato com a superfície do digitalizador. Um ponteiro de caneta tem esse sinalizador definido quando está em contato com a superfície do digitalizador sem botões pressionados. Um ponteiro do mouse tem esse sinalizador definido quando o botão esquerdo do mouse está inativo. |
InContact | 4 | Indica que o ponteiro está em contato com a superfície ou área do digitalizador. Quando esse sinalizador não está definido, ele indica um ponteiro de foco. |
InRange | 2 | Indica que o ponteiro continua a existir. Quando esse sinalizador não está definido, ele indica que o ponteiro tem o intervalo de detecção à esquerda. |
New | 1 | Indica a chegada de um novo ponteiro. |
None | 0 | Nenhum modificador de ponteiro. Padrão. |
PointerDown | 65536 | Indica que esse ponteiro fez contato com a superfície do digitalizador. Um ponteiro de toque tem esse sinalizador definido quando está em contato com a superfície do digitalizador. Um ponteiro de caneta tem esse sinalizador definido quando está em contato com a superfície do digitalizador. Um ponteiro do mouse tem esse sinalizador definido quando um botão do mouse é pressionado. |
PointerUp | 262144 | Indica que esse ponteiro terminou o contato com a superfície do digitalizador. Um ponteiro de toque tem esse sinalizador definido quando termina o contato com a superfície do digitalizador. Um ponteiro de caneta tem esse sinalizador definido quando termina o contato com a superfície do digitalizador. Um ponteiro do mouse tem esse sinalizador definido quando um botão do mouse é liberado. |
Primary | 8192 | Indica que o ponteiro pode executar ações além daquelas disponíveis para ponteiros não primários. Por exemplo, quando um ponteiro primário faz contato com a superfície de uma janela, ele pode fornecer à janela uma oportunidade de ativar. O ponteiro primário é identificado de todas as interações atuais do usuário no sistema (mouse, toque, caneta e assim por diante). Dessa forma, o ponteiro primário pode não estar associado ao seu aplicativo. O primeiro contato em uma interação de vários toques é definido como o ponteiro primário. Depois que um ponteiro primário é identificado, todos os contatos devem ser levantados antes que um novo contato possa ser identificado como um ponteiro primário. Para aplicativos que não processam a entrada de ponteiro, somente os eventos do ponteiro primário são promovidos a eventos do mouse. |
SecondButton | 32 | Indica uma ação secundária. Um ponteiro de toque não usa esse sinalizador. Um ponteiro de caneta tem esse sinalizador definido quando está em contato com a superfície do digitalizador com o botão de caneta pressionado. Um ponteiro do mouse tem esse sinalizador definido quando o botão direito do mouse está inativo. |
Update | 131072 | Indica uma atualização simples que não inclui alterações de estado do ponteiro. |
Exemplos
Aqui estão alguns exemplos para download que demonstram a entrada básica e a injeção de entrada:
- Amostra de injeção de entrada (mouse para toque)
- Exemplo de injeção de toque
- Entrada: amostra de eventos de entrada do usuário XAML
Comentários
Importante
As APIs nesse namespace exigem a funcionalidade restrita inputInjectionBrokered.
O uso da injeção de entrada requer que o seguinte seja adicionado ao Package.appxmanifest:
- Para
<Package>
xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
IgnorableNamespaces="rescap"
- Para
<Capabilities>
<rescap:Capability Name="inputInjectionBrokered" />