Informazioni
L'argomento richiesto è visualizzato di seguito, ma non è incluso in questa libreria.

Evento UIElement.MouseLeave

Si verifica quando il puntatore del mouse viene spostato all'esterno dei limiti dell'elemento.

Spazio dei nomi:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)
XMLNS per XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public event MouseEventHandler MouseLeave
<object MouseLeave="MouseEventHandler" .../>

Implementa

IInputElement.MouseLeave

Campo dell'identificatore

MouseLeaveEvent

Strategia di routing

Diretta

Delegato

MouseEventHandler

  • Eseguire l'override di OnMouseLeave per implementare la gestione della classe per questo evento nelle classi derivate.

MouseLeave è un evento indirizzato che utilizza la strategia di routing della gestione degli eventi diretta. Gli eventi indirizzati diretti non vengono generati lungo una route bensì sono gestiti nello stesso elemento nel quale vengono generati. Consentono, tuttavia, altri aspetti del comportamento dell'evento indirizzato, ad esempio trigger di evento negli stili.

Sebbene MouseLeave rilevi il momento in cui il puntatore del mouse esce dai limiti di un elemento, più letteralmente questo evento indica che il valore della proprietà IsMouseOver è cambiato da true a false per questo elemento.

Questo evento crea un alias per l'evento associato Mouse.MouseLeave per questa classe, di modo che MouseLeave faccia parte dell'elenco dei membri della classe quando UIElement viene ereditato come elemento di base. I gestori eventi associati all'evento MouseLeave sono associati all'evento Mouse.MouseLeave sottostante e ricevono la stessa istanza dei dati dell'evento.

In questo esempio viene illustrato come modificare il colore di un elemento quando il puntatore del mouse entra o esce dall’area occupata dall'elemento.

In questo esempio sono presenti un file Extensible Application Markup Language (XAML) e un file code-behind.

NotaNota

In questo esempio viene illustrato come utilizzare gli eventi, ma la modalità consigliata per ottenere lo stesso effetto è utilizzare Trigger in un stile. Per ulteriori informazioni, vedere Applicazione di stili e modelli.

Nel XAML riportato di seguito viene creata l’interfaccia utente, composta da Border intorno a TextBlock e vengono collegati i gestori eventi MouseEnter e MouseLeave a Border.


<StackPanel>
  <Border MouseEnter="OnMouseEnterHandler"
          MouseLeave="OnMouseLeaveHandler"
          Name="border1" Margin="10"
          BorderThickness="1"
          BorderBrush="Black"
          VerticalAlignment="Center"
          Width="300" Height="100">
    <Label Margin="10" FontSize="14"
           HorizontalAlignment="Center">Move Cursor Over Me</Label>
  </Border>
</StackPanel>


Nell’esempio di code-behind riportato di seguito vengono creati i gestori eventi MouseEnter e MouseLeave. Quando il puntatore del mouse entra in Border, lo sfondo di Border diventa rosso. Quando il puntatore del mouse esce da Border, lo sfondo di Border ritorna bianco.


public partial class Window1 : Window
{
    public Window1()
    {
        InitializeComponent();
    }

    // raised when mouse cursor enters the area occupied by the element
    void OnMouseEnterHandler(object sender, MouseEventArgs e)
    {
        border1.Background = Brushes.Red;
    }

    // raised when mouse cursor leaves the area occupied by the element
    void OnMouseLeaveHandler(object sender, MouseEventArgs e)
    {
        border1.Background = Brushes.White;
    }
}


.NET Framework

Supportato in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

Mostra:
© 2014 Microsoft