ITextRange::SetFormattedText-Methode (tom.h)

Artikel
03/13/2024

Legt den formatierten Text dieses Bereichstexts auf den formatierten Text des angegebenen Bereichs fest.

Syntax

HRESULT SetFormattedText(
  [in] ITextRange *pRange
);

Parameter

[in] pRange

Typ: ITextRange*

Der formatierte Text, um den Text dieses Bereichs zu ersetzen.

Rückgabewert

Typ: HRESULT

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 geschützt.
E_INVALIDARG	pRange ist NULL.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Wenn ITextRange nicht zur gleichen TOM-Engine (Text Object Model) gehört, rufen Sie IUnknown::QueryInterface für eine IDataObject-Schnittstelle auf.

Zu den Von IDataObject in der Regel unterstützten Formaten gehören CF_TEXT und CF_RTF. Darüber hinaus können private Formate verwendet werden, um auf die internen Rich-Text-Formate einer Textlösung zu verweisen. Im folgenden Microsoft Visual Basic-Beispiel wird die FormattedText-Eigenschaft verwendet, um den Text in Range2 durch den formatierten Text in Range1 zu ersetzen.

range2.FormattedText = range1.FormattedText

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	tom.h
DLL	Msftedit.dll