À propos de l’API de vérification orthographique
Pour les utilisateurs du monde entier, la saisie textuelle fait partie d’une expérience informatique moderne, pour les blogs, les commentaires, les tweets, la messagerie instantanée ou tout autre type de saisie de texte. Dans Windows 8, la vérification orthographique est intégrée pour modifier les contrôles.
Les développeurs peuvent utiliser l’API de vérification orthographique dans leurs applications pour utiliser les services de vérification orthographique disponibles. Les développeurs peuvent également créer des vérificateurs orthographiques qui deviennent des fournisseurs et qui sont intégrés à l’infrastructure de vérification orthographique Windows.
L’API Vérification orthographique est conçue pour être utilisée par les développeurs C/C++ professionnels des applications COM (Windows Component Object Model). L’API Vérification orthographique n’est pas prise en charge pour une utilisation dans un service Windows ou ASP.NET.
Contrôle de version
L’API Vérification orthographique est disponible à partir du Windows 8 ou Windows Server 2012. Les ajouts futurs à l’API seront gérés en créant de nouvelles interfaces qui peuvent être déterminées à l’aide de QueryInterface sur les interfaces existantes.
Interfaces
Toutes les interfaces doivent être libérées lorsqu’elles ne sont plus utilisées. Toutes les chaînes LPWSTR renvoyées (paramètre out) (et les éléments LPOLESTR de IEnumString) doivent être libérées avec CoTaskMemFree lorsqu’elles ne sont plus utilisées.
Gestion des erreurs
Les erreurs sont retournées en tant que HRESULTs. IErrorInfo et ISupportErrorInfo ne sont pas pris en charge dans cette API. Les erreurs ne sont pas particulièrement exploitables, sauf en cas d’arguments incorrects.
Les codes d’erreur RPC standard peuvent être retournés par n’importe quel appel d’API, car ils sont hors processus. Des délais d’expiration RPC standard s’appliquent.
Sécurité
L’API Vérification orthographique peut charger du code externe (fournisseurs d’orthographe case activée). Il exécutera ce code hors processus et dans un contexte de sécurité restreint.
Fichiers de dictionnaire
Les dictionnaires spécifiques à l’utilisateur d’une langue, qui contiennent le contenu des listes de mots Ajouté, Exclu et Correction automatique, se trouvent sous la balise> %AppData%\Microsoft\Spelling\<language. Les noms de fichiers sont default.dic (Ajouté), default.exc (Exclu) et default.acl (Correction automatique). Les fichiers sont en texte clair UTF-16 LE qui doivent commencer par la marque d’ordre d’octet (BOM) appropriée. Chaque ligne contient un mot (dans les listes De mots ajoutés et exclus), ou une paire de correction automatique avec les mots séparés par une barre verticale (« | ») (dans la liste des mots de correction automatique). Les autres fichiers .dic, .exc et .acl présents dans le répertoire seront détectés par le service de vérification orthographique et ajoutés aux listes de mots utilisateur. Ces fichiers sont considérés comme en lecture seule et ne sont pas modifiés par l’API de vérification orthographique.
Installation d’un fournisseur de vérification orthographique
L’installation d’un fournisseur de vérification orthographique doit placer tous les fichiers qu’il utilise dans un emplacement qui autorise l’accès en lecture à partir du SID (identificateur de sécurité) « ALL APPLICATION PACKAGES ». Son installation dans un dossier sous « Fichiers de programme » fonctionne bien. En outre, le fournisseur doit définir certaines clés dans le Registre pour qu’il apparaisse à l’API de vérification orthographique. Il peut s’agir de la ruche HKEY_CURRENT_USER ou de la ruche HKEY_LOCAL_MACHINE selon qu’elle doit être installée uniquement pour l’utilisateur actuel ou pour tous les utilisateurs.
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>
L’exemple de fournisseur de vérification orthographique fournit un exemple d’inscription nécessaire pour installer un fournisseur.
Si vous créez de nouvelles options de vérification orthographique pour un fournisseur de vérification orthographique, consultez IOptionDescription::Id pour obtenir des conseils sur l’attribution de noms.
Rubriques connexes