Freigeben über


ITextSelection::TypeText-Methode (tom.h)

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

Siehe auch

Konzept

ITextSelection

Andere Ressourcen

Referenz

SendMessage

SetFlags

Settext

Textobjektmodell