TextPattern.RangeFromPoint(Point) Methode

Definition

Namespace:

System.Windows.Automation

Assembly:

UIAutomationClient.dll

Gibt den degenerierten (leeren) Textbereich zurück, der sich am nächsten an den angegebenen Bildschirmkoordinaten befindet.

public:
 System::Windows::Automation::Text::TextPatternRange ^ RangeFromPoint(System::Windows::Point screenLocation);

public System.Windows.Automation.Text.TextPatternRange RangeFromPoint (System.Windows.Point screenLocation);

member this.RangeFromPoint : System.Windows.Point -> System.Windows.Automation.Text.TextPatternRange

Public Function RangeFromPoint (screenLocation As Point) As TextPatternRange

Parameter

screenLocation

Point

Die Position in Bildschirmkoordinaten.

Gibt zurück

TextPatternRange

Ein degenerierter Bereich, der sich am nächsten an der angegebenen Position befindet. Null wird niemals zurückgegeben.

Ausnahmen

ArgumentException

Ein angegebener Punkt befindet sich außerhalb des dem Textmuster zugeordneten AutomationElement.

Beispiele

private TextPatternRange GetRangeFromPoint()
{
    return targetTextPattern.RangeFromPoint(
        _root.Current.BoundingRectangle.TopLeft);
}

Private Function GetRangeFromPoint() As TextPatternRange
    Return targetTextPattern.RangeFromPoint( _
    _root.Current.BoundingRectangle.TopLeft)
End Function

Hinweise

Ein Textbereich, der ein untergeordnetes Objekt umschließt, wird zurückgegeben, wenn sich die Bildschirmkoordinaten innerhalb der Koordinaten eines Bilds, hyperlinks, Microsoft Excel-Tabellenblatts oder eines anderen eingebetteten Objekts befinden.

Da ausgeblendeter Text nicht von RangeFromPointignoriert wird, wird ein degenerierter Bereich vom sichtbaren Text zurückgegeben, der dem angegebenen Punkt am nächsten ist.

Weitere Informationen

• TextPatternRange