> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto Dictionary (interfaz IDictionary)

> Objeto Dictionary (interfaz IDictionary) en la API de ABBYY FineReader Engine: objeto para trabajar con diccionarios de usuario y extensiones de diccionario, incluida la adición/eliminación de palabras, la iteración por las palabras y (en Windows) la edición del diccionario mediante un cuadro de diálogo.

Este objeto está diseñado para trabajar con diccionarios de usuario y extensiones de diccionario. Los diccionarios de usuario contienen formas de palabras de un idioma determinado. Cada forma de palabra del diccionario tiene su propio peso, que define su prioridad cuando aparecen varias variantes de una palabra durante el reconocimiento. El peso puede tomar un conjunto de valores discretos. El intervalo de valores va de 0 a 100. Los diccionarios de usuario pueden asociarse con el objeto [BaseLanguage](/es/fine-reader/engine/api-reference/language-related-objects/baselanguage), que representa un idioma base de reconocimiento. Las extensiones de diccionario solo pueden existir para aquellos idiomas que cuentan con compatibilidad con diccionarios estándar.

Se puede obtener un puntero a la interfaz del objeto Dictionary mediante los métodos [CreateNewDictionary](/es/fine-reader/engine/api-reference/language-related-objects/languagedatabase/createnewdictionary-method), [OpenExistingDictionary](/es/fine-reader/engine/api-reference/language-related-objects/languagedatabase/openexistingdictionary-method) u [OpenDictionaryExtension](/es/fine-reader/engine/api-reference/language-related-objects/languagedatabase/opendictionaryextension-method) del objeto [LanguageDatabase](/es/fine-reader/engine/api-reference/language-related-objects/languagedatabase). El método OpenExistingDictionary puede abrir diccionarios creados con el método CreateNewDictionary. El método OpenDictionaryExtension proporciona acceso a la interfaz de una extensión de diccionario.

<Note>
  En Windows, el método [Edit](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/edit-method) muestra el [cuadro de diálogo Dictionary](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/edit-method/dictionary-dialog-box), que permite al usuario editar el diccionario e importar cualquier archivo de texto con codificación ANSI de Windows o Unicode (el único requisito es que las palabras estén separadas por espacios u otros caracteres no alfabéticos).
</Note>

<div id="properties">
  ## Propiedades
</div>

| Nombre      | Tipo                                                                                                                                                                                                                      | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Application | [Engine](/es/fine-reader/engine/api-reference/engine-object-iengine-interface), [de solo lectura](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties) | Devuelve el objeto Engine.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Name        | [BSTR](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)                                                                                                                | Almacena el nombre del diccionario. En Windows, este nombre se muestra en el título del [cuadro de diálogo Dictionary](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/edit-method/dictionary-dialog-box). Una vez creado el objeto Dictionary, esta propiedad almacena el nombre del archivo del diccionario (sin la ruta ni la extensión). Puede asignársele cualquier otro valor. Esta propiedad no se guarda en el archivo asociado al diccionario y debe inicializarse cada vez que se edite el diccionario. |
| WordsCount  | [int](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties), de solo lectura                                                                                                | Devuelve el número de palabras del diccionario.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

<div id="methods">
  ## Métodos
</div>

| Nombre                                                                                                                                         | Descripción                                                                                                                                                                                          |
| ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [AddWord](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/addword-method)                                             | Agrega una palabra al diccionario.                                                                                                                                                                   |
| [AddWords](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/addwords-method)                                           | Agrega un grupo de palabras al diccionario.                                                                                                                                                          |
| [DeleteAllWords](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/deleteallwords-method)                               | Elimina todas las palabras del diccionario.                                                                                                                                                          |
| [DeleteWord](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/deleteword-method)                                       | Elimina una palabra del diccionario.                                                                                                                                                                 |
| [DeleteWords](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/deletewords-method)                                     | Elimina un grupo de palabras del diccionario.                                                                                                                                                        |
| [Edit](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/edit-method) <br /><br /> **Nota:** *Disponible para Windows.* | Muestra el [cuadro de diálogo Dictionary](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/edit-method/dictionary-dialog-box), que permite al usuario editar el diccionario. |
| [EnumWords](/es/fine-reader/engine/api-reference/language-related-objects/dictionary/enumwords-method)                                         | Devuelve un objeto del tipo [EnumDictionaryWords](/es/fine-reader/engine/api-reference/language-related-objects/enumdictionarywords) que le permite recorrer las palabras del diccionario.           |

<div id="output-parameter">
  ## Parámetro de salida
</div>

Este objeto es el parámetro de salida de los métodos [CreateNewDictionary](/es/fine-reader/engine/api-reference/language-related-objects/languagedatabase/createnewdictionary-method), [OpenExistingDictionary](/es/fine-reader/engine/api-reference/language-related-objects/languagedatabase/openexistingdictionary-method) y [OpenDictionaryExtension](/es/fine-reader/engine/api-reference/language-related-objects/languagedatabase/opendictionaryextension-method) del objeto [LanguageDatabase](/es/fine-reader/engine/api-reference/language-related-objects/languagedatabase).

<div id="samples">
  ## Ejemplos
</div>

<Accordion title="Código en C#">
  ```csharp theme={null}
  // El código de ejemplo crea un diccionario de usuario y lo asigna a un idioma base
  FREngine.IEngine engine;
  string dictionaryFileName = "D:\\Sample.amd";
  FREngine.IBaseLanguage baseLanguage;
  // Crear un diccionario nuevo
  ILanguageDatabase languageDatabase = Engine.CreateLanguageDatabase();
  IDictionary dictionary = languageDatabase.CreateNewDictionary( dictionaryFileName,
   LanguageIdEnum.LI_EnglishUnitedStates );
  dictionary.Name = "SampleUserDictionary";
  // Añadir palabras al diccionario
  dictionary.AddWord( "the", 100 );
  dictionary.AddWord( "a", 100 );
  dictionary.AddWord( "an", 100 );
  // Obtener la colección de descripciones de diccionarios de un idioma base y eliminar todos los elementos
  IDictionaryDescriptions dictionaryDescriptions = baseLanguage.DictionaryDescriptions;
  dictionaryDescriptions.DeleteAll();
  // Crear una descripción de diccionario de usuario y añadirla a la colección
  IDictionaryDescription dictionaryDescription = dictionaryDescriptions.AddNew( DictionaryTypeEnum.DT_UserDictionary );
  IUserDictionaryDescription userDictionaryDescription = dictionaryDescription.GetAsUserDictionaryDescription();
  userDictionaryDescription.FileName = dictionaryFileName;
  ```
</Accordion>

El objeto se usa en los siguientes ejemplos de código para Linux y Windows: [CustomLanguage](/es/fine-reader/engine/guided-tour/samples#customlanguage).

<div id="see-also">
  ## Consulte también
</div>

[UserDictionaryDescription](/es/fine-reader/engine/api-reference/language-related-objects/userdictionarydescription)

[Trabajar con diccionarios](/es/fine-reader/engine/guided-tour/advanced-techniques/working-with-dictionaries)

[Trabajar con propiedades](/es/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)