ITextSelection::TypeText-Methode (tom.h)

Artikel
03/06/2024

Gibt die von bstr angegebene Zeichenfolge bei dieser Auswahl so ein, als hätte sie jemand eingegeben. Dies ähnelt der zugrunde liegenden SetText-Methode , berücksichtigt jedoch den Schlüsselzustand einfügen/überschreiben und die Benutzeroberflächeneinstellungen wie AutoKorrektur und intelligente Anführungszeichen.

Syntax

HRESULT TypeText(
  BSTR bstr
);

Parameter

bstr

Typ: BSTR

Zeichenfolge zum Eingeben in diese Auswahl.

Rückgabewert

Typ: HRESULT

Die -Methode gibt einen HRESULT-Wert zurück. Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. 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

Diese Methode gibt die von bstr bei dieser Auswahl angegebene Zeichenfolge so ein, als hätte sie jemand eingegeben. Die Verwendung von TypeText ist schneller als das Senden von Zeichen über die SendMessage-Funktion , ist aber langsamer als die Verwendung von SetText.

TypeText ähnelt der zugrunde liegenden SetText-Methode , ist jedoch empfindlich auf den Schlüsselzustand Einfügen/Überschreiben und die Benutzeroberflächeneinstellungen wie AutoKorrektur und intelligente Anführungszeichen. Beispielsweise löscht er jede nicht entgenerate Auswahl und fügt dann (abhängig vom Schlüsselzustand Einfügen/Übertyp) die Zeichenfolge bstr an der Einfügemarke ein, sodass diese Auswahl als Einfügemarke nach dem eingefügten Text bleibt.

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