ITextProvider::RangeFromPoint-Methode (uiautomationcore.h)

Artikel
03/06/2024

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

Syntax

HRESULT RangeFromPoint(
  [in]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

Parameter

[in] point

Typ: UiaPoint

Die Position in Bildschirmkoordinaten.

[out, retval] pRetVal

Typ: ITextRangeProvider**

Empfängt einen Zeiger auf den entarteten (leeren) Textbereich, der der angegebenen Position am nächsten liegt. Dieser Parameter wird nicht initialisiert übergeben.

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 einschließt, wird zurückgegeben, wenn sich die Bildschirmkoordinaten innerhalb der Koordinaten eines Bilds, Hyperlinks oder eines anderen eingebetteten Objekts befinden.

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

Die Eigenschaft gibt nie NULL zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcore.h (include UIAutomation.h)