UIElement.IsMouseOver プロパティ

定義

マウス ポインターがこの要素 (ビジュアル ツリー内の子要素を含む) の上にあるかどうかを示す値を取得します。 これは依存関係プロパティです。

public:
 property bool IsMouseOver { bool get(); };
public bool IsMouseOver { get; }
member this.IsMouseOver : bool
Public ReadOnly Property IsMouseOver As Boolean

プロパティ値

Boolean

マウス ポインターが要素またはその子要素の上にある場合は true、それ以外の場合は false。 既定値は、false です。

実装

次の例では、ブロックの一部であるのプロパティの型として、このプロパティを参照して Trigger <Style.Triggers> います。 マウスがコントロールの上にある場合は、コントロールのテキストが青に変わり、カーソルが手の形になります。

<Trigger Property="IsMouseOver" Value="true">
  <Setter Property="Foreground" Value="Blue" />
  <Setter Property="Cursor" Value="Hand"/>
</Trigger>

注釈

通常、コントロールは複合コントロールであり、コントロール内のさまざまな要素 (ビジュアルツリー) は、格納しているコントロールのマウス状態をすべて報告します。 たとえば、 ListBox スタイルコントロールは、マウスが任意のジオメトリの上にあるかのように報告し IsMouseOver true ListBoxItem ます。

似た "IsMouseOverChanged" イベントは存在しませんが、いくつかの類似イベントがあります。 たとえば、、、およびを処理でき MouseEnter MouseMove IsMouseDirectlyOverChanged ます。

この要素がマウスをキャプチャすると、マウスの true キャプチャが失われ、マウスポインターが要素の境界内から出るまで、このプロパティは保持されます。

一部のコントロールでは、マウスを直接操作しないように見えない特定のアクションに対して、意図的にマウスをキャプチャしています。 これにより IsMouseOver true 、マウスが見えなくなっても、が発生する可能性があります。

依存プロパティ情報

識別子フィールド IsMouseOverProperty
メタデータプロパティがに設定される true なし

適用対象