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 |
|---|---|
|
Text ist schreibgeschützt. |
|
bstr ist NULL. |
|
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
Referenz