ITextRange::SetText-Methode (tom.h)

Artikel
08/26/2023

Legt den Text in diesem Bereich fest.

Syntax

HRESULT SetText(
  [in] BSTR bstr
);

Parameter

[in] bstr

Typ: BSTR

Text, der den aktuellen Text in diesem Bereich ersetzt. Wenn NULL, wird der aktuelle Text gelöscht.

Rückgabewert

Typ: HRESULT

Die -Methode gibt einen HRESULT-Wert zurück. Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, gibt sie einen der folgenden Fehlercodes zurück. Weitere Informationen zu COM-Fehlercodes finden Sie unter Fehlerbehandlung in COM.

Rückgabecode	BESCHREIBUNG
E_ACCESSDENIED	Text ist schreibgeschützt.
E_INVALIDARG	bstr ist NULL.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

ITextRange::SetText ersetzt den Text im Bereich durch den neuen Text. Im Gegensatz dazu ersetzt TypeText die Auswahl durch den Text bstr und belässt die Auswahl als Einfügemarke, die dem eingefügten Text folgt, genau so, als hätten Sie den Text eingegeben. Informationen zum Benutzeroberflächenauswahlverhalten finden Sie unter TypeText.

Wenn Sie nach dem Aufruf von ITextRange::SetTextITextRange::GetText aufrufen, erhalten Sie denselben Text zurück, den Sie mit der ITextRange::SetText-Methode festgelegt haben (es sei denn, ein anderer Bereich hat diesen Text zwischen den Aufrufen geändert).

Anforderungen


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