PointHitTestResult Class

 

Represents the results of a hit test that uses a Point as a hit test parameter.

Namespace:   System.Windows.Media
Assembly:  PresentationCore (in PresentationCore.dll)

System.Object
  System.Windows.Media.HitTestResult
    System.Windows.Media.PointHitTestResult
      System.Windows.Media.AdornerHitTestResult

public class PointHitTestResult : HitTestResult

NameDescription
System_CAPS_pubmethodPointHitTestResult(Visual, Point)

Initializes a new instance of the PointHitTestResult class.

NameDescription
System_CAPS_pubpropertyPointHit

Gets the point value that is returned from a hit test result.

System_CAPS_pubpropertyVisualHit

Gets the visual object that is returned from a hit test result.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

You can also perform a hit test on a visual object by using a Geometry as a hit test parameter and returning the result as a GeometryHitTestResult. For more information, see How to: Hit Test Using Geometry as a Parameter.

The following example shows how to retrieve the PointHitTestResult return value from the HitTest method.

// Respond to the left mouse button down event by initiating the hit test.
private void OnMouseLeftButtonDown(object sender, MouseButtonEventArgs e)
{
    // Retrieve the coordinate of the mouse position.
    Point pt = e.GetPosition((UIElement)sender);

    // Perform the hit test against a given portion of the visual object tree.
    HitTestResult result = VisualTreeHelper.HitTest(myCanvas, pt);

    if (result != null)
    {
        // Perform action on hit visual object.
    }
}

.NET Framework
Available since 3.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: