ITextProvider::RangeFromPoint-Methode (uiautomationcore.h)
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) |
Siehe auch
Konzept
Referenz
Übersicht über die Benutzeroberflächenautomatisierungs-Anbieter