UIElement.IsHitTestVisible Свойство

Определение

Получение или установка значения, определяющего возможность возврата этого элемента в качестве результата проверки нажатия в какой-либо части его отображаемого содержимого.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.

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

Значение свойства

Значение 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

Применяется к

Дополнительно