Bezeichnung
CATALOG -- lädt einen Katalog für die spätere Verwendung vor (V9.0)
Übersicht
@CATALOG name$[, table]
Beschreibung
Mit dieser Präprozessor-Anweisung kann der angegebene Katalog in der Sprache des Benutzers vorgeladen werden. Wenn kein Katalog in der Sprache des Benutzers vorhanden ist, zeigt diese Präprozessor-Anweisung keinen Fehler an. Dies ist normal, da Sie für jeden Eintrag, den Sie mit dem Befehl GetCatalogString() aus einem Katalog abrufen möchten, immer Standardzeichenketten angeben müssen. Daher ist es kein Problem, wenn @CATALOG einen Katalog angibt, der nicht existiert. In diesem Fall wird GetCatalogString() einfach auf die Standardzeichenketten zurückgreifen, ohne einen Fehler auszulösen.

Beachten Sie, dass es derzeit nur einen einzigen Katalog pro Anwendung geben kann. Daher sollte @CATALOG nur einmal pro Skript verwendet werden. Beachten Sie auch, dass name$ kein Dateiname sein darf, sondern der Name eines Katalogs, der in einer Hollywood-Katalogverzeichnisstruktur gespeichert ist. Siehe OpenCatalog für Details zur Organisation einer solchen Hollywood-Katalogstruktur.

Der Vorteil der Verwendung von @CATALOG anstelle von OpenCatalog() besteht darin, dass bei Verwendung von @CATALOG die Kataloge für alle verfügbaren Sprachen beim Kompilieren Ihres Skripts mit Ihrem Programm oder Applet verknüpft werden. Dies erleichtert die Verteilung Ihres Projekts, da Sie die Katalogverzeichnisstruktur nicht in Ihr Programm einbinden müssen. Auch beim Kompilieren von Hollywood-Applets für mobile Systeme wie Android oder iOS ist es viel besser, alle externen Dateien mit dem Applet zu verknüpfen.

Zusätzlich zum Parameter name$ akzeptiert @CATALOG auch ein optionales Tabellenargument. Die folgenden Felder im Tabellenargument sind derzeit verfügbar:

Link:
Setzen Sie dieses Feld auf False, wenn Sie nicht möchten, dass dieser Katalog beim Kompilieren Ihres Skripts mit Ihrem Programm/Applet verknüpft wird. Dieses Feld ist standardmäßig auf True gesetzt. Dies bedeutet, dass der Katalog mit Ihrem Programm/Applet verknüpft wird, wenn sich Hollywood im Kompilierungsmodus befindet.

Um einen Katalog während der Laufzeit zu laden, verwenden Sie den den Befehl OpenCatalog(). Siehe OpenCatalog für Details.

Eingaben
name$
Name des zu öffnenden Katalogs
table
optional: Tabelle mit weiteren Optionen
Beispiel
@CATALOG "Hollywood.catalog"

; dies ist unser standardmäßiger englischer Katalog
def$ = {}
def$[0] = "Welcome to Hollywood!"
def$[1] = "Written by Andreas Falkenhahn"
def$[2] = "What do you wanna do?"

; Wenn Hollywood.catalog nicht in der Sprache
; des Benutzers verfügbar ist, werden die
; englischen Zeichenketten verwendet
For k = 0 To 2
   c$[k] = GetCatalogString(k, def$[k])
Next
Der obige Code öffnet "Hollywood.catalog" und gibt die ersten drei Einträge aus diesem Katalog aus.

Navigation zeigen