Syntax:

INT LlLocAddDictionaryEntry(HLLJOB hJob, LCID nLCID, LPCTSTR pszKey, LPCTSTR pszValue, UINT nType);

Aufgabe:

Fügt einen Eintrag zu einem der Wörterbücher hinzu. Die Wörterbücher erlauben das Lokalisieren von Projekten bzw. Designer-Elementen.

Parameter:

hJob: List & Label-Job-Handle

nLCID: Locale-ID, für die der Eintrag hinzugefügt wird. Diese muss zuvor über LlLocAddDesignLCID() angemeldet worden sein.

pszKey: Schlüssel für das Wörterbuch (Originaltext in der Basissprache).

pszValue: Wert für das Wörterbuch (Übersetzung).

nType: Wörterbuchtyp.

Rückgabewert:

Fehlercode

Hinweise:

Verwenden Sie diese Funktion, um sprachübergreifend mit dem gleichen Projekt arbeiten zu können. Sobald über LlLocAddDesignLCID() mehrere Locale-IDs angemeldet wurden, steht in der Toolbar des Designers eine neue Schaltfläche zur Sprachwahl zur Verfügung. LL_DICTIONARY_TYPE_STATIC erlaubt es, mit Hilfe der Translate$-Designerfunktion feste Texte zu lokalisieren, für diese wird im Designer dann Intellisense-Eingabeunterstützung gegeben. Sie können innerhalb der statischen Texte bis zu 3 Formatierungsplatzhalter verwenden, die mit {0}, {1} bzw. {2} bezeichnet werden können.

Für die Ausgabe zur Druckzeit wird als Voreinstellung die threadspezifische Locale-ID (in der Regel die Systemsprache) verwendet. Wenn Sie für den Druck eine bestimmte Voreinstellung vorgeben möchten, verwenden Sie LL_OPTION_LCID. Diese Voreinstellung kann durch das Design überschrieben werden, wenn im Designer eine entsprechende Projekteinstellung vorgenommen wurde.

Übergeben Sie NULL für pszKey und pszValue, dann werden alle Wörterbucheinträge für alle Wörterbücher gelöscht.

Beispiel:

HLLJOB hJob;

hJob = LlJobOpen(CMBTLANG_­DEFAULT);

// Sprachen hinzufügen
LlLocAddDesignLCID(hJob, 7); // Deutsch als Basissprache
LlLocAddDesignLCID(hJob, 9); // Englisch als Übersetzungssprache

// Übersetzungen hinzufügen
LlLocAddDictionaryEntry(hJob, 9, "Artikelnummer", "ArticleNumber",
   LL_DICTIONARY_TYPE_IDENTIFIER);
LlLocAddDictionaryEntry(hJob, 9, "Preis", "Price",
   LL_DICTIONARY_TYPE_IDENTIFIER);
LlLocAddDictionaryEntry(hJob, 9, "Seite {0} von {1}", "Page {0} of {1}",
   LL_DICTIONARY_TYPE_STATIC);

LlDefineVariableStart(hJob);
LlDefineVariable(hJob, "Artikelnummer", "12345");
LlDefineVariable(hJob, "Preis", "123");

// Designeraufruf usw.
...
LlJobClose(hJob);

Siehe auch:

LlLocAddDesignLCID, LL_OPTION_LCID