PointerPointProperties.IsPrimary Propriété

Définition

Espace de noms:

Windows.UI.Input

Obtient une valeur qui indique si l’entrée provient du pointeur principal lorsque plusieurs pointeurs sont inscrits.

public:
 property bool IsPrimary { bool get(); };

bool IsPrimary();

public bool IsPrimary { get; }

var boolean = pointerPointProperties.isPrimary;

Public ReadOnly Property IsPrimary As Boolean

Valeur de propriété

Boolean

bool

True si l’entrée provient du pointeur désigné comme principal ; sinon, false.

Exemples

Cet exemple utilise des points de suspension de couleur différentes pour indiquer si le pointeur associé à PointerRoutedEventArgs est le pointeur principal.

private void MainPage_PointerPressed(object sender, PointerRoutedEventArgs e)
{
    PointerPoint pt = e.GetCurrentPoint(pointerCanvas);
    contacts[pt.PointerId] = pt;
    PointerCounter.Text = contacts.Count.ToString();

    Ellipse ellipse = new Ellipse();
    ellipse.StrokeThickness = 2;
    ellipse.Width = ellipseDiameter;
    ellipse.Height = ellipseDiameter;
    ellipse.Tag = pt.PointerId;
    TranslateTransform translate = new TranslateTransform();
    translate.X = pt.Position.X - ellipseDiameter / 2;
    translate.Y = pt.Position.Y - ellipseDiameter / 2;
    ellipse.RenderTransform = translate;
    pointerCanvas.Children.Add(ellipse);

    if (pt.Properties.IsPrimary == true)
    {
        primaryPointer = pt;
        primaryEllipse = ellipse;
        primaryEllipse.Scale(scaleX: 2, scaleY: 2, centerX: 0, centerY: 0).Start();
        ellipse.Stroke = new SolidColorBrush(Windows.UI.ColorHelper.FromArgb(255, 255, 0, 0));

        // Create the transform
        ScaleTransform scaleTransform = new ScaleTransform();
        scaleTransform.ScaleX = primaryEllipse.Width * 1.25;
        scaleTransform.ScaleY = primaryEllipse.Height * 1.25;
        primaryEllipse.RenderTransform = scaleTransform;

        PointerPrimary.Text = pt.PointerId.ToString();
    }
    else
        ellipse.Stroke = new SolidColorBrush(Windows.UI.ColorHelper.FromArgb(255, 0, 0, 255));

    e.Handled = true;
}

Remarques

Le pointeur principal est un pointeur unique (tactile, souris et stylet/stylet) dans l’interaction actuelle.

Pour la souris, le pointeur principal est le seul pointeur pour lequel des événements de souris peuvent être générés.

Pour le contact tactile (où il peut y avoir plusieurs pointeurs simultanés), le pointeur principal est le premier contact d’une interaction. Pour toute interaction après le premier événement PointerPressed , IsPrimary retourne false.

Un nouveau pointeur principal n’est inscrit que lorsque tous les contacts de cette interaction sont supprimés et qu’un nouveau contact est ensuite détecté.

Un pointeur principal peut effectuer des actions qui ne sont pas disponibles pour d’autres pointeurs. Par exemple, lorsqu’un pointeur principal génère un message WM_POINTERDOWN sur une fenêtre inactive, un message WM_POINTERACTIVATE] est également envoyé à cette fenêtre.