PointHitTestResult.VisualHit Eigenschaft

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

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

Visual

Ein Visual-Objekt, das das Treffertestergebnis darstellt.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie auf die Eigenschaft in einer Rückruffunktion für den VisualHit Treffertest 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 könnte möglicherweise mehrere visuelle Objekte während eines einzelnen Treffertests 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 Aufzählung anderer visueller Objekte fortgesetzt werden soll. Die Reihenfolge der Aufzählung zurückgegebener visueller Objekte ist durch z-Reihenfolge auf der Renderingebene.