Freigeben über


ITextRange::SetText-Methode (tom.h)

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

Siehe auch

Konzept

GetText

ITextRange

Referenz

Textobjektmodell

Typetext