UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver Property

정의

마우스 포인터가 이 요소(시각적 트리의 자식 요소 포함) 위에 있는지 여부를 나타내는 값을 가져옵니다.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의 일부인를 <Style.Triggers > 블록입니다.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. 마우스가 컨트롤, 컨트롤 텍스트가 파란색으로 바뀌고 커서 손 합니다.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 스타일의 컨트롤에서 보고 IsMouseOver 으로 true 마우스가 아무 곳 이나 해당 기 하 도형, 하는 경우 포함 하 여 ListBoxItem입니다.For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

유사한 "IsMouseOverChanged" 이벤트, 존재 하지 않더라도 여러 비슷한 이벤트 수행 합니다.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. 예를 들어 처리할 수 있습니다 MouseEnter하십시오 MouseMove, 및 IsMouseDirectlyOverChanged합니다.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. 이로 인해 발생할 수 있습니다 IsMouseOver 되 고 true 마우스가 분명히 움직인도 합니다.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

적용 대상