TextPattern_RangeFromPoint-Funktion (uiautomationcoreapi.h)

Artikel
08/26/2023

Hinweis Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die COM-Schnittstellen (Component Object Model) von Microsoft UI Automation verwenden.

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

Syntax

HRESULT TextPattern_RangeFromPoint(
  [in]  HUIAPATTERNOBJECT hobj,
  [in]  UiaPoint          point,
  [out] HUIATEXTRANGE     *pRetVal
);

Parameter

[in] hobj

Typ: HUIAPATTERNOBJECT

Ein Steuerelementmusterobjekt.

[in] point

Typ: HiaPoint

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

[out] pRetVal

Typ: HUIATEXTRANGE*

Wenn diese Funktion zurückgibt, enthält den Textbereich, über den sich der Knoten erstreckt. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn erfolgreich oder andernfalls ein Fehlerwert.

Hinweise

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

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcoreapi.h
Bibliothek	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Freigeben über