Informationen zur Rechtschreibprüfungs-API
Für Benutzer weltweit ist textuelle Eingabe Teil einer modernen Computerumgebung, zum Bloggen, Kommentieren, Twittern, Instant Messaging oder jeder anderen Art von Texteingabe. In Windows 8 ist die Rechtschreibprüfung zum Bearbeiten von Steuerelementen integriert.
Entwickler können die Rechtschreibprüfungs-API in ihren Apps verwenden, um verfügbare Rechtschreibprüfungsdienste zu nutzen. Entwickler können auch Rechtschreibprüfung erstellen, die zu Anbietern werden und in das Windows-Framework für die Rechtschreibprüfung integriert sind.
Die Rechtschreibprüfungs-API ist für die Verwendung durch professionelle C/C++-Entwickler von COM-Apps (Windows Component Object Model) konzipiert. Die Rechtschreibprüfungs-API wird nicht für die Verwendung in einem Windows- oder ASP.NET-Dienst unterstützt.
Versionsverwaltung
Die Rechtschreibprüfungs-API ist ab dem Windows 8 oder Windows Server 2012 verfügbar. Zukünftige Ergänzungen der API werden durch das Erstellen neuer Schnittstellen behandelt, die mithilfe von QueryInterface für die vorhandenen schnittstellen bestimmt werden können.
Schnittstellen
Alle Schnittstellen müssen freigegeben werden, wenn sie nicht mehr verwendet werden. Alle zurückgegebenen LPWSTR-Zeichenfolgen (und LPOLESTR-Elemente von IEnumString) müssen mit CoTaskMemFree freigegeben werden, wenn sie nicht mehr verwendet werden.
Fehlerbehandlung
Fehler werden als HRESULTs zurückgegeben. IErrorInfo und ISupportErrorInfo werden in dieser API nicht unterstützt. Fehler sind außer falschen Argumenten nicht besonders umsetzbar.
Standardmäßige RPC-Fehlercodes werden möglicherweise von einem der API-Aufrufe zurückgegeben, da sie außerhalb des Codes liegen. Es gelten standardmäßige RPC-Timeouts.
Sicherheit
Die Rechtschreibprüfungs-API kann externen Code (Rechtschreibprüfungsanbieter) laden. Dieser Code wird out-of-proc und unter einem eingeschränkten Sicherheitskontext ausgeführt.
Wörterbuchdateien
Die benutzerspezifischen Wörterbücher für eine Sprache, die den Inhalt der Wortlisten Hinzugefügt, Ausgeschlossen und AutoKorrektur enthalten, befinden sich unter dem Tag> %AppData%\Microsoft\Spelling\<language. Die Dateinamen sind default.dic (Added), default.exc (Excluded) und default.acl (AutoKorrektur). Die Dateien sind UTF-16 LE-Klartext, der mit der entsprechenden Byte Order Mark (BOM) beginnen muss. Jede Zeile enthält ein Wort (in den Listen Hinzugefügte und ausgeschlossene Wörter) oder ein Autokorrekturpaar mit den Wörtern, die durch einen vertikalen Balken ("|") getrennt sind. (in der AutoKorrektur-Wortliste). Andere DIC-, EXC- und ACL-Dateien, die im Verzeichnis vorhanden sind, werden vom Rechtschreibprüfungsdienst erkannt und den Benutzerwortlisten hinzugefügt. Diese Dateien gelten als schreibgeschützt und werden von der Rechtschreibprüfungs-API nicht geändert.
Installieren eines Rechtschreibprüfungsanbieters
Bei der Installation eines Rechtschreibprüfungsanbieters müssen alle von ihr verwendeten Dateien an einem Speicherort platziert werden, der Lesezugriff von der SID (Sicherheitsbezeichner) "ALL APPLICATION PACKAGES" ermöglicht. Die Installation in einem Ordner unter "Programme" funktioniert gut. Außerdem muss der Anbieter einige Schlüssel in der Registrierung festlegen, damit sie der API zur Rechtschreibprüfung angezeigt werden. Es kann sich entweder in der HKEY_CURRENT_USER-Struktur oder in der HKEY_LOCAL_MACHINE-Struktur sein, je nachdem, ob es nur für den aktuellen Benutzer oder alle Benutzer installiert werden soll.
Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>
Default (REG_SZ) = <Name of the provider>
Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>\InprocServer32
ThreadingModel (REG_SZ) = "Both"
Key: <Registry hive>\SOFTWARE\Classes\CLSID\<Server CLSID>\Version
Version (REG_SZ) = <Version>
Key: <Registry hive>\SOFTWARE\Microsoft\Spelling\Spellers\<Provider id string>
CLSID (REG_SZ) = <CLSID of the COM Server that implements the provider>
Das Beispiel eines Rechtschreibprüfungsanbieters enthält ein Beispiel für die Registrierung, die zum Installieren eines Anbieters erforderlich ist.
Wenn Sie neue Rechtschreibprüfungsoptionen für einen Rechtschreibprüfungsanbieter erstellen, finden Sie unter IOptionDescription::Id Anleitungen zur Benennung.
Zugehörige Themen