다음을 통해 공유


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.Triggers 블록의 일부인 의 Trigger속성 형식으로 <참조합니다> . 마우스가 컨트롤 위에 있으면 컨트롤 텍스트가 파란색으로 바뀌고 커서가 손이 됩니다.

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

설명

일반적으로 컨트롤 내의 다양한 요소(시각적 트리)가 모두 포함하는 컨트롤의 마우스 상태를 보고할 수 있도록 컨트롤이 합성됩니다. 예를 들어 ListBox 스타일 컨트롤은 마우스가 을 포함하여 ListBoxItem기하 도형 위에 있는 것처럼 true 보고 IsMouseOver 합니다.

유사한 "IsMouseOverChanged" 이벤트가 존재하지 않지만 몇 가지 유사한 이벤트가 있습니다. 예를 들어 , 및 IsMouseDirectlyOverChangedMouseMove처리MouseEnter할 수 있습니다.

이 요소가 마우스를 캡처하는 경우 이 속성은 마우스 캡처가 손실되고 마우스 포인터가 요소 경계를 떠날 때까지 유지 true 됩니다.

일부 컨트롤은 마우스를 직접 포함하지 않는 특정 작업에서 마우스를 의도적으로 캡처합니다. 이것은 마우스가 IsMouseOver 분명히 움직이지 않더라도 될 true 수 있습니다.

종속성 속성 정보

식별자 필드 IsMouseOverProperty
메타 데이터 속성 설정 true 없음

적용 대상