Gestire l'input del puntatore

Ricevere, elaborare e gestire i dati di input dai dispositivi di puntamento come tocco, mouse, penna/stilo e touchpad nelle applicazioni Windows.

Importante

Creare interazioni personalizzate solo se esiste un requisito chiaro e ben definito e le interazioni supportate dai controlli della piattaforma non supportano lo scenario.
Se si personalizzano le esperienze di interazione nell'applicazione Windows, gli utenti si aspettano che siano coerenti, intuitive e individuabili. Per questi motivi, è consigliabile modellare le interazioni personalizzate su quelle supportate dai controlli della piattaforma. I controlli della piattaforma offrono l'esperienza di interazione utente completa dell'app Windows, inclusi le interazioni standard, gli effetti fisici animati, il feedback visivo e l'accessibilità.

API importanti

Puntatori

La maggior parte delle esperienze di interazione implica in genere l'identificazione dell'oggetto con cui l'utente vuole interagire puntando a esso con dispositivi di input come tocco, mouse, penna/stilo e touchpad. Poiché i dati HID (Human Interface Device) non elaborati forniti da questi dispositivi di input includono molte proprietà comuni, i dati vengono promossi e consolidati in uno stack di input unificato ed esposti come dati del puntatore indipendenti dai dispositivi. Le applicazioni Windows possono quindi usare questi dati senza preoccuparsi del dispositivo di input usato.

Nota

Le informazioni specifiche del dispositivo vengono promosse rispetto ai dati HID non elaborati, se l'app lo richiede.

Ogni punto di input (o contatto) sullo stack di input rappresentato da un oggetto Pointer esposto tramite il parametro PointerRoutedEventArgs nei vari gestori degli eventi puntatore. Nel caso di input multi-penna o multitocco, ogni contatto viene considerato come un puntatore di input univoco.

Eventi puntatore

Gli eventi puntatore espongono informazioni di base come il tipo di dispositivo di input e lo stato di rilevamento (nell'intervallo o nel contatto) e informazioni estese come la posizione, la pressione e la geometria di contatto. Sono anche disponibili proprietà specifiche del dispositivo come la pressione di un determinato pulsante del mouse o l'eventuale uso della gomma della penna. Se l'app deve distinguere tra i dispositivi di input e le relative funzionalità, vedere Identificare i dispositivi di input.

Le app Windows possono restare in ascolto dei seguenti eventi puntatore:

Nota

Vincolare l'input del puntatore a un elemento dell'interfaccia utente specifico chiamando CapturePointer su quell'elemento all'interno di un gestore dell'evento puntatore. Quando un puntatore viene acquisito da un elemento, solo quell'oggetto riceve gli eventi di input del puntatore, anche quando il puntatore si sposta all'esterno dell'area di delimitazione dell'oggetto. IsInContact (pressione del pulsante del mouse, tocco o stilo in contatto) deve essere true affinché CapturePointer vada a buon fine.

Evento Descrizione

Pointercanceled

Si verifica quando un puntatore viene annullato dalla piattaforma. Può verificarsi nelle circostanze seguenti:

  • I puntatori tocco vengono annullati quando viene rilevata una penna nell'intervallo della superficie di input.
  • Un contatto attivo non viene rilevato per più di 100 ms.
  • Vengono modificate le impostazioni del monitor/display (risoluzione, configurazione multi-monitor).
  • Il desktop è bloccato o l'utente si è disconnesso.
  • Il numero di contatti simultanei ha superato il numero supportato dal dispositivo.

PointerCaptureLost

Si verifica quando un altro elemento dell'interfaccia utente acquisisce il puntatore, il puntatore è stato rilasciato o è stato acquisito un altro puntatore a livello di codice.

Nota Non esiste alcun evento di acquisizione puntatore corrispondente.
 

PointerEntered

Si verifica quando un puntatore entra nell'area di delimitazione di un elemento. Può verificarsi in modi leggermente diversi per l'input tocco, touchpad, mouse e penna.

  • Il tocco richiede un contatto con il dito per generare questo evento, sia da un tocco diretto sull'elemento sia dallo spostamento nell'area di delimitazione dell'elemento.
  • Mouse e touchpad hanno entrambi un cursore sullo schermo sempre visibile che attiva questo evento anche se non viene premuto alcun pulsante del mouse o del touchpad.
  • Come il tocco, la penna genera questo evento con una penna diretta verso il basso sull'elemento o spostandosi nell'area di delimitazione dell'elemento. Tuttavia, anche la penna ha uno stato di passaggio del mouse (IsInRange) che, quando true, genera questo evento.

PointerExited

Si verifica quando un puntatore esce dall'area di delimitazione di un elemento. Può verificarsi in modi leggermente diversi per l'input tocco, touchpad, mouse e penna.

  • Il tocco richiede un contatto con il dito e genera questo evento quando il puntatore si sposta all'esterno dell'area di delimitazione dell'elemento.
  • Mouse e touchpad hanno entrambi un cursore sullo schermo sempre visibile che attiva questo evento anche se non viene premuto alcun pulsante del mouse o del touchpad.
  • Come il tocco, la penna genera questo evento quando si sposta all'esterno dell'area di delimitazione dell'elemento. Tuttavia, anche la penna dispone di uno stato di passaggio del mouse (IsInRange) che genera questo evento quando lo stato passa da true a false.

PointerMoved

Si verifica quando un puntatore modifica le coordinate, lo stato del pulsante, la pressione, l'inclinazione o la geometria del contatto (ad esempio, larghezza e altezza) all'interno dell'area di delimitazione di un elemento. Può verificarsi in modi leggermente diversi per l'input tocco, touchpad, mouse e penna.

  • Il tocco richiede un contatto con un dito e genera questo evento solo quando si trova in contatto all'interno dell'area di delimitazione dell'elemento.
  • Mouse e touchpad hanno entrambi un cursore sullo schermo sempre visibile che attiva questo evento anche se non viene premuto alcun pulsante del mouse o del touchpad.
  • Come il tocco, la penna genera questo evento quando è in contatto all'interno dell'area di delimitazione dell'elemento. Tuttavia, anche la penna dispone di uno stato di passaggio del mouse (IsInRange) che genera questo evento quando è true e all'interno dell'area di delimitazione dell'elemento.

PointerPressed

Si verifica quando il puntatore indica un'azione di pressione (ad esempio un tocco, una pressione del pulsante del mouse, di una penna o del pulsante del touchpad) all'interno dell'area di delimitazione di un elemento.

CapturePointer deve essere chiamato dal gestore di questo evento.

PointerReleased

Si verifica quando il puntatore indica un'azione di rilascio (ad esempio il rilascio di un tocco, di un pulsante del mouse, di una penna o di un pulsante del touchpad) all'interno dell'area di delimitazione di un elemento o, se il puntatore viene acquisito, all'esterno dell'area di delimitazione.

PointerWheelChanged

Si verifica quando la rotella del mouse viene ruotata.

L'input del mouse è associato a un singolo puntatore assegnato quando viene rilevato per la prima volta l'input del mouse. Il clic con un pulsante del mouse (sinistro, destro o rotellina) crea un'associazione secondaria tra il puntatore e il pulsante attraverso l'evento PointerMoved.

 

Esempio di evento puntatore

Ecco alcuni frammenti di codice di un'app di rilevamento del puntatore di base che mostrano come rimanere in ascolto di eventi e gestirli per più puntatori e ottenere varie proprietà per i puntatori associati.

Interfaccia utente dell'applicazione puntatore

Scaricare questo esempio dall'esempio di input del puntatore (di base)

Creare l'interfaccia utente

Per questo esempio si usa un oggetto Rectangle (Target) come input del puntatore che usa l'oggetto. Il colore della destinazione cambia quando cambia lo stato del puntatore.

I dettagli di ogni puntatore vengono visualizzati in un oggetto TextBlock mobile che segue il puntatore mentre si sposta. Gli eventi del puntatore vengono riferiti nell'oggetto RichTextBlock a destra del rettangolo.

Questo è il linguaggio XAML (Extensible Application Markup Language) per l'interfaccia utente in questo esempio.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Grid.ColumnDefinitions>
        <ColumnDefinition Width="*" />
        <ColumnDefinition Width="250"/>
    </Grid.ColumnDefinitions>
    <Grid.RowDefinitions>
        <RowDefinition Height="*" />
        <RowDefinition Height="320" />
        <RowDefinition Height="*"/>
    </Grid.RowDefinitions>
    <Canvas Name="Container" 
            Grid.Column="0"
            Grid.Row="1"
            HorizontalAlignment="Center" 
            VerticalAlignment="Center" 
            Margin="245,0" 
            Height="320"  Width="640">
        <Rectangle Name="Target" 
                    Fill="#FF0000" 
                    Stroke="Black" 
                    StrokeThickness="0"
                    Height="320" Width="640" />
    </Canvas>
    <Grid Grid.Column="1" Grid.Row="0" Grid.RowSpan="3">
        <Grid.RowDefinitions>
            <RowDefinition Height="50" />
            <RowDefinition Height="*" />
        </Grid.RowDefinitions>
        <Button Name="buttonClear" 
                Grid.Row="0"
                Content="Clear"
                Foreground="White"
                HorizontalAlignment="Stretch" 
                VerticalAlignment="Stretch">
        </Button>
        <ScrollViewer Name="eventLogScrollViewer" Grid.Row="1" 
                        VerticalScrollMode="Auto" 
                        Background="Black">                
            <RichTextBlock Name="eventLog"  
                        TextWrapping="Wrap" 
                        Foreground="#FFFFFF" 
                        ScrollViewer.VerticalScrollBarVisibility="Visible" 
                        ScrollViewer.HorizontalScrollBarVisibility="Disabled"
                        Grid.ColumnSpan="2">
            </RichTextBlock>
        </ScrollViewer>
    </Grid>
</Grid>

Rimanere in ascolto degli eventi del puntatore

Nella maggior parte dei casi, è consigliabile ottenere informazioni sul puntatore attraverso PointerRoutedEventArgs del gestore dell'evento.

Se l'argomento dell'evento non espone i dettagli del puntatore necessari, è possibile accedere alle informazioni PointerPoint estse esposte attraverso i metodi GetCurrentPoint e GetIntermediatePoints di PointerRoutedEventArgs.

Il codice seguente configura l'oggetto dizionario globale per rilevare ogni puntatore attivo e identifica i vari listener eventi del puntatore per l'oggetto di destinazione.

// Dictionary to maintain information about each active pointer. 
// An entry is added during PointerPressed/PointerEntered events and removed 
// during PointerReleased/PointerCaptureLost/PointerCanceled/PointerExited events.
Dictionary<uint, Windows.UI.Xaml.Input.Pointer> pointers;

public MainPage()
{
    this.InitializeComponent();

    // Initialize the dictionary.
    pointers = new Dictionary<uint, Windows.UI.Xaml.Input.Pointer>();

    // Declare the pointer event handlers.
    Target.PointerPressed += 
        new PointerEventHandler(Target_PointerPressed);
    Target.PointerEntered += 
        new PointerEventHandler(Target_PointerEntered);
    Target.PointerReleased += 
        new PointerEventHandler(Target_PointerReleased);
    Target.PointerExited += 
        new PointerEventHandler(Target_PointerExited);
    Target.PointerCanceled += 
        new PointerEventHandler(Target_PointerCanceled);
    Target.PointerCaptureLost += 
        new PointerEventHandler(Target_PointerCaptureLost);
    Target.PointerMoved += 
        new PointerEventHandler(Target_PointerMoved);
    Target.PointerWheelChanged += 
        new PointerEventHandler(Target_PointerWheelChanged);

    buttonClear.Click += 
        new RoutedEventHandler(ButtonClear_Click);
}

Gestire gli eventi del puntatore

A questo punto, si userà il feedback dell'interfaccia utente per dimostrare i gestori degli eventi del puntatore di base.

  • Questo gestore gestisce l'evento PointerPressed. Si aggiunge l'evento al registro eventi, si aggiunge il puntatore al dizionario puntatore attivo e si visualizzano i dettagli del puntatore.

    Nota

    Gli eventi PointerPressed e PointerReleased non si verificano sempre a coppie. L'app dovrebbe rimanere in ascolto e gestire eventuali eventi che potrebbero concludere la pressione di un puntatore (ad esempio PointerExited, PointerCanceled e PointerCaptureLost).  

/// <summary>
/// The pointer pressed event handler.
/// PointerPressed and PointerReleased don't always occur in pairs. 
/// Your app should listen for and handle any event that can conclude 
/// a pointer down (PointerExited, PointerCanceled, PointerCaptureLost).
/// </summary>
/// <param name="sender">Source of the pointer event.</param>
/// <param name="e">Event args for the pointer routed event.</param>
void Target_PointerPressed(object sender, PointerRoutedEventArgs e)
{
    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    PointerPoint ptrPt = e.GetCurrentPoint(Target);

    // Update event log.
    UpdateEventLog("Down: " + ptrPt.PointerId);

    // Lock the pointer to the target.
    Target.CapturePointer(e.Pointer);

    // Update event log.
    UpdateEventLog("Pointer captured: " + ptrPt.PointerId);

    // Check if pointer exists in dictionary (ie, enter occurred prior to press).
    if (!pointers.ContainsKey(ptrPt.PointerId))
    {
        // Add contact to dictionary.
        pointers[ptrPt.PointerId] = e.Pointer;
    }

    // Change background color of target when pointer contact detected.
    Target.Fill = new SolidColorBrush(Windows.UI.Colors.Green);

    // Display pointer details.
    CreateInfoPop(ptrPt);
}
  • Questo gestore gestisce l'evento PointerEntered. Si aggiunge l'evento al registro eventi, si aggiunge il puntatore alla raccolta di puntatori e si visualizzano i dettagli del puntatore.
/// <summary>
/// The pointer entered event handler.
/// We do not capture the pointer on this event.
/// </summary>
/// <param name="sender">Source of the pointer event.</param>
/// <param name="e">Event args for the pointer routed event.</param>
private void Target_PointerEntered(object sender, PointerRoutedEventArgs e)
{
    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    PointerPoint ptrPt = e.GetCurrentPoint(Target);

    // Update event log.
    UpdateEventLog("Entered: " + ptrPt.PointerId);

    // Check if pointer already exists (if enter occurred prior to down).
    if (!pointers.ContainsKey(ptrPt.PointerId))
    {
        // Add contact to dictionary.
        pointers[ptrPt.PointerId] = e.Pointer;
    }

    if (pointers.Count == 0)
    {
        // Change background color of target when pointer contact detected.
        Target.Fill = new SolidColorBrush(Windows.UI.Colors.Blue);
    }

    // Display pointer details.
    CreateInfoPop(ptrPt);
}
  • Questo gestore gestisce l'evento PointerMoved. Si aggiunge l'evento al registro eventi e si aggiornano i dettagli del puntatore.

    Importante

    L'input del mouse è associato a un singolo puntatore assegnato quando viene rilevato per la prima volta l'input del mouse. Il clic di un pulsante del mouse (sinistro, destro o rotellina) crea un'asociazione secondaria tra il puntatore e quel pulsante attraverso l'evento PointerPressed. L'evento PointerReleased viene generato solo quando lo stesso pulsante del mouse viene rilasciato (nessun altro pulsante può essere associato al puntatore finché questo evento non viene completato). A causa di questa associazione esclusiva, altri clic del pulsante del mouse vengono instradati tramite l'evento PointerMoved.  

/// <summary>
/// The pointer moved event handler.
/// </summary>
/// <param name="sender">Source of the pointer event.</param>
/// <param name="e">Event args for the pointer routed event.</param>
private void Target_PointerMoved(object sender, PointerRoutedEventArgs e)
{
    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    PointerPoint ptrPt = e.GetCurrentPoint(Target);

    // Multiple, simultaneous mouse button inputs are processed here.
    // Mouse input is associated with a single pointer assigned when 
    // mouse input is first detected. 
    // Clicking additional mouse buttons (left, wheel, or right) during 
    // the interaction creates secondary associations between those buttons 
    // and the pointer through the pointer pressed event. 
    // The pointer released event is fired only when the last mouse button 
    // associated with the interaction (not necessarily the initial button) 
    // is released. 
    // Because of this exclusive association, other mouse button clicks are 
    // routed through the pointer move event.          
    if (ptrPt.PointerDevice.PointerDeviceType == Windows.Devices.Input.PointerDeviceType.Mouse)
    {
        if (ptrPt.Properties.IsLeftButtonPressed)
        {
            UpdateEventLog("Left button: " + ptrPt.PointerId);
        }
        if (ptrPt.Properties.IsMiddleButtonPressed)
        {
            UpdateEventLog("Wheel button: " + ptrPt.PointerId);
        }
        if (ptrPt.Properties.IsRightButtonPressed)
        {
            UpdateEventLog("Right button: " + ptrPt.PointerId);
        }
    }

    // Display pointer details.
    UpdateInfoPop(ptrPt);
}
  • Questo gestore gestisce l'evento PointerWheelChanged. Si aggiunge l'evento al registro eventi, si aggiunge il puntatore alla matrice di puntatori (se necessario) e si visualizzano i dettagli del puntatore.
/// <summary>
/// The pointer wheel event handler.
/// </summary>
/// <param name="sender">Source of the pointer event.</param>
/// <param name="e">Event args for the pointer routed event.</param>
private void Target_PointerWheelChanged(object sender, PointerRoutedEventArgs e)
{
    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    PointerPoint ptrPt = e.GetCurrentPoint(Target);

    // Update event log.
    UpdateEventLog("Mouse wheel: " + ptrPt.PointerId);

    // Check if pointer already exists (for example, enter occurred prior to wheel).
    if (!pointers.ContainsKey(ptrPt.PointerId))
    {
        // Add contact to dictionary.
        pointers[ptrPt.PointerId] = e.Pointer;
    }

    // Display pointer details.
    CreateInfoPop(ptrPt);
}
  • Questo gestore gestisce l'evento PointerReleased nel punto in cui termina il contatto con il digitalizzatore. Si aggiunge l'evento al registro eventi, si rimuove il puntatore dalla raccolta di puntatori e si aggiornano i dettagli del puntatore.
/// <summary>
/// The pointer released event handler.
/// PointerPressed and PointerReleased don't always occur in pairs. 
/// Your app should listen for and handle any event that can conclude 
/// a pointer down (PointerExited, PointerCanceled, PointerCaptureLost).
/// </summary>
/// <param name="sender">Source of the pointer event.</param>
/// <param name="e">Event args for the pointer routed event.</param>
void Target_PointerReleased(object sender, PointerRoutedEventArgs e)
{
    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    PointerPoint ptrPt = e.GetCurrentPoint(Target);

    // Update event log.
    UpdateEventLog("Up: " + ptrPt.PointerId);

    // If event source is mouse or touchpad and the pointer is still 
    // over the target, retain pointer and pointer details.
    // Return without removing pointer from pointers dictionary.
    // For this example, we assume a maximum of one mouse pointer.
    if (ptrPt.PointerDevice.PointerDeviceType != Windows.Devices.Input.PointerDeviceType.Mouse)
    {
        // Update target UI.
        Target.Fill = new SolidColorBrush(Windows.UI.Colors.Red);

        DestroyInfoPop(ptrPt);

        // Remove contact from dictionary.
        if (pointers.ContainsKey(ptrPt.PointerId))
        {
            pointers[ptrPt.PointerId] = null;
            pointers.Remove(ptrPt.PointerId);
        }

        // Release the pointer from the target.
        Target.ReleasePointerCapture(e.Pointer);

        // Update event log.
        UpdateEventLog("Pointer released: " + ptrPt.PointerId);
    }
    else
    {
        Target.Fill = new SolidColorBrush(Windows.UI.Colors.Blue);
    }
}
  • Questo gestore gestisce l'evento PointerExited (quando viene mantenuto il contatto con il digitalizzatore). Si aggiunge l'evento al registro eventi, si rimuove il puntatore dalla matrice di puntatori e si aggiornano i dettagli del puntatore.
/// <summary>
/// The pointer exited event handler.
/// </summary>
/// <param name="sender">Source of the pointer event.</param>
/// <param name="e">Event args for the pointer routed event.</param>
private void Target_PointerExited(object sender, PointerRoutedEventArgs e)
{
    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    PointerPoint ptrPt = e.GetCurrentPoint(Target);

    // Update event log.
    UpdateEventLog("Pointer exited: " + ptrPt.PointerId);

    // Remove contact from dictionary.
    if (pointers.ContainsKey(ptrPt.PointerId))
    {
        pointers[ptrPt.PointerId] = null;
        pointers.Remove(ptrPt.PointerId);
    }

    if (pointers.Count == 0)
    {
        Target.Fill = new SolidColorBrush(Windows.UI.Colors.Red);
    }

    // Update the UI and pointer details.
    DestroyInfoPop(ptrPt);
}
  • Questo gestore gestisce l'evento PointerCanceled. Si aggiunge l'evento al registro eventi, si rimuove il puntatore dalla matrice di puntatori e si aggiornano i dettagli del puntatore.
/// <summary>
/// The pointer canceled event handler.
/// Fires for various reasons, including: 
///    - Touch contact canceled by pen coming into range of the surface.
///    - The device doesn't report an active contact for more than 100ms.
///    - The desktop is locked or the user logged off. 
///    - The number of simultaneous contacts exceeded the number supported by the device.
/// </summary>
/// <param name="sender">Source of the pointer event.</param>
/// <param name="e">Event args for the pointer routed event.</param>
private void Target_PointerCanceled(object sender, PointerRoutedEventArgs e)
{
    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    PointerPoint ptrPt = e.GetCurrentPoint(Target);

    // Update event log.
    UpdateEventLog("Pointer canceled: " + ptrPt.PointerId);

    // Remove contact from dictionary.
    if (pointers.ContainsKey(ptrPt.PointerId))
    {
        pointers[ptrPt.PointerId] = null;
        pointers.Remove(ptrPt.PointerId);
    }

    if (pointers.Count == 0)
    {
        Target.Fill = new SolidColorBrush(Windows.UI.Colors.Black);
    }

    DestroyInfoPop(ptrPt);
}
  • Questo gestore gestisce l'evento PointerCaptureLost. Si aggiunge l'evento al registro eventi, si rimuove il puntatore dalla matrice di puntatori e si aggiornano i dettagli del puntatore.

    Nota

    PointerCaptureLost può verificarsi al posto di PointerReleased. L'acquisizione del puntatore può andare persa per vari motivi, tra cui interazione utente, acquisizione a livello di codice di un altro puntato e chiamata a PointerReleased.  

/// <summary>
/// The pointer capture lost event handler.
/// Fires for various reasons, including: 
///    - User interactions
///    - Programmatic capture of another pointer
///    - Captured pointer was deliberately released
// PointerCaptureLost can fire instead of PointerReleased. 
/// </summary>
/// <param name="sender">Source of the pointer event.</param>
/// <param name="e">Event args for the pointer routed event.</param>
private void Target_PointerCaptureLost(object sender, PointerRoutedEventArgs e)
{
    // Prevent most handlers along the event route from handling the same event again.
    e.Handled = true;

    PointerPoint ptrPt = e.GetCurrentPoint(Target);

    // Update event log.
    UpdateEventLog("Pointer capture lost: " + ptrPt.PointerId);

    if (pointers.Count == 0)
    {
        Target.Fill = new SolidColorBrush(Windows.UI.Colors.Black);
    }

    // Remove contact from dictionary.
    if (pointers.ContainsKey(ptrPt.PointerId))
    {
        pointers[ptrPt.PointerId] = null;
        pointers.Remove(ptrPt.PointerId);
    }

    DestroyInfoPop(ptrPt);
}

Ottenere le proprietà del puntatore

Come detto in precedenza, è necessario ottenere il puntatore più esteso da un oggetto Windows.UI.Input.PointerPoint ottenuto attraverso i metodi GetCurrentPoint e GetIntermediatePoints di PointerRoutedEventArgs. I frammenti di codice seguenti mostrano come.

  • Innanzitutto, si crea un nuovo oggetto TextBlock per ogni puntatore.
/// <summary>
/// Create the pointer info popup.
/// </summary>
/// <param name="ptrPt">Reference to the input pointer.</param>
void CreateInfoPop(PointerPoint ptrPt)
{
    TextBlock pointerDetails = new TextBlock();
    pointerDetails.Name = ptrPt.PointerId.ToString();
    pointerDetails.Foreground = new SolidColorBrush(Windows.UI.Colors.White);
    pointerDetails.Text = QueryPointer(ptrPt);

    TranslateTransform x = new TranslateTransform();
    x.X = ptrPt.Position.X + 20;
    x.Y = ptrPt.Position.Y + 20;
    pointerDetails.RenderTransform = x;

    Container.Children.Add(pointerDetails);
}
  • Si fornisce quindi un modo per aggiornare le informazioni sul puntatore in un oggetto TextBlock esistente associato a quel puntatore.
/// <summary>
/// Update the pointer info popup.
/// </summary>
/// <param name="ptrPt">Reference to the input pointer.</param>
void UpdateInfoPop(PointerPoint ptrPt)
{
    foreach (var pointerDetails in Container.Children)
    {
        if (pointerDetails.GetType().ToString() == "Windows.UI.Xaml.Controls.TextBlock")
        {
            TextBlock textBlock = (TextBlock)pointerDetails;
            if (textBlock.Name == ptrPt.PointerId.ToString())
            {
                // To get pointer location details, we need extended pointer info.
                // We get the pointer info through the getCurrentPoint method
                // of the event argument. 
                TranslateTransform x = new TranslateTransform();
                x.X = ptrPt.Position.X + 20;
                x.Y = ptrPt.Position.Y + 20;
                pointerDetails.RenderTransform = x;
                textBlock.Text = QueryPointer(ptrPt);
            }
        }
    }
}
  • Infine, si eseguono query su varie proprietà del puntatore.
/// <summary>
/// Get pointer details.
/// </summary>
/// <param name="ptrPt">Reference to the input pointer.</param>
/// <returns>A string composed of pointer details.</returns>
String QueryPointer(PointerPoint ptrPt)
{
    String details = "";

    switch (ptrPt.PointerDevice.PointerDeviceType)
    {
        case Windows.Devices.Input.PointerDeviceType.Mouse:
            details += "\nPointer type: mouse";
            break;
        case Windows.Devices.Input.PointerDeviceType.Pen:
            details += "\nPointer type: pen";
            if (ptrPt.IsInContact)
            {
                details += "\nPressure: " + ptrPt.Properties.Pressure;
                details += "\nrotation: " + ptrPt.Properties.Orientation;
                details += "\nTilt X: " + ptrPt.Properties.XTilt;
                details += "\nTilt Y: " + ptrPt.Properties.YTilt;
                details += "\nBarrel button pressed: " + ptrPt.Properties.IsBarrelButtonPressed;
            }
            break;
        case Windows.Devices.Input.PointerDeviceType.Touch:
            details += "\nPointer type: touch";
            details += "\nrotation: " + ptrPt.Properties.Orientation;
            details += "\nTilt X: " + ptrPt.Properties.XTilt;
            details += "\nTilt Y: " + ptrPt.Properties.YTilt;
            break;
        default:
            details += "\nPointer type: n/a";
            break;
    }

    GeneralTransform gt = Target.TransformToVisual(this);
    Point screenPoint;

    screenPoint = gt.TransformPoint(new Point(ptrPt.Position.X, ptrPt.Position.Y));
    details += "\nPointer Id: " + ptrPt.PointerId.ToString() +
        "\nPointer location (target): " + Math.Round(ptrPt.Position.X) + ", " + Math.Round(ptrPt.Position.Y) +
        "\nPointer location (container): " + Math.Round(screenPoint.X) + ", " + Math.Round(screenPoint.Y);

    return details;
}

Puntatore primario

Alcuni dispositivi di input, ad esempio un digitalizzatore tocco o un touchpad, non supportano solo il tipico puntatore di un mouse o di una penna (nella maggior parte dei casi perché Surface Hub supporta due input penna).

Usare la proprietà IsPrimary di sola lettura della classe PointerPointerProperties per identificare e distingure un singolo puntatore primario (il puntatore primario è sempre il primo puntatore rilevato durante una sequenza di input).

Identificando il puntatore primario, è possibile usarlo per emulare l'input del mouse o della penna, personalizzare le interazioni o fornire altre funzionalità o interfaccia utente specifiche.

Nota

Se il puntatore primario viene rilasciato, annullato o perso durante una sequenza di input, un puntatore di input primario non viene creato finché non viene avviata una nuova sequenza di input (una sequenza di input termina quando tutti i puntatori sono stati rilasciati, annullati o persi).

Esempio di animazione del puntatore primario

Questi frammenti di codice mostrano come fornire un feedback visivo speciale per consentire a un utente di distinguere tra gli input del puntatore nell'applicazione.

Questa particolare app usa sia il colore sia l'animazione per evidenziare il puntatore primario.

Applicazione puntatore con feedback visivo animato

Scaricare questo esempio dall'esempio di input del puntatore (UserControl con animazione)

Feedback visivo

Si definisce un UserControl, basato su un oggetto Ellipse XAML che evidenzia il punto in cui si trova ogni puntatore sull'area di disegno e usa un oggetto Storyboard per animare l'ellisse corrispondente al puntatore primario.

Ecco l'oggetto XAML:

<UserControl
    x:Class="UWP_Pointers.PointerEllipse"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:UWP_Pointers"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d"
    d:DesignHeight="100"
    d:DesignWidth="100">

    <UserControl.Resources>
        <Style x:Key="EllipseStyle" TargetType="Ellipse">
            <Setter Property="Transitions">
                <Setter.Value>
                    <TransitionCollection>
                        <ContentThemeTransition/>
                    </TransitionCollection>
                </Setter.Value>
            </Setter>
        </Style>
        
        <Storyboard x:Name="myStoryboard">
            <!-- Animates the value of a Double property between 
            two target values using linear interpolation over the 
            specified Duration. -->
            <DoubleAnimation
              Storyboard.TargetName="ellipse"
              Storyboard.TargetProperty="(RenderTransform).(ScaleTransform.ScaleY)"  
              Duration="0:0:1" 
              AutoReverse="True" 
              RepeatBehavior="Forever" From="1.0" To="1.4">
            </DoubleAnimation>

            <!-- Animates the value of a Double property between 
            two target values using linear interpolation over the 
            specified Duration. -->
            <DoubleAnimation
              Storyboard.TargetName="ellipse"
              Storyboard.TargetProperty="(RenderTransform).(ScaleTransform.ScaleX)"  
              Duration="0:0:1" 
              AutoReverse="True" 
              RepeatBehavior="Forever" From="1.0" To="1.4">
            </DoubleAnimation>

            <!-- Animates the value of a Color property between 
            two target values using linear interpolation over the 
            specified Duration. -->
            <ColorAnimation 
                Storyboard.TargetName="ellipse" 
                EnableDependentAnimation="True" 
                Storyboard.TargetProperty="(Fill).(SolidColorBrush.Color)" 
                From="White" To="Red"  Duration="0:0:1" 
                AutoReverse="True" RepeatBehavior="Forever"/>
        </Storyboard>
    </UserControl.Resources>

    <Grid x:Name="CompositionContainer">
        <Ellipse Name="ellipse" 
        StrokeThickness="2" 
        Width="{x:Bind Diameter}" 
        Height="{x:Bind Diameter}"  
        Style="{StaticResource EllipseStyle}" />
    </Grid>
</UserControl>

Ecco il code-behind:

using Windows.Foundation;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Media;

// The User Control item template is documented at 
// https://go.microsoft.com/fwlink/?LinkId=234236

namespace UWP_Pointers
{
    /// <summary>
    /// Pointer feedback object.
    /// </summary>
    public sealed partial class PointerEllipse : UserControl
    {
        // Reference to the application canvas.
        Canvas canvas;

        /// <summary>
        /// Ellipse UI for pointer feedback.
        /// </summary>
        /// <param name="c">The drawing canvas.</param>
        public PointerEllipse(Canvas c)
        {
            this.InitializeComponent();
            canvas = c;
        }

        /// <summary>
        /// Gets or sets the pointer Id to associate with the PointerEllipse object.
        /// </summary>
        public uint PointerId
        {
            get { return (uint)GetValue(PointerIdProperty); }
            set { SetValue(PointerIdProperty, value); }
        }
        // Using a DependencyProperty as the backing store for PointerId.  
        // This enables animation, styling, binding, etc...
        public static readonly DependencyProperty PointerIdProperty =
            DependencyProperty.Register("PointerId", typeof(uint), 
                typeof(PointerEllipse), new PropertyMetadata(null));


        /// <summary>
        /// Gets or sets whether the associated pointer is Primary.
        /// </summary>
        public bool PrimaryPointer
        {
            get { return (bool)GetValue(PrimaryPointerProperty); }
            set
            {
                SetValue(PrimaryPointerProperty, value);
            }
        }
        // Using a DependencyProperty as the backing store for PrimaryPointer.  
        // This enables animation, styling, binding, etc...
        public static readonly DependencyProperty PrimaryPointerProperty =
            DependencyProperty.Register("PrimaryPointer", typeof(bool), 
                typeof(PointerEllipse), new PropertyMetadata(false));


        /// <summary>
        /// Gets or sets the ellipse style based on whether the pointer is Primary.
        /// </summary>
        public bool PrimaryEllipse 
        {
            get { return (bool)GetValue(PrimaryEllipseProperty); }
            set
            {
                SetValue(PrimaryEllipseProperty, value);
                if (value)
                {
                    SolidColorBrush fillBrush = 
                        (SolidColorBrush)Application.Current.Resources["PrimaryFillBrush"];
                    SolidColorBrush strokeBrush = 
                        (SolidColorBrush)Application.Current.Resources["PrimaryStrokeBrush"];

                    ellipse.Fill = fillBrush;
                    ellipse.Stroke = strokeBrush;
                    ellipse.RenderTransform = new CompositeTransform();
                    ellipse.RenderTransformOrigin = new Point(.5, .5);
                    myStoryboard.Begin();
                }
                else
                {
                    SolidColorBrush fillBrush = 
                        (SolidColorBrush)Application.Current.Resources["SecondaryFillBrush"];
                    SolidColorBrush strokeBrush = 
                        (SolidColorBrush)Application.Current.Resources["SecondaryStrokeBrush"];
                    ellipse.Fill = fillBrush;
                    ellipse.Stroke = strokeBrush;
                }
            }
        }
        // Using a DependencyProperty as the backing store for PrimaryEllipse.  
        // This enables animation, styling, binding, etc...
        public static readonly DependencyProperty PrimaryEllipseProperty =
            DependencyProperty.Register("PrimaryEllipse", 
                typeof(bool), typeof(PointerEllipse), new PropertyMetadata(false));


        /// <summary>
        /// Gets or sets the diameter of the PointerEllipse object.
        /// </summary>
        public int Diameter
        {
            get { return (int)GetValue(DiameterProperty); }
            set { SetValue(DiameterProperty, value); }
        }
        // Using a DependencyProperty as the backing store for Diameter.  This enables animation, styling, binding, etc...
        public static readonly DependencyProperty DiameterProperty =
            DependencyProperty.Register("Diameter", typeof(int), 
                typeof(PointerEllipse), new PropertyMetadata(120));
    }
}

Creare l'interfaccia utente

L'interfaccia utente in questo esempio è limitata all'area di disegno dell'input in cui si rilevano i puntatori e si esegue il rendering degli indicatori dei puntatori e dell'animazione primaria (se applicabile), insieme a una barra di intestazione contenente un contatore di puntatori e un identificatore di puntatore primario.

Ecco MainPage.xaml:

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Grid.RowDefinitions>
        <RowDefinition Height="Auto"/>
        <RowDefinition Height="*"/>
    </Grid.RowDefinitions>
    <StackPanel x:Name="HeaderPanel" 
                Orientation="Horizontal" 
                Grid.Row="0">
        <StackPanel.Transitions>
            <TransitionCollection>
                <AddDeleteThemeTransition/>
            </TransitionCollection>
        </StackPanel.Transitions>
        <TextBlock x:Name="Header" 
                    Text="Basic pointer tracking sample - IsPrimary" 
                    Style="{ThemeResource HeaderTextBlockStyle}" 
                    Margin="10,0,0,0" />
        <TextBlock x:Name="PointerCounterLabel"
                    VerticalAlignment="Center"                 
                    Style="{ThemeResource BodyTextBlockStyle}"
                    Text="Number of pointers: " 
                    Margin="50,0,0,0"/>
        <TextBlock x:Name="PointerCounter"
                    VerticalAlignment="Center"                 
                    Style="{ThemeResource BodyTextBlockStyle}"
                    Text="0" 
                    Margin="10,0,0,0"/>
        <TextBlock x:Name="PointerPrimaryLabel"
                    VerticalAlignment="Center"                 
                    Style="{ThemeResource BodyTextBlockStyle}"
                    Text="Primary: " 
                    Margin="50,0,0,0"/>
        <TextBlock x:Name="PointerPrimary"
                    VerticalAlignment="Center"                 
                    Style="{ThemeResource BodyTextBlockStyle}"
                    Text="n/a" 
                    Margin="10,0,0,0"/>
    </StackPanel>
    
    <Grid Grid.Row="1">
        <!--The canvas where we render the pointer UI.-->
        <Canvas x:Name="pointerCanvas"/>
    </Grid>
</Grid>

Gestire gli eventi del puntatore

Infine, si definiscono i gestori degli eventi del puntatore di base nel code-behind MainPage.xaml.cs. Qui non si riprodurrà il codice perché i concetti di base sono stati trattati nell'esempio precedente, tuttavia è possibile scaricare l'esempio di lavoro dall'esempio di input del puntatore (UserControl con animazione).

Esempi di argomento

Altri esempi

Esempi di archivio