Compartir a través de

Acerca de la API de Spell Checking

  • Artículo

Para los usuarios de todo el mundo, la entrada textual forma parte de una experiencia informática moderna, para el registro, comentarios, tweeting, mensajería instantánea o cualquier otro tipo de escritura de texto. En Windows 8, la revisión ortográfica está integrada para editar controles.

Los desarrolladores pueden usar la API de revisión ortográfica en sus aplicaciones para consumir los servicios de revisión ortográfica disponibles. Los desarrolladores también pueden crear correctores ortográficos que se conviertan en proveedores y estén integrados en el marco de revisión ortográfica de Windows.

La API de revisión ortográfica está diseñada para su uso por parte de desarrolladores profesionales de C/C++ de aplicaciones del modelo de objetos componentes de Windows (COM). La API de revisión ortográfica no se admite para su uso en un servicio de Windows o ASP.NET.

Control de versiones

La API de revisión ortográfica está disponible a partir del Windows 8 o Windows Server 2012. Las adiciones futuras a la API se controlarán mediante la creación de nuevas interfaces que se pueden determinar mediante QueryInterface en las existentes.

Interfaces

Todas las interfaces deben liberarse cuando ya no se usen. Todas las cadenas LPWSTR devueltas (parámetro out) (y los elementos LPOLESTR de IEnumString) deben liberarse con CoTaskMemFree cuando ya no se usen.

Control de errores

Los errores se devuelven como HRESULTs. IErrorInfo e ISupportErrorInfo no se admiten en esta API. Los errores no son especialmente accionables, excepto los argumentos incorrectos.

Cualquiera de las llamadas API puede devolver los códigos de error RPC estándar porque están fuera de proceso. Se aplican tiempos de espera de RPC estándar.

Seguridad

La API de revisión ortográfica puede cargar código externo (proveedores de revisión ortográfica). Ejecutará este código fuera de proceso y bajo un contexto de seguridad restringido.

Archivos de diccionario

Los diccionarios específicos del usuario para un idioma, que contienen el contenido de las listas de palabras agregadas, excluidas y autocorrección, se encuentran en la etiqueta> %AppData%\Microsoft\Spelling\<language. Los nombres de archivo son default.dic (Agregado), default.exc (Excluido) y default.acl (Autocorrección). Los archivos son texto no cifrado UTF-16 LE que debe comenzar con la marca de orden de bytes (BOM) adecuada. Cada línea contiene una palabra (en las listas de palabras agregadas y excluidas) o un par de autocorrección con las palabras separadas por una barra vertical ("|") (en la lista de palabras de Autocorrección). El servicio de revisión ortográfica detectará otros archivos .dic, .exc y .acl presentes en el directorio y se agregará a las listas de palabras de usuario. Estos archivos se consideran de solo lectura y no los modifica la API de revisión ortográfica.

Instalación de un proveedor de revisión ortográfica

La instalación de un proveedor de revisión ortográfica debe colocar todos los archivos que usa en una ubicación que permita el acceso de lectura desde el SID (identificador de seguridad) "TODOS LOS PAQUETES DE APLICACIÓN". Instalarlo en una carpeta en "Archivos de programa" funciona bien. Además, el proveedor debe establecer algunas claves en el Registro para que aparezca en la API de revisión ortográfica. Puede estar en el subárbol HKEY_CURRENT_USER o en el subárbol HKEY_LOCAL_MACHINE en función de si solo debe instalarse para el usuario actual o para todos los usuarios.

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>

El ejemplo del proveedor de revisión ortográfica proporciona un ejemplo del registro necesario para instalar un proveedor.

Si va a crear nuevas opciones de revisión ortográfica para un proveedor de revisión ortográfica, consulte IOptionDescription::Id para obtener instrucciones sobre la nomenclatura.

Referencia de la API de revisión ortográfica

Ejemplo de cliente de revisión ortográfica

Ejemplo del proveedor de revisión ortográfica

IOptionDescription::Id

IEnumString

QueryInterface