UIElement.IsHitTestVisible Property


이 요소가 렌더링된 콘텐츠의 일부에서 롤오버 테스트 결과로 반환될 수 있는지 여부를 선언하는 값을 가져오거나 설정합니다.Gets or sets a value that declares whether this element can possibly be returned as a hit test result from some portion of its rendered content. 이 속성은 종속성 속성입니다.This is a dependency property.

 property bool IsHitTestVisible { bool get(); void set(bool value); };
public bool IsHitTestVisible { get; set; }
member this.IsHitTestVisible : bool with get, set
Public Property IsHitTestVisible As Boolean

Property Value


하나 이상의 지점에서 이 요소를 적중 횟수 테스트 결과로 반환할 수 있으면 true이고, 그렇지 않으면 false입니다.true if this element could be returned as a hit test result from at least one point; otherwise, false. 기본값은 true입니다.The default value is true.


이 속성의 유효 값은 논리 트리에서 적중 테스트 가능한 요소의 상대 위치를 받습니다.The effective value of this property is influenced by the relative positions of hit testable elements in the logical tree. 예를 들어, 요소가 적중 테스트를 표시 하지 않는 요소의 자식 요소인 경우 해당 값을 로컬로 설정 하려는 경우에도 자식의 속성 유효 값은 false그대로 유지 됩니다.For instance, if an element is a child element of an element that is not hit test visible, the effective value of the property on the child will remain false, even if attempting to set that value locally. 이러한 이유로 해당 컨트롤에 대 한 입력 또는 적중 테스트를 원하지 않는 경우에는 IsHitTestVisible 설정 하 여 합성 컨트롤에 false 하지 않는 것이 중요 합니다.For this reason, it is important that you do not set IsHitTestVisible to false on a composited control unless you do not want any input or hit testing on that control. 적중 테스트에 대한 자세한 내용은 시각적 계층에서 테스트 적중를 참조하세요.For more information on hit testing, see Hit Testing in the Visual Layer.

종속성 속성 정보Dependency Property Information

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

Applies to

See also