Partage via


Control.RequiresPointer Propriété

Définition

Obtient ou définit si un élément d’interface utilisateur prend en charge le mode souris, qui émule les expériences d’interaction du pointeur avec des périphériques d’entrée autres qu’un pointeur, comme un pavé de jeu ou une commande à distance.

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"/>

Valeur de propriété

Mode émulation du pointeur. La valeur par défaut est Jamais.

Configuration requise pour Windows

Famille d’appareils
Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Remarques

Pour les appareils d’entrée non pointeurs, le focus est déplacé entre les contrôles par diverses méthodes, telles que les touches Tab et de direction d’un clavier, le pavé directionnel (D-pad) d’une télécommande ou les touches de pouce sur une manette de jeu. Pour certaines expériences utilisateur, telles que les cartes et les surfaces de dessin, il n’est pas possible ou pratique d’utiliser la navigation avec focus XY. RequiresPointer permet à une application de fournir une expérience d’interaction plus semblable à un pointeur via un curseur qui peut être déplacé librement à l’aide d’appareils d’entrée de jeu.

RequiresPointer est pris en charge uniquement sur la famille d’appareils Xbox, et uniquement lors de l’utilisation d’un pavé de jeu ou d’une télécommande. Sinon, la propriété est ignorée.

RequiresPointerMode définit le mode souris au niveau de l’application.

Pour plus d’informations, consultez la section Mode souris de Conception pour Xbox et TV.

Compatibilité des versions

La propriété RequiresPointer n’est pas disponible avant Windows 10 version 1607. Si le paramètre « version minimale de la plateforme » de votre application dans Microsoft Visual Studio est inférieur à la « version introduite » indiquée dans le bloc Configuration requise plus loin dans cette page, vous devez concevoir et tester votre application pour en tenir compte. Pour plus d’informations, consultez Code adaptatif version.

Pour éviter les exceptions lorsque votre application s’exécute sur des versions précédentes de Windows 10, ne définissez pas cette propriété en XAML ou ne l’utilisez pas sans effectuer de case activée d’exécution. Cet exemple montre comment utiliser la classe ApiInformation pour case activée la présence de cette propriété avant de la définir.

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

S’applique à

Voir aussi