STRINGTABLE-Ressource
Definiert mindestens eine Zeichenfolgenressourcen für eine Anwendung. Zeichenfolgenressourcen sind einfach auf NULL terminierte Unicode- oder ASCII-Zeichenfolgen, die bei Bedarf mithilfe der LoadString-Funktion aus der ausführbaren Datei geladen werden können.
Es gibt zwei Möglichkeiten, eine STRINGTABLE-Anweisung zu formatieren:
STRINGTABLE [optional-statements] {stringID string ...}
- oder –
STRINGTABLE
[optional-statements]
BEGIN
stringID string
. . .
END
Parameter
-
optional-statements
-
Dieser Parameter kann null oder mehr der folgenden Anweisungen sein.
-Anweisung. BESCHREIBUNG CHARACTERISTICS dword Benutzerdefinierte Informationen zu einer Ressource, die von Tools verwendet werden können, die Ressourcendateien lesen und schreiben. Weitere Informationen finden Sie unter CHARACTERISTICS. LANGUAGE-Sprache, Untersprache Gibt die Sprache für die Ressource an. Weitere Informationen finden Sie unter LANGUAGE. VERSIONSdword Benutzerdefinierte Versionsnummer für die Ressource, die von Tools verwendet werden kann, die Ressourcendateien lesen und schreiben. Weitere Informationen finden Sie unter VERSION. -
stringID
-
16-Bit-Ganzzahl ohne Vorzeichen, die die Ressource identifiziert.
-
Schnur
-
Mindestens eine Zeichenfolge in Anführungszeichen. Die Zeichenfolge darf nicht länger als 4097 Zeichen sein und muss eine einzelne Zeile in der Quelldatei belegen. Um der Zeichenfolge einen Wagenrücklauf hinzuzufügen, verwenden Sie diese Zeichenfolge: \ 012. Beispielsweise definiert "Zeile \ 1 012Line 2" eine Zeichenfolge, die wie folgt angezeigt wird:
Line one Line twoVerwenden Sie die folgende Sequenz, um Anführungszeichen in die Zeichenfolge einbetten: "". Beispielsweise definiert """Zeile 3""" eine Zeichenfolge, die wie folgt angezeigt wird:
"Line three"Verwenden Sie zum Codieren von Unicode-Zeichen ein "L", gefolgt von den Unicode-Zeichen, die in Anführungszeichen eingeschlossen sind. Ein Beispiel finden Sie im Abschnitt Beispiele.
Der Ressourcencompiler unterstützt auch Zeilenfortsetzungen in der Zeichenfolge. Ein Beispiel finden Sie im Abschnitt Beispiele.
Bestimmte Attribute werden aus Gründen der Abwärtskompatibilität ebenfalls unterstützt. Weitere Informationen finden Sie unter Allgemeine Ressourcenattribute.
Hinweise
RC ordnet 16 Zeichenfolgen pro Abschnitt zu und verwendet den Bezeichnerwert, um zu bestimmen, welcher Abschnitt die Zeichenfolge enthalten soll. Zeichenfolgen, deren Bezeichner sich nur in den unteren 4 Bits unterscheiden, werden im gleichen Abschnitt platziert.
Beispiele
Im folgenden Beispiel wird die Verwendung der STRINGTABLE-Anweisung zum Anzeigen von ASCII-Zeichenfolgen veranschaulicht:
#define IDS_HELLO 1
#define IDS_GOODBYE 2
STRINGTABLE
{
IDS_HELLO, "Hello"
IDS_GOODBYE, "Goodbye"
}
Das folgende Beispiel zeigt, wie Unicode-Zeichen codiert werden:
STRINGTABLE
BEGINIDS_CHINESESTRING L"\x5e2e\x52a9"
IDS_RUSSIANSTRING L"\x0421\x043f\x0440\x0430\x0432\x043a\x0430"
IDS_ARABICSTRING L"\x062a\x0639\x0644\x064a\x0645\x0627\x062a"
END
Das folgende Beispiel zeigt Zeichenfolgen mit ASCII und Unicode. Beachten Sie, dass Zeichenfolgen ohne das anfängliche "L" das 2-stellige Escapeformat verwenden:
STRINGTABLE
BEGIN
IDS_1 L"5\x00BC-Inch Floppy Disk"
IDS_1a "5\xBC-Inch Floppy Disk"
IDS_2 L"Don't confuse \x2229 (intersection) with \x222A (union)"
IDS_3 "Copyright \xA92001"
IDS_3a L"Copyright \x00a92001"
END
Das folgende Beispiel zeigt, wie Zeilenfortsetzungen verwendet werden können:
STRINGTABLE
BEGIN
IDS_VERYLONGSTRING "blah blah blah blah blah blah \
blah blah blah blah blah blah \
blah blah blah blah blah blah \
blah blah blah blah blah blah"
END