ITextProvider::GetSelection-Methode (uiautomationcore.h)

Artikel
08/26/2023

Ruft eine Auflistung von Textbereichen ab, die den aktuell ausgewählten Text in einem textbasierten Steuerelement darstellt.

Syntax

HRESULT GetSelection(
  [out, retval] SAFEARRAY **pRetVal
);

Parameter

[out, retval] pRetVal

Typ: SAFEARRAY**

Empfängt die Adresse eines Arrays von Zeigern auf die ITextRangeProvider-Schnittstellen der Textbereiche, einen für jede ausgewählte Textspanne. 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

Für Benutzeroberflächenautomatisierungsanbieter, die textauswahl unterstützen, sollte der Anbieter diese Methode implementieren und auch einen ITextProvider::SupportedTextSelection-Wert zurückgeben.

Wenn das Steuerelement nur eine einzelne Spanne von ausgewähltem Text enthält, sollte das pRetVal-Array einen einzelnen Textbereich enthalten.

Wenn das Steuerelement eine Texteinfügemarke enthält, aber kein Text ausgewählt ist, sollte das pRetVal-Array einen entarteten (leeren) Textbereich an der Position der Texteinfügemarke enthalten.

Wenn das Steuerelement keinen markierten Text enthält oder das Steuerelement keine Texteinfügemarke enthält, legen Sie pRetVal auf NULL fest.

Anforderungen


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 (uiAutomation.h einschließen)