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。
實作
範例
以下範例將此屬性視為 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 |