Control.RequiresPointer Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece si un elemento de interfaz de usuario admite el modo de mouse, que emula experiencias de interacción de puntero con dispositivos de entrada que no son de puntero, como un panel de juego o un control remoto.
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 de propiedad
Modo de emulación de puntero. El valor predeterminado es Never.
Requisitos de Windows
| Familia de dispositivos |
Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)
|
Comentarios
En el caso de los dispositivos de entrada que no son punteros, el foco se mueve entre controles a través de una variedad de métodos, como las teclas de tabulación y flecha en un teclado, el panel direccional (D-pad) en un mando remoto o los sticks de pulgar en un controlador de juego. Para algunas experiencias de usuario, como mapas y superficies de dibujo, no es posible ni práctico usar la navegación con foco XY. RequiresPointer permite a una aplicación proporcionar una experiencia de interacción más similar a un puntero a través de un cursor que se puede mover libremente mediante dispositivos de entrada de juego.
RequiresPointer solo se admite en la familia de dispositivos Xbox y solo cuando se usa un panel de juegos o un control remoto. De lo contrario, se omite la propiedad .
RequiresPointerMode establece el modo de mouse en el nivel de aplicación.
Para obtener más información, consulta la sección Modo de mouse de Diseño para Xbox y TV.
Compatibilidad de versiones
La propiedad RequiresPointer no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para que tenga en cuenta esto. Para obtener más información, consulta Código adaptable de versión.
Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no establezca esta propiedad en XAML ni úsela sin realizar una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de esta propiedad antes de establecerla.
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "RequiresPointer"))
{
mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}