STRINGTABLE-Ressource
Definiert mindestens eine Zeichenfolgenressourcen für eine Anwendung. Zeichenfolgenressourcen sind einfach null-beendete 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-anweisungen
-
Dieser Parameter kann 0 oder mehr der folgenden Anweisungen sein.
-Anweisung. BESCHREIBUNG MERKMALEdword Benutzerdefinierte Informationen zu einer Ressource, die von Tools verwendet werden kann, die Ressourcendateien lesen und schreiben. Weitere Informationen finden Sie unter MERKMALE. SPRACHE,Untersprache Gibt die Sprache für die Ressource an. Weitere Informationen finden Sie unter LANGUAGE. VERSIONdword 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.
-
string
-
Mindestens eine Zeichenfolge, die in Anführungszeichen eingeschlossen ist. Die Zeichenfolge darf nicht länger als 4097 Zeichen sein und darf eine einzelne Zeile in der Quelldatei belegen (es sei denn, ein "\" wird als Zeilenfortsetzung verwendet). Um der Zeichenfolge einen Wagenrücklauf hinzuzufügen, verwenden Sie die folgende Zeichenfolge: \012. Beispielsweise definiert "Zeile 1\012Line 2" eine Zeichenfolge, die wie folgt angezeigt wird:
Line one Line two
Verwenden Sie zum Einbetten von Anführungszeichen in die Zeichenfolge die folgende Sequenz: "". 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 Zeilenfortführungen in Zeichenfolgen. Ein Beispiel finden Sie im Abschnitt Beispiele.
Bestimmte Attribute werden auch aus Gründen der Abwärtskompatibilität unterstützt. Weitere Informationen finden Sie unter Allgemeine Ressourcenattribute.
Bemerkungen
RC weist 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 selben Abschnitt platziert.
Beispiele
Das folgende Beispiel veranschaulicht die Verwendung der STRINGTABLE-Anweisung zum Anzeigen von ASCII-Zeichenfolgen:
#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
BEGIN
IDS_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
Weitere Informationen