語言

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.TriggersTrigger 區塊中 <, 部分的屬性類型>。 如果滑鼠在控制鍵上方,控制文字會變藍色,游標則變成手。

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

備註

通常,控制項會被合成,使得控制項內的各個元素(視覺樹)都會回報包含控制項的滑鼠狀態。 例如,樣ListBox式控制項會報告IsMouseOvertrue滑鼠是否在其幾何體上的任何位置,包括任何 ListBoxItem。

雖然沒有類似的「IsMouseOverchanged」事件,但有幾個類似事件存在。 例如,你可以處理 MouseEnter、 MouseMove和 IsMouseDirectlyOverChanged。

如果這個元素能捕捉滑鼠,這個特性會一直保留 true ,直到捕獲滑鼠遺失且滑鼠指標離開該元素的邊界。

有些控制項會刻意捕捉滑鼠在某些看似不直接涉及滑鼠的動作上。 這可能導致IsMouseOvertrue即使滑鼠表面上沒有移動。

相依財產資訊

Item 價值觀
識別碼欄位 IsMouseOverProperty
元資料屬性設為 true None

適用於