Dictionary-Objekt (IDictionary-Schnittstelle)

Dictionary-Objekt (IDictionary-Schnittstelle) in der ABBYY FineReader Engine API — Objekt für die Arbeit mit Benutzerwörterbüchern und Wörterbucherweiterungen, einschließlich des Hinzufügens/Entfernens von Wörtern, des Iterierens über Wörter und (unter Windows) der Bearbeitung des Wörterbuchs über ein Dialogfeld.

Dieses Objekt ist für die Arbeit mit Benutzerwörterbüchern und Wörterbucherweiterungen konzipiert. Benutzerwörterbücher enthalten Wortformen von Wörtern einer bestimmten Sprache. Jede Wortform im Wörterbuch besitzt eine eigene Gewichtung, die ihre Priorität bestimmt, wenn während der Erkennung mehrere Varianten für ein Wort auftreten. Die Gewichtung kann diskrete Werte annehmen. Der Wertebereich liegt zwischen 0 und 100. Benutzerwörterbücher können mit dem BaseLanguage-Objekt verknüpft werden – einem Objekt, das eine Basiserkennungssprache repräsentiert. Wörterbucherweiterungen sind nur für Sprachen verfügbar, die über eine standardmäßige Wörterbuchunterstützung verfügen.

Ein Zeiger auf die Schnittstelle des Dictionary-Objekts kann über die Methoden CreateNewDictionary, OpenExistingDictionary oder OpenDictionaryExtension des LanguageDatabase-Objekts abgerufen werden. Die Methode OpenExistingDictionary kann Wörterbücher öffnen, die mit der Methode CreateNewDictionary erstellt wurden. OpenDictionaryExtension ermöglicht den Zugriff auf die Schnittstelle einer Wörterbucherweiterung.

Unter Windows zeigt die Methode Edit das Dialogfeld „Dictionary” an, über das Benutzer das Wörterbuch bearbeiten und beliebige Textdateien in Windows-ANSI- oder Unicode-Kodierung importieren können (einzige Voraussetzung: Wörter müssen durch Leerzeichen oder andere nicht-alphabetische Zeichen getrennt sein).

​

Properties

Name	Typ	Beschreibung
Application	Engine, nur lesbar	Gibt das Engine-Objekt zurück.
Name	BSTR	Speichert den Namen des Wörterbuchs. Unter Windows wird dieser Name in der Titelleiste des Dialogfelds „Wörterbuch” angezeigt. Nach der Erstellung des Dictionary-Objekts enthält diese Eigenschaft den Namen der Wörterbuchdatei (ohne Pfad und Erweiterung). Sie können ihr einen beliebigen anderen Wert zuweisen. Diese Eigenschaft wird nicht in der dem Wörterbuch zugeordneten Datei gespeichert und muss jedes Mal neu initialisiert werden, wenn das Wörterbuch bearbeitet wird.
WordsCount	int, nur lesbar	Gibt die Anzahl der Wörter im Wörterbuch zurück.

​

Methoden

Name	Beschreibung
AddWord	Fügt ein Wort zum Wörterbuch hinzu.
AddWords	Fügt eine Gruppe von Wörtern zum Wörterbuch hinzu.
DeleteAllWords	Löscht alle Wörter aus dem Wörterbuch.
DeleteWord	Löscht ein Wort aus dem Wörterbuch.
DeleteWords	Löscht eine Gruppe von Wörtern aus dem Wörterbuch.
Edit Hinweis: Verfügbar für Windows.	Zeigt das Dialogfeld „Dictionary“ an, über das Benutzer das Wörterbuch bearbeiten können.
EnumWords	Gibt ein Objekt vom Typ EnumDictionaryWords zurück, mit dem Sie die Wörter im Wörterbuch durchlaufen können.

​

Ausgabeparameter

Dieses Objekt ist der Ausgabeparameter der Methoden CreateNewDictionary, OpenExistingDictionary, OpenDictionaryExtension des Objekts LanguageDatabase.

​

Beispiele

C#-Code

// Der Beispielcode erstellt ein Benutzerwörterbuch und weist es einer Basissprache zu
FREngine.IEngine engine;
string dictionaryFileName = "D:\\Sample.amd";
FREngine.IBaseLanguage baseLanguage;
// Neues Wörterbuch erstellen
ILanguageDatabase languageDatabase = Engine.CreateLanguageDatabase();
IDictionary dictionary = languageDatabase.CreateNewDictionary( dictionaryFileName,
 LanguageIdEnum.LI_EnglishUnitedStates );
dictionary.Name = "SampleUserDictionary";
// Wörter zum Wörterbuch hinzufügen
dictionary.AddWord( "the", 100 );
dictionary.AddWord( "a", 100 );
dictionary.AddWord( "an", 100 );
// Sammlung der Wörterbuchbeschreibungen einer Basissprache abrufen und alle Einträge entfernen
IDictionaryDescriptions dictionaryDescriptions = baseLanguage.DictionaryDescriptions;
dictionaryDescriptions.DeleteAll();
// Benutzerwörterbuchbeschreibung erstellen und zur Sammlung hinzufügen
IDictionaryDescription dictionaryDescription = dictionaryDescriptions.AddNew( DictionaryTypeEnum.DT_UserDictionary );
IUserDictionaryDescription userDictionaryDescription = dictionaryDescription.GetAsUserDictionaryDescription();
userDictionaryDescription.FileName = dictionaryFileName;

Das Objekt wird in den folgenden Codebeispielen für Linux und Windows verwendet: CustomLanguage.

​

Siehe auch

UserDictionaryDescription

Working with Dictionaries

Working with Properties