Control.RequiresPointer Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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;
}