GeometryHitTestParameters Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает параметр Geometry , используемый для тестирования визуального дерева.
public ref class GeometryHitTestParameters : System::Windows::Media::HitTestParameters
public class GeometryHitTestParameters : System.Windows.Media.HitTestParameters
type GeometryHitTestParameters = class
inherit HitTestParameters
Public Class GeometryHitTestParameters
Inherits HitTestParameters
- Наследование
Примеры
В следующем примере показано, как настроить тест попадания GeometryHitTestParameters с помощью HitTest метода. Значение Point , переданное OnMouseDown методу, используется для создания Geometry объекта для расширения диапазона теста попадания.
// Respond to the mouse button down event by setting up a hit test results callback.
private void OnMouseDown(object sender, MouseButtonEventArgs e)
{
// Retrieve the coordinate of the mouse position.
Point pt = e.GetPosition((UIElement)sender);
// Expand the hit test area by creating a geometry centered on the hit test point.
EllipseGeometry expandedHitTestArea = new EllipseGeometry(pt, 10.0, 10.0);
// Clear the contents of the list used for hit test results.
hitResultsList.Clear();
// Set up a callback to receive the hit test result enumeration.
VisualTreeHelper.HitTest(myControl, null,
new HitTestResultCallback(MyHitTestResultCallback),
new GeometryHitTestParameters(expandedHitTestArea));
// Perform actions on the hit test results list.
if (hitResultsList.Count > 0)
{
ProcessHitTestResultsList();
}
}
' Respond to the mouse button down event by setting up a hit test results callback.
Private Overloads Sub OnMouseDown(ByVal sender As Object, ByVal e As MouseButtonEventArgs)
' Retrieve the coordinate of the mouse position.
Dim pt As Point = e.GetPosition(CType(sender, UIElement))
' Expand the hit test area by creating a geometry centered on the hit test point.
Dim expandedHitTestArea As New EllipseGeometry(pt, 10.0, 10.0)
' Clear the contents of the list used for hit test results.
hitResultsList.Clear()
' Set up a callback to receive the hit test result enumeration.
VisualTreeHelper.HitTest(myControl, Nothing, New HitTestResultCallback(AddressOf MyHitTestResultCallback), New GeometryHitTestParameters(expandedHitTestArea))
' Perform actions on the hit test results list.
If hitResultsList.Count > 0 Then
ProcessHitTestResultsList()
End If
End Sub
Свойство IntersectionDetail предоставляет сведения о результатах теста попадания GeometryHitTestResult , который используется Geometry в качестве параметра теста попадания. На следующем рисунке показана связь между геометрией теста попадания (синим кругом) и целевым объектом (красным квадратом).
Пересечение между геометрией теста попадания и целевым объектом
Комментарии
GeometryHitTestParameters С помощью класса можно использовать Geometry значение для тестирования попаданий, чтобы определить, пересекается ли любой визуальный объект со значениемGeometry.
Вы также можете получить тест с Point помощью значения, создав PointHitTestParameters объект.
Note
Тестирование попаданий Windows Presentation Foundation (WPF) учитывает только заполненную область геометрии во время теста попадания. Если вы создаете точку Geometry, тест попадания не будет пересекаться ни с чем, так как точка не имеет области.
Конструкторы
| Имя | Описание |
|---|---|
| GeometryHitTestParameters(Geometry) |
Инициализирует новый экземпляр GeometryHitTestParameters класса, используя указанный Geometry. |
Свойства
| Имя | Описание |
|---|---|
| HitGeometry |
Возвращает объект, определяющий Geometry геометрию теста попадания для этого GeometryHitTestParameters экземпляра. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |