UIElement.IsMouseOver 속성

정의

마우스 포인터가 이 요소(시각적 트리의 자식 요소 포함) 위에 있는지 여부를 나타내는 값을 가져옵니다.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이고, 없으면 false입니다.true if mouse pointer is over the element or its child elements; otherwise, false. 기본값은 false입니다.The default is false.

구현

예제

다음 예제에서는 <스타일의 일부인 Trigger의 속성 형식으로이 속성을 참조 합니다. 트리거 > 블록.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. 마우스가 컨트롤 위에 있으면 컨트롤 텍스트가 blue로 바뀌고 커서가 손 모양으로 바뀝니다.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 스타일 컨트롤은 ListBoxItem를 포함 하 여 해당 기 하 도형 위에 마우스를 놓았을 경우 true IsMouseOver 보고 합니다.For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

유사한 "Ismouse과잉 변경" 이벤트가 존재 하지 않지만 몇 가지 유사한 이벤트가 발생 합니다.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. 예를 들어 MouseEnter, MouseMoveIsMouseDirectlyOverChanged를 처리할 수 있습니다.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. 이로 인해 마우스가 아직 이동 하지 않은 경우에도 true IsMouseOver 될 수 있습니다.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

적용 대상