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 です。

実装

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

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

注釈

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

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

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

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

依存プロパティ情報

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

適用対象