ITextRange2::SetText2-Methode (tom.h)

Artikel
03/13/2024

Legt den Text dieses Bereichs fest.

Syntax

HRESULT SetText2(
  [in] long Flags,
  [in] BSTR bstr
);

Parameter

[in] Flags

Typ: long

Flags steuern, wie der Text in den Bereich eingefügt wird. Das Flag kann einer der folgenden Werte sein:

tomUnicodeBiDi

tomMathCFCheck

tomUnlink

tomUnhide

tomCheckTextLimit

tomLanguageTag

[in] bstr

Typ: BSTR

Der neue Text.

Rückgabewert

Typ: HRESULT

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

Rückgabecode	Beschreibung
E_INVALIDARG	Ungültiges Argument.
E_ACCESSDENIED	Der Schreibzugriff wird verweigert.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Hinweise

Wenn der bstr-ParameterNULL ist, wird der Text im Bereich gelöscht.

Diese Methode ähnelt ITextRange:: SetText. Der Client kann jedoch Flags angeben, die verschiedene Einfügeoptionen steuern, einschließlich des speziellen Flags tomLanguageTag zum Abrufen des BCP-47-Sprachtags für den Bereich. Dies ist ein Branchenstandard-Sprachtag, das ITextFont::SetLanguageID vorzuziehen ist, das einen Sprachcodebezeichner (Language Code Identifier, LCID) verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	tom.h
DLL	Msftedit.dll

Weitere Informationen

ITextRange2

ITextRange2::GetText2

Freigeben über