UIElement.IsHitTestVisible Właściwość

Definicja

Pobiera lub ustawia wartość określającą, czy ten element może być zwracany jako wynik testu trafień z pewnej części zawartości renderowanej.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. Jest to właściwość zależności.This is a dependency property.

public:
 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

Wartość właściwości

Boolean

true Jeśli ten element może zostać zwrócony jako wynik testu trafień z co najmniej jednego punktu; w przeciwnym razie false .true if this element could be returned as a hit test result from at least one point; otherwise, false. Wartość domyślna to true.The default value is true.

Uwagi

Wartość efektywna tej właściwości ma wpływ względne położenie elementów weryfikowalne trafień w drzewie logicznym.The effective value of this property is influenced by the relative positions of hit testable elements in the logical tree. Na przykład jeśli element jest elementem podrzędnym elementu, który nie jest widoczny dla testu, wartość skuteczna właściwości w elemencie podrzędnym pozostanie false , nawet jeśli próbuje ustawić tę wartość lokalnie.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. Z tego powodu ważne jest, aby nie ustawił IsHitTestVisible się false w kontrolce złożonej, chyba że nie ma żadnych testów wejściowych ani trafień na tym formancie.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. Aby uzyskać więcej informacji na temat testowania trafień, zobacz test trafień w warstwie wizualnej.For more information on hit testing, see Hit Testing in the Visual Layer.

Informacje dotyczące właściwości zależnościDependency Property Information

Pole identyfikatoraIdentifier field IsHitTestVisibleProperty
Właściwości metadanych ustawione na trueMetadata properties set to true BrakNone

Dotyczy

Zobacz też