VBX Module downloaden

Beschreibung

cLocalization bietet die Integration von Sprachdateien, die mit vbLocalization Manager erstellt wurden.
Dieses Modul ist nur in Kombination mit vbLocalization Manager einsetzbar.

Inhalt

Eigenschaften
Methoden
Ereignisse
Hinweise
Sprachdatei-Spezifikationen
Beispiel
Module
Versionsgeschichte
Siehe auch

Eigenschaften

.Changed As Boolean

Wurde der Dateiinhalt seit dem letzten Laden oder Speichern geändert, ist dieser Wert True.

.LastError As String

Letzter aufgetretener Fehler.
Schreibgeschützt.

.Folder As String

Mit GetFiles geladener Ordner.
Schreibgeschützt.

.Languages As Variant

Variant String Array mit den Namen (ohne Erweiterung) der Sprachdateien, die von GetFiles gefunden wurden.
Diese Namen repräsentieren die verfügbaren Sprachen.
Schreibgeschützt.

[.Item](OriginalText As String,[Value1 As Variant, Value2 As Variant, ...]) As String

Übersetzung von Originaltext.
Wert1 bis WertN sind Werte, die die Platzhalter ersetzen.
Wird keine Übersetzung gefunden wird der übergebene Text mit ersetzen Platzhaltern zurückgegeben.
Schreibgeschützt.
Standardeigenschaft.

.ItemA(OriginalText As String) As String

Übersetzung von Originaltext.
Wird keine Übersetzung gefunden wird ein Nullstring zurückgegeben.
Platzhalter werden unverändert zurückgegeben bzw. gespeichert.

.Keys As Variant

Variant String Array mit allen Originaltext-Einträgen.
Schreibgeschützt.

.Items As Variant

Variant String Array mit allen Übersetzungen.
Schreibgeschützt.

.Language As String

Aktuell geladene Sprache.
Schreibgeschützt.

.CurrentFile As String

Pfad der aktuell geladenen Sprachdatei.
Schreibgeschützt.

.LCID As Long

Regionale/lokale ID der Übersetzung.
Dieser Wert wird in den Sprachdateien gespeichert.
Standardeinstellung ist die ID des aktuellen Systems.

.CharSet As Long

Schriftseite der Übersetzung. Diese Eigenschaft wird für korrekte Anzeige von Unicode-Schriftarten benötigt. Dieser Wert wird in der Sprachdatei gespeichert.
Standardeinstellung ist ANSI.

.RightToLeft As Boolean

Boolean. Diese Eingenschaft bestimmt, ob die Schrift von Rechts nach Links verläuft und wird in der Sprachdatei gespeichert.

.LCIDs As Scripting.Dictionary

Handle zu einem Scripting.Dictionary. Enthält die Schlüssel-Wert-Paare der geladenen LCIDs:
Beschreibung (String) = LCID (Long)
Siehe LoadLCIDs

.CharSets As Scripting.Dictionary

Handle zu einem Scripting.Dictionary. Enthält die Schlüssel-Wert-Paare der geladenen CharSets:
Beschreibung (String) = CharSet (Long)
Siehe LoadCharSets

Methoden

.GetFiles(Folder As String, [FileExtension As String]) As Boolean

Liest die Dateien des Ordners.
Es werden nur Dateien berücksichtigt, die die angegebene Erweiterung (FileExtension) haben. Standard ist "lng".
Der Rückgabewert ist False, wenn beim Auslesen Fehler aufgetreten sind.

.Load(Language As String) As Boolean

Lädt die angegebene Sprachdatei nach Name (Sprache).
Der Rückgabewert ist False, wenn beim Laden Fehler aufgetreten sind.

.LoadA(Language As String) As Boolean

Lädt eine Sprachdatei bis v2.08 alpha5.
Diese Methode wird automatisch von Load bzw. LoadFile aufgerufen, wenn die Sprachdatei nicht ab v2.11 alpha6 ist.

.LoadFile(FilePath As String) As Boolean

Lädt die angegebene Sprachdatei nach dem Dateipfad (FilePath).
Der Rückgabewert ist False, wenn beim Laden Fehler aufgetreten sind.

.Save(FilePath As String) As Boolean

Speichert die aktuell geladene Sprachdatei unter dem angegebenen Dateipfad (FilePath).
Der Rückgabewert ist ein bool-Wert, der False ist wenn beim Speichern Fehler aufgetreten sind.

.ClearFiles

Entfernt alle Dateien aus der Liste.
Keine Rückgabe.

.ClearTranslation

Entfernt alle Werte aus der aktuell geladenen Sprachdatei.
Keine Rückgabe.

.LoadLCIDs(FilePath As String) As Boolean

Lädt alle verfügbaren LCIDs aus der angegebenen Datei.
Die Datei wird mit der Klasse ausgeliefert: lcid.ini.
Der Rückgabewert ist False, wenn beim Laden Fehler aufgetreten sind.

.LoadCharSets(FilePath As String) As Boolean

Lädt alle verfügbaren CharSets aus der angegebenen Datei.
Die Datei wird mit der Klasse ausgeliefert: charsets.ini.
Der Rückgabewert ist False, wenn beim Laden Fehler aufgetreten sind.

Ereignisse

_OnError(Message As String)

Wird bei Fehlern ausgelöst.

Hinweise

Platzhalter werden während der Laufzeit durch entsprechende Werte ersetzt.

Die Sprachnamen bestehen aus dem Namen (ohne Erweiterung) der zugehörigen Datei.

Methoden und Eigenschaften, die zur Bearbeitung von Sprachdateien dienen werden für den normalen Einsatz nicht gebraucht, deswegen sind diese grün dargestellt.

Sprachdatei-Spezifikationen

Sprachdateien werden mit DBCS UNICODE-Zeichen gespeichert. Die Dateien können mit Notepad bearbeitet werden.

Der Header der Sprachdateien ist in einem head-Tag eingeschlossen und beinhaltet zusätzliche sprachbezogene Informationen.

Für die korrekte Anzeige von Unicode-Schriftarten muss die CharSet-Eigenschaft der Schriftart entsprechend gesetzt werden.

Unicode-Schriftarten werden ohne Einschränkungen angezeigt, jedoch nur auf Systemen, die die entsprechende Sprache als Standardsprache eingestellt haben.
Beispielsweise ist die Anzeige und Bearbeitung (in vbLM) griechischer Zeichen auf einem englischen System, das Griechisch nicht als Systemsprache eingestellt hat, nicht möglich.

Beispiel

Module

cLocalization (2.11 alpha7)
modLoc.bas (nur VB)

Benötigt fso als Scripting.FileSystemObject und den Verweis auf 'Microsoft Scripting Runtime'.

Versionsgeschichte (englisch)

2.11 alpha7 - Unicode languages are displayed without limitation, but only on systems having this language set to default
                    the LCID property is no longer needed, as no conversions take place anymore
2.11 alpha6 - added Unicode support: LCID, CharSet, RightToLeft, LoadLCIDs, LCIDs, LoadCharSets, CharSets
                    LoadA for loading old (non-unicode) language files
                    Keys and Items properties and OnError event
2.08 alpha5 - changed: GetItem, SetItem -> ItemA
2.08 alpha4 - improved error message (LastError) for file operations
2.08 alpha3 - updated TextFile functions
2.08 alpha2 - added: Save, Language, SetItem, strExtension (GetFiles), CurrentFile, LoadFile, Folder

Siehe auch

...