Visual.HitTestCore Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, находится ли значение, соответствующее точке или геометрии, в пределах границ визуального объекта.
| HitTestCore(GeometryHitTestParameters) |
Определяет, находится ли значение, соответствующее геометрии, в пределах границ визуального объекта. |
| HitTestCore(PointHitTestParameters) |
Определяет, находится ли значение, соответствующее координате точки, в пределах границ визуального объекта. |
HitTestCore(GeometryHitTestParameters)
Определяет, находится ли значение, соответствующее геометрии, в пределах границ визуального объекта.
protected:
virtual System::Windows::Media::GeometryHitTestResult ^ HitTestCore(System::Windows::Media::GeometryHitTestParameters ^ hitTestParameters);protected virtual System.Windows.Media.GeometryHitTestResult HitTestCore (System.Windows.Media.GeometryHitTestParameters hitTestParameters);abstract member HitTestCore : System.Windows.Media.GeometryHitTestParameters -> System.Windows.Media.GeometryHitTestResult
override this.HitTestCore : System.Windows.Media.GeometryHitTestParameters -> System.Windows.Media.GeometryHitTestResultProtected Overridable Function HitTestCore (hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResultПараметры
- hitTestParameters
- GeometryHitTestParameters
Объект GeometryHitTestParameters, который задает для Geometry проверку нажатия.
Возвращаемое значение
Объект GeometryHitTestResult, представляющий результат проверки нажатия.
Примеры
В следующем примере показано переопределение метода HitTestCore(GeometryHitTestParameters). Одна из причин, по которой может потребоваться переопределить этот метод, — предоставить дополнительные функциональные возможности во время тестирования попадания.
// Override default hit test support in visual object.
protected override GeometryHitTestResult HitTestCore(GeometryHitTestParameters hitTestParameters)
{
IntersectionDetail intersectionDetail = IntersectionDetail.NotCalculated;
// Perform custom actions during the hit test processing.
return new GeometryHitTestResult(this, intersectionDetail);
}
' Override default hit test support in visual object.
Protected Overrides Overloads Function HitTestCore(ByVal hitTestParameters As GeometryHitTestParameters) As GeometryHitTestResult
Dim intersectionDetail As IntersectionDetail = IntersectionDetail.NotCalculated
' Perform custom actions during the hit test processing.
Return New GeometryHitTestResult(Me, intersectionDetail)
End Function
Комментарии
Вы можете переопределить поддержку проверки нажатия по умолчанию для визуального объекта, переопределив HitTestCore метод. Это означает, что при вызове HitTest метода вызывается переопределенная реализация HitTestCore . Переопределенный метод вызывается, когда тест попадания попадает в ограничивающий прямоугольник визуального объекта, даже если координата выходит за пределы геометрии визуального объекта.
Применяется к
HitTestCore(PointHitTestParameters)
Определяет, находится ли значение, соответствующее координате точки, в пределах границ визуального объекта.
protected:
virtual System::Windows::Media::HitTestResult ^ HitTestCore(System::Windows::Media::PointHitTestParameters ^ hitTestParameters);protected virtual System.Windows.Media.HitTestResult HitTestCore (System.Windows.Media.PointHitTestParameters hitTestParameters);abstract member HitTestCore : System.Windows.Media.PointHitTestParameters -> System.Windows.Media.HitTestResult
override this.HitTestCore : System.Windows.Media.PointHitTestParameters -> System.Windows.Media.HitTestResultProtected Overridable Function HitTestCore (hitTestParameters As PointHitTestParameters) As HitTestResultПараметры
- hitTestParameters
- PointHitTestParameters
Объект PointHitTestParameters, который задает для Point проверку нажатия.
Возвращаемое значение
Объект HitTestResult, представляющий объект Visual, возвращенный после проверки нажатия.
Примеры
В следующем примере показано переопределение метода HitTestCore(PointHitTestParameters). Одна из причин, по которой может потребоваться переопределить этот метод, — предоставить дополнительные функциональные возможности во время тестирования попадания.
// Override default hit test support in visual object.
protected override HitTestResult HitTestCore(PointHitTestParameters hitTestParameters)
{
Point pt = hitTestParameters.HitPoint;
// Perform custom actions during the hit test processing,
// which may include verifying that the point actually
// falls within the rendered content of the visual.
// Return hit on bounding rectangle of visual object.
return new PointHitTestResult(this, pt);
}
' Override default hit test support in visual object.
Protected Overrides Overloads Function HitTestCore(ByVal hitTestParameters As PointHitTestParameters) As HitTestResult
Dim pt As Point = hitTestParameters.HitPoint
' Perform custom actions during the hit test processing,
' which may include verifying that the point actually
' falls within the rendered content of the visual.
' Return hit on bounding rectangle of visual object.
Return New PointHitTestResult(Me, pt)
End Function
Комментарии
Вы можете переопределить поддержку тестирования попаданий по умолчанию для визуальных объектов, переопределив HitTestCore метод. Это означает, что при вызове HitTest метода вызывается переопределенная реализация HitTestCore . Переопределенный метод вызывается, когда тест попадания попадает в ограничивающий прямоугольник визуального объекта, даже если координата выходит за пределы геометрии визуального объекта.