PointHitTestResult.VisualHit Eigenschaft

Definition

Ruft das visuelle Objekt ab, das aus einem Treffertestergebnis zurückgegeben wird.

public:
 property System::Windows::Media::Visual ^ VisualHit { System::Windows::Media::Visual ^ get(); };
public System.Windows.Media.Visual VisualHit { get; }
member this.VisualHit : System.Windows.Media.Visual
Public ReadOnly Property VisualHit As Visual

Eigenschaftswert

Ein Visual Objekt, das das Treffertestergebnis darstellt.

Beispiele

Das folgende Beispiel zeigt, wie Sie auf die VisualHit Eigenschaft in einer Rückruffunktion für Treffertestergebnisse zugreifen.

// Return the result of the hit test to the callback.
public HitTestResultBehavior MyHitTestResult(HitTestResult result)
{
    // Add the hit test result to the list that will be processed after the enumeration.
    hitResultsList.Add(result.VisualHit);

    // Set the behavior to return visuals at all z-order levels.
    return HitTestResultBehavior.Continue;
}
' Return the result of the hit test to the callback.
Public Function MyHitTestResult(ByVal result As HitTestResult) As HitTestResultBehavior
    ' Add the hit test result to the list that will be processed after the enumeration.
    hitResultsList.Add(result.VisualHit)

    ' Set the behavior to return visuals at all z-order levels.
    Return HitTestResultBehavior.Continue
End Function

Hinweise

Der VisualHit Wert kann während eines einzelnen Treffertests potenziell mehrere visuelle Objekte darstellen. Die Treffertest-Rückrufmethode definiert die Aktionen, die ausgeführt werden, wenn ein Treffertest für ein bestimmtes visuelles Objekt in der visuellen Struktur identifiziert wird. Nachdem Sie die Aktionen ausgeführt haben, geben Sie einen HitTestResultBehavior Wert zurück, der bestimmt, ob die Enumeration anderer visueller Objekte fortgesetzt werden soll. Die Reihenfolge der Aufzählung der zurückgegebenen visuellen Objekte entspricht der Z-Reihenfolge auf der Renderingebene.

Gilt für: