Compartilhar via


Control.RequiresPointer Propriedade

Definição

Obtém ou define se um elemento de interface do usuário dá suporte ao modo de mouse, que emula experiências de interação de ponteiro com dispositivos de entrada sem ponteiro, como um controle remoto ou de teclado de jogo.

public:
 property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };
RequiresPointer RequiresPointer();

void RequiresPointer(RequiresPointer value);
public RequiresPointer RequiresPointer { get; set; }
var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;
Public Property RequiresPointer As RequiresPointer
<control RequiresPointer="requiresPointerMemberName"/>

Valor da propriedade

O modo de emulação de ponteiro. O padrão é Nunca.

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)

Comentários

Para dispositivos de entrada sem ponteiro, o foco é movido entre controles por meio de uma variedade de métodos, como as teclas Tab e seta em um teclado, o teclado direcional (D-pad) em um controle remoto ou os pendrives em um controlador de jogo. Para algumas experiências do usuário, como mapas e superfícies de desenho, não é possível ou prático usar a navegação de foco XY. RequiresPointer permite que um aplicativo forneça uma experiência de interação mais semelhante a um ponteiro por meio de um cursor que pode ser movido livremente usando dispositivos de entrada de jogo.

O RequiresPointer tem suporte apenas na família de dispositivos Xbox e somente ao usar um controle remoto ou de game pad. Caso contrário, a propriedade será ignorada.

RequiresPointerMode define o modo do mouse no nível do aplicativo.

Para obter mais informações, consulte a seção Modo mouse de Design para Xbox e TV.

Compatibilidade de versões

A propriedade RequiresPointer não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor do que a "versão introduzida" mostrada no bloco Requisitos mais adiante nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar uma marcar de runtime. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "RequiresPointer"))
{
    mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}

Aplica-se a

Confira também