Freigeben über


ITextServices::TxGetText-Methode (textserv.h)

Gibt den gesamten Unicode-Nur-Text im -Steuerelement als BSTR zurück.

Syntax

HRESULT TxGetText(
  BSTR *pbstrText
);

Parameter

pbstrText

Typ: BSTR *

Der Unicode-Nur-Text.

Rückgabewert

Typ: HRESULT

Wenn der Text erfolgreich im Ausgabeargument zurückgegeben wird, wird der Rückgabewert S_OK.

Wenn die Methode fehlschlägt, ist der Rückgabewert einer der folgenden HRESULT-Codes . Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode Beschreibung
E_INVALIDARG
Ungültiger BSTR-Zeiger übergeben.
E_OUTOFMEMORY
Der Speicher für die Kopie des Texts konnte nicht zugewiesen werden.

Hinweise

Der Host (Aufrufer) übernimmt den Besitz des zurückgegebenen BSTR.

Andere Möglichkeiten zum Abrufen von Nur-Text-Daten sind die Verwendung WM_GETTEXT oder der TOM-Methode (Text Object Model) GetText.

Wenn kein Text im Steuerelement vorhanden ist, wird der BSTR zugeordnet, und 0x000D wird darin zurückgegeben.

Der zurückgegebene Text ist nicht notwendigerweise null-endend.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile textserv.h
DLL Msftedit.dll

Siehe auch

Konzept

GetText

ITextServices

Andere Ressourcen

Referenz

WM_GETTEXT

Fensterlose Rich-Edit-Steuerelemente