Pointer Class

Fournit des propriétés de base pour le pointeur d'entrée associé à une souris, un stylet ou un contact tactile.

Dans la plupart des cas, nous vous recommandons d'obtenir les informations de pointeur via l'argument d'événement des gestionnaires d'événements de pointeur de votre infrastructure de langage Windows 8 sélectionnée (applications Windows Store utilisant JavaScript, applications Windows Store en C++, C# ou Visual Basic ou applications Windows Store utilisant DirectX avec C++).

Si l'argument d'événement n'expose pas intrinsèquement les détails de pointeur requis par votre application, vous pouvez accéder aux données étendues du pointeur via les méthodes GetCurrentPoint et GetIntermediatePoints de PointerRoutedEventArgs. Nous vous recommandons d'utiliser ces méthodes, car vous pouvez spécifier le contexte des données de pointeur.

Les méthodes statiques PointerPoint, GetCurrentPoint et GetIntermediatePoints utilisent toujours le contexte de l'application.

Héritage

Object
  Pointer

Syntaxe


public sealed class Pointer

Attributs

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Membres

PointerClasse possède ces types de membres :

Méthodes

The Pointer Classe hérite des méthodes de Object Classe.

Propriétés

Le PointerClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

IsInContact

En lecture seuleGets a value that determines whether the pointer device was in contact with a sensor or digitizer at the time that the event was reported.

IsInRange

En lecture seuleGets a value that indicates whether the pointer device is within detection range of a sensor or digitizer.

PointerDeviceType

En lecture seuleGets the PointerDeviceType for the pointer device.

PointerId

En lecture seuleGets the system-generated identifier for this pointer reference.

 

Remarques

Pointer est une classe abstraite utilisée pour décrire un périphérique d'entrée. Cette classe identifie le périphérique d'entrée (tel que le stylet, le doigt ou la souris) pour chaque événement de pointeur qui se produit.

Exemples

L'exemple de code suivant illustre l'utilisation de la classe Pointer pour rechercher la propriété PointerId spécifique de chaque contact d'entrée dans une application, utiliser la propriété PointerDeviceType pour ignorer les formulaires spécifiques d'entrée (par exemple, les entrées de souris) et stocker les positions de Pointer. Pour du code supplémentaire qui utilise la classe Pointer, consultez l'exemple d'entrée.


using System.Collections.Generic;
using Windows.Foundation;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Navigation;

namespace PointerExample
{
    public sealed partial class BlankPage : Page
    {
        Dictionary<uint, Point?> _contacts;
        const uint SUPPORTEDCONTACTS = 5;

        public BlankPage()
        {
            this.InitializeComponent();
            _contacts = new Dictionary<uint, Point?>((int)SUPPORTEDCONTACTS);
            this.PointerPressed += BlankPage_PointerPressed;
            this.PointerReleased += BlankPage_PointerReleased;
        }

        private void BlankPage_PointerPressed(object sender, 
            PointerRoutedEventArgs e)
        {
            // Ignore mouse inputs. 
            if (e.Pointer.PointerDeviceType != 
                Windows.Devices.Input.PointerDeviceType.Mouse)
            {
                // Store and and touch input contacts.  
                Windows.UI.Input.PointerPoint pt = e.GetCurrentPoint(this);
                _contacts[e.Pointer.PointerId] = pt.Position;
            }
            e.Handled = true;
        }

        private void BlankPage_PointerReleased(object sender, 
            PointerRoutedEventArgs e)
        {
            // Ignore mouse inputs.
            if (e.Pointer.PointerDeviceType != 
                Windows.Devices.Input.PointerDeviceType.Mouse)
            {
                // Remove pointer contacts information.
                uint ptrId = e.Pointer.PointerId;
                if (_contacts.ContainsKey(ptrId))
                {
                    _contacts[ptrId] = null;
                    _contacts.Remove(ptrId);
                }
            }
            e.Handled = true;
        }
    }
}


Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.UI.Xaml.Input
Windows::UI::Xaml::Input [C++]

Métadonnées

Windows.winmd

Voir aussi

Exemple d'entrée

 

 

Afficher:
© 2014 Microsoft