ITextServices::TxSetText-Methode (textserv.h)

Artikel
03/02/2024

Legt den gesamten Text im Steuerelement fest.

Syntax

HRESULT TxSetText(
  [in] LPCWSTR pszText
);

Parameter

[in] pszText

Typ: LPCTSTR

Die Zeichenfolge, die den aktuellen Text ersetzt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK.

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

Rückgabecode	Beschreibung
E_FAIL	Text konnte nicht aktualisiert werden.

Hinweise

Diese Methode sollte mit Sorgfalt verwendet werden. Im Wesentlichen wird das Textdienstobjekt mit neuen Daten neu initialisiert. Alle vorherigen Daten und Formatierungsinformationen gehen verloren, einschließlich Informationen zum Rückgängigmachen.

Wenn vorherige Daten in die Zwischenablage kopiert wurden, werden diese Daten vollständig in die Zwischenablage gerendert (über OleFlushClipboard), bevor sie verworfen werden.

Diese Methode unterstützt nichtRückgängig.

Zwei alternative Ansätze zum Festlegen von Text sind WM_SETTEXT und SetText.

Anforderungen

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