UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver Property

定義

マウス ポインターがこの要素 (ビジュアル ツリー内の子要素を含む) の上にあるかどうかを示す値を取得します。Gets a value indicating whether the mouse pointer is located over this element (including child elements in the visual tree). これは依存関係プロパティです。This is a dependency property.

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

プロパティ値

マウス ポインターが要素またはその子要素の上にある場合は true、それ以外の場合は falsetrue if mouse pointer is over the element or its child elements; otherwise, false. 既定値は、false です。The default is false.

実装

次の例では、このプロパティを参照のプロパティの型として、Triggerの一部である、 <Style.Triggers > ブロックします。The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. マウスがコントロールの上にある場合は、コントロールのテキストが青色になり、カーソルが手の形になります。If the mouse is over the control, the control text turns blue and the cursor becomes a hand.

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

注釈

通常、コントロールは複合ことなど、すべてのコントロール (ビジュアル ツリー) 内のさまざまな要素が格納しているコントロールのマウスの状態が報告されます。Typically, controls are composited such that the various elements inside the control (the visual tree) will all report the mouse state for the containing control. たとえば、ListBoxスタイルのコントロールがレポートされますIsMouseOverとしてtrueの geometry 上にマウスが任意の場所である場合も含めてListBoxItemします。For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

類似の"IsMouseOverChanged"イベントが存在しないがいくつかの類似イベントの操作を行います。Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. たとえば、処理MouseEnterMouseMove、およびIsMouseDirectlyOverChangedします。For example, you can handle MouseEnter, MouseMove, and IsMouseDirectlyOverChanged.

この要素がマウスをキャプチャする場合は、このプロパティの値trueマウス キャプチャが失われ、マウス ポインターが要素の境界を離れるまでです。If this element captures the mouse, this property remains true until mouse capture is lost and the mouse pointer leaves the element bounds.

一部のコントロールは、意図的に、マウスに直接関係しない特定の操作上にマウス ポインターをキャプチャします。Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. これにより、IsMouseOverされるtrueマウスが移動したように見えていない場合でもです。This can lead to IsMouseOver being true even though the mouse has not apparently moved.

依存プロパティ情報Dependency Property Information

識別子フィールドです。Identifier field IsMouseOverProperty
メタデータのプロパティを設定するには trueMetadata properties set to true なしNone

適用対象