IUIAutomationTextPattern::RangeFromPoint-Methode (uiautomationclient.h)

  • Artikel

Ruft den entarteten (leeren) Textbereich ab, der den angegebenen Bildschirmkoordinaten am nächsten ist.

Syntax

HRESULT RangeFromPoint(
  [in]          POINT                  pt,
  [out, retval] IUIAutomationTextRange **range
);

Parameter

[in] pt

Typ: POINT

Eine Struktur, die die Position in Bildschirmkoordinaten enthält.

[out, retval] range

Typ: IUIAutomationTextRange**

Empfängt einen Zeiger auf den entarteten Textbereich, der der angegebenen Position am nächsten liegt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

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

Da ausgeblendeter Text nicht ignoriert wird, ruft diese Methode einen degenerierten Bereich aus dem sichtbaren Text ab, der den angegebenen Koordinaten am nächsten kommt.

Die Implementierung von RangeFromPoint in Windows Internet Explorer 9 gibt nicht das erwartete Ergebnis zurück. Stattdessen sollten Clients Folgendes ausführen:

  1. Rufen Sie die GetVisibleRanges-Methode auf, um ein Array sichtbarer Textbereiche abzurufen.
  2. Rufen Sie für jeden Textbereich im Array IUIAutomationTextRange::GetBoundingRectangles auf, um die umgebenden Rechtecke abzurufen.
  3. Überprüfen Sie die umgebenden Rechtecke, um den Textbereich zu finden, der die jeweiligen Bildschirmkoordinaten einnimmt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomationTextPattern

Benutzeroberflächenautomatisierung Unterstützung für Textinhalte