TextRange_GetText-Funktion (uiautomationcoreapi.h)

  • Artikel
Hinweis Diese Funktion ist veraltet. Clientanwendungen sollten stattdessen die Microsoft Benutzeroberflächenautomatisierung COM-Schnittstellen (Component Object Model) verwenden.
 
Gibt den Text in einem Textbereich bis zu einer angegebenen Anzahl von Zeichen zurück.

Syntax

HRESULT TextRange_GetText(
  [in]  HUIATEXTRANGE hobj,
  [in]  int           maxLength,
  [out] BSTR          *pRetVal
);

Parameter

[in] hobj

Typ: HUIATEXTRANGE

Ein Textbereichsobjekt.

[in] maxLength

Typ: int

Die Anzahl der zurückzugebenden Zeichen, beginnend mit dem Zeichen am Anfangsendpunkt des Textbereichs.

[out] pRetVal

Typ: BSTR*

Wenn diese Funktion zurückgibt, enthält dieser Parameter einen Zeiger auf den zurückgegebenen Text. Dieser Parameter wird nicht initialisiert übergeben.

Rückgabewert

Typ: HRESULT

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

Hinweise

Wenn maxLength -1 ist, wird der gesamte Text innerhalb des Textbereichs zurückgegeben. Wenn maxLength größer als die Länge des Textbereichs ist, enthält die zurückgegebene Zeichenfolge den gesamten Text im Textbereich.

Anforderungen

Anforderung Wert
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