UIElement.IsMouseOver プロパティ

定義

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

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

プロパティ値

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

実装

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

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

注釈

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

類似した "IsMouseOverChanged" イベントは存在しませんが、同様のイベントがいくつか存在します。 たとえば、 MouseEnterMouseMoveIsMouseDirectlyOverChangedを処理できます。

この要素がマウスをキャプチャする場合、マウス キャプチャが失われ、マウス ポインターが要素の境界を離れるまで、このプロパティは true 残ります。

一部のコントロールでは、マウスが直接関係しているようには見えない特定のアクションで、マウスを意図的にキャプチャします。 これにより、マウスが明らかに移動していないにもかかわらず、 IsMouseOvertrue される可能性があります。

依存関係プロパティ情報

品目 価値
識別子フィールド IsMouseOverProperty
に設定されたメタデータ プロパティ true None

適用対象