TextPattern.RangeFromPoint(Point) Methode

Definition

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

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

Ausnahmen

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.

Gilt für:

Weitere Informationen