UIElement.IsMouseDirectlyOver 속성

정의

마우스 포인터의 위치가 요소 합치기를 고려한 적중 횟수 테스트 결과와 일치하는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the position of the mouse pointer corresponds to hit test results, which take element compositing into account. 이 속성은 종속성 속성입니다.This is a dependency property.

public:
 property bool IsMouseDirectlyOver { bool get(); };
public bool IsMouseDirectlyOver { get; }
member this.IsMouseDirectlyOver : bool
Public ReadOnly Property IsMouseDirectlyOver As Boolean

속성 값

마우스 포인터가 적중 횟수 테스트와 동일한 요소 결과 위에 있으면true 이고, 없으면 false입니다.true if the mouse pointer is over the same element result as a hit test; otherwise, false. 기본값은 false입니다.The default is false.

구현

설명

IsMouseOver와 달리이 속성은 마우스 포인터가 리터럴 요소 위에 있는 경우 (적중 테스트의 경우)에만 true 됩니다.Unlike IsMouseOver, this property is only true if the mouse pointer is over the literal element - as it is for a hit test. 마우스 포인터가 자식 요소 위에 있는 경우, 특히 요소의 더 깊은 템플릿 및 합성의 일부인 요소에 대해이 속성은 false됩니다.If the mouse pointer is instead over a child element, in particular over elements that are part of an element's deeper template and compositing, this property will be false. 사용자가 정의 하는 컨트롤에 대 한 사용자 지정 컨트롤 템플릿에서이 속성을 사용 하는 등의 방법으로 컨트롤을 합성 하는 방법을 모르는 경우이 속성은 예기치 않은 결과를 반환할 수 있습니다.Unless you know how a control is composited (for example, you use this property in a custom control template for a control that you define), this property might return unexpected results. 컨트롤을 제작 하지 않는 대부분의 시나리오에서는 IsMouseOver를 대신 사용 합니다.For most scenarios where you are not authoring controls, use IsMouseOver instead.

이 요소에서 마우스를 캡처 했을 때이 속성이 캡처 시점에 true 되는 경우에는 마우스 캡처가 손실 되 고 포인터가 범위를 벗어날 때까지이 속성은 계속 해 서 true을 반환 합니다.If the mouse is captured by this element, and this property is true at time of capture, this property will continue to return true until mouse capture is lost and the pointer is not over its bounds.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field IsMouseDirectlyOverProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

적용 대상

추가 정보