InjectedInputPointerOptions Énumération
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.
Spécifie les différentes options, ou modificateurs, utilisés pour simuler l’entrée de pointeur via InjectedInputMouseInfo, InjectedInputPenInfo et InjectedInputTouchInfo.
Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.
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
- Héritage
-
InjectedInputPointerOptions
- Attributs
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)
|
Champs
Canceled | 32768 | Indique que le pointeur part d’une manière anormale, par exemple lorsque le système reçoit une entrée non valide pour le pointeur ou lorsqu’un appareil avec des pointeurs actifs s’en va brusquement. Si l’application recevant l’entrée est en mesure de le faire, elle doit traiter l’interaction comme non terminée et inverser les effets du pointeur. |
CaptureChanged | 2097152 | Indique que ce pointeur a été capturé par (associé à) un autre élément et que l’élément d’origine a perdu la capture. |
Confidence | 16384 | Indique une suggestion de l’appareil source indiquant si le pointeur représente une interaction prévue ou accidentelle, ce qui est particulièrement pertinent pour les pointeurs tactiles où une interaction accidentelle (par exemple avec la paume de la main) peut déclencher une entrée. La présence de cet indicateur indique que l’appareil source est très sûr que cette entrée fait partie d’une interaction prévue. |
FirstButton | 16 | Indique une action principale. Un pointeur tactile a cet indicateur défini lorsqu’il est en contact avec la surface du numériseur. Un pointeur de stylet a cet indicateur défini lorsqu’il est en contact avec la surface du numériseur sans appuyer sur les boutons. Un pointeur de souris a cet indicateur défini lorsque le bouton gauche de la souris est enfoncé. |
InContact | 4 | Indique que le pointeur est en contact avec la surface ou la zone du numériseur. Lorsque cet indicateur n’est pas défini, il indique un pointeur pointant. |
InRange | 2 | Indique que le pointeur continue d’exister. Lorsque cet indicateur n’est pas défini, il indique que le pointeur a gauche la plage de détection. |
New | 1 | Indique l’arrivée d’un nouveau pointeur. |
None | 0 | Aucun modificateur de pointeur. Par défaut. |
PointerDown | 65536 | Indique que ce pointeur a été en contact avec la surface du numériseur. Un pointeur tactile a cet indicateur défini lorsqu’il est en contact avec la surface du numériseur. Un pointeur de stylet a cet indicateur défini lorsqu’il est en contact avec la surface du numériseur. Cet indicateur est défini sur un pointeur de souris lorsque vous appuyez sur un bouton de la souris. |
PointerUp | 262144 | Indique que ce pointeur a terminé le contact avec la surface du numériseur. Un pointeur tactile a cet indicateur défini lorsqu’il termine le contact avec la surface du numériseur. Un pointeur de stylet a cet indicateur défini lorsqu’il termine le contact avec la surface du numériseur. Cet indicateur est défini sur un pointeur de souris lorsqu’un bouton de la souris est relâché. |
Primary | 8192 | Indique que le pointeur peut effectuer des actions au-delà de celles disponibles pour les pointeurs non principaux. Par exemple, lorsqu’un pointeur principal entre en contact avec la surface d’une fenêtre, il peut permettre à la fenêtre de s’activer. Le pointeur principal est identifié à partir de toutes les interactions utilisateur actuelles sur le système (souris, interaction tactile, stylet, etc.). Par conséquent, le pointeur principal peut ne pas être associé à votre application. Le premier contact dans une interaction multi touch est défini comme pointeur principal. Une fois qu’un pointeur principal est identifié, tous les contacts doivent être levés avant qu’un nouveau contact puisse être identifié en tant que pointeur principal. Pour les applications qui ne traitent pas l’entrée de pointeur, seuls les événements du pointeur principal sont promus en événements de souris. |
SecondButton | 32 | Indique une action secondaire. Un pointeur tactile n’utilise pas cet indicateur. Un pointeur de stylet a cet indicateur défini lorsqu’il est en contact avec la surface du numériseur avec le bouton du canon de stylet enfoncé. Un pointeur de souris a cet indicateur défini lorsque le bouton droit de la souris est enfoncé. |
Update | 131072 | Indique une mise à jour simple qui n’inclut pas les changements d’état du pointeur. |
Exemples
Voici quelques exemples téléchargeables illustrant l’entrée de base et l’injection d’entrée :
- Exemple d’injection d’entrée (souris tactile)
- Exemple d’injection tactile
- Entrée : exemple d’événements d’entrée utilisateur XAML
Remarques
Important
Les API de cet espace de noms nécessitent la fonctionnalité restreinte inputInjectionBrokered.
L’utilisation de l’injection d’entrée nécessite l’ajout des éléments suivants au Package.appxmanifest :
- À
<Package>
xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
IgnorableNamespaces="rescap"
- À
<Capabilities>
<rescap:Capability Name="inputInjectionBrokered" />