UIElement.IsMouseOver プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
マウス ポインターがこの要素の上に配置されているかどうかを示す値を取得します (ビジュアル ツリー内の子要素を含む)。 これは依存関係プロパティです。
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" イベントは存在しませんが、同様のイベントがいくつか存在します。 たとえば、 MouseEnter、 MouseMove、 IsMouseDirectlyOverChangedを処理できます。
この要素がマウスをキャプチャする場合、マウス キャプチャが失われ、マウス ポインターが要素の境界を離れるまで、このプロパティは true 残ります。
一部のコントロールでは、マウスが直接関係しているようには見えない特定のアクションで、マウスを意図的にキャプチャします。 これにより、マウスが明らかに移動していないにもかかわらず、 IsMouseOver が true される可能性があります。
依存関係プロパティ情報
| 品目 | 価値 |
|---|---|
| 識別子フィールド | IsMouseOverProperty |
に設定されたメタデータ プロパティ true |
None |