エクスポート (0) 印刷
すべて展開
展開 最小化

UIElement.MouseLeave イベント

更新 : 2007 年 11 月

マウス ポインタがこの要素の境界から出たときに発生します。

名前空間 :  System.Windows
アセンブリ :  PresentationCore (PresentationCore.dll 内)
XAML の XMLNS : http://schemas.microsoft.com/winfx/xaml/presentation

public event MouseEventHandler MouseLeave
/** @event */
public final void add_MouseLeave (MouseEventHandler value)
/** @event */
public final void remove_MouseLeave (MouseEventHandler value)

JScript では、イベントは使用できません。
<object MouseLeave="MouseEventHandler" .../>

実装

IInputElement.MouseLeave

識別子フィールド

MouseLeaveEvent

ルーティング方法

直接

デリゲート

MouseEventHandler

  • このイベントのクラス処理を派生クラスに実装するには、OnMouseLeave をオーバーライドします。

MouseLeave は、直接イベント処理ルーティング方法を使用するルーティング イベントです。直接ルーティング イベントはルート上で発生するのではなく、そのイベントが発生した要素で処理されます。ただし、スタイルにおけるイベント トリガなど、ルーティング イベント動作の他の側面は有効にします。

MouseLeave はマウス ポインタがいつ要素の境界から出たかを追跡しますが、このイベントは、この要素で IsMouseOver プロパティが true から false に変化したことをそのまま報告します。

このイベントは、UIElement を基本要素として継承したときに MouseLeave がクラス メンバ リストの一部となるように、このクラスの Mouse.MouseLeave 添付イベントにエイリアスを作成します。MouseLeave イベントにアタッチされたイベント ハンドラは、基になる Mouse.MouseLeave アタッチ済みイベントにアタッチされ、同じイベント データ インスタンスを受け取ります。

この例では、ある要素が占める領域にマウス ポインタが出入りするのに合わせて、要素の色を変更する方法を示します。

この例は、Extensible Application Markup Language (XAML) ファイルと分離コード ファイルで構成されています。サンプル全体については、「マウス ポインタのサンプル」を参照してください。

メモ :

この例ではイベントを使用する方法を示しますが、これと同じ効果を実現するには、スタイルで Trigger を使用する方法が推奨されます。詳細については、「スタイルとテンプレート」を参照してください。

次の XAML は、Border で囲まれた TextBlock で構成されるユーザー インターフェイスを作成し、MouseEnter および MouseLeave イベント ハンドラを 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>


次の分離コードでは、MouseEnter および MouseLeave イベント ハンドラを作成します。マウス ポインタが Border に入ると、Border の背景が赤に変わります。マウス ポインタが Border から出ると、Border の背景は白に戻ります。

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;
    }
}


Windows Vista

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

.NET Framework

サポート対象 : 3.5、3.0

コミュニティの追加

追加
表示:
© 2014 Microsoft