STRINGTABLE, ressource

Définit une ou plusieurs ressources de chaîne pour une application. Les ressources de chaîne sont simplement des chaînes Unicode ou ASCII terminées par null qui peuvent être chargées si nécessaire à partir du fichier exécutable, à l’aide de la fonction LoadString .

Il existe deux façons de mettre en forme une instruction STRINGTABLE :

STRINGTABLE  [optional-statements] {stringID string  ...}

- ou -

STRINGTABLE
  [optional-statements]
BEGIN
stringID string
. . .
END

Paramètres

instructions facultatives

Ce paramètre peut être égal à zéro ou plusieurs des instructions suivantes.

.	Description
CARACTÉRISTIQUESdword	Informations définies par l’utilisateur sur une ressource qui peuvent être utilisées par les outils qui lisent et écrivent des fichiers de ressources. Pour plus d’informations, consultez CARACTÉRISTIQUES.
Langue,sous-langage	Spécifie la langue de la ressource. Pour plus d’informations, consultez LANGUAGE.
VERSIONdword	Numéro de version défini par l’utilisateur pour la ressource qui peut être utilisée par les outils qui lisent et écrivent des fichiers de ressources. Pour plus d’informations, consultez VERSION.

 

stringID

Entier 16 bits non signé qui identifie la ressource.

string

Une ou plusieurs chaînes, placées entre guillemets. La chaîne ne doit pas dépasser 4 097 caractères et doit occuper une seule ligne dans le fichier source (sauf si un « \ » est utilisé comme continuation de ligne). Pour ajouter un retour chariot à la chaîne, utilisez cette séquence de caractères : \012. Par exemple, « Line one\012Line two » définit une chaîne qui s’affiche comme suit :

Line one
Line two

Pour incorporer des guillemets dans la chaîne, utilisez la séquence suivante : « ». Par exemple, « ""Ligne 3"" » définit une chaîne qui s’affiche comme suit :

"Line three"

Pour encoder des caractères Unicode, utilisez un « L » suivi des caractères Unicode entre guillemets. Pour obtenir un exemple, consultez la section Exemples.

Le compilateur de ressources prend également en charge les continuations de lignes dans la chaîne. Pour obtenir un exemple, consultez la section Exemples.

Certains attributs sont également pris en charge pour la compatibilité descendante. Pour plus d’informations, consultez Attributs de ressources communs.

Remarques

RC alloue 16 chaînes par section et utilise la valeur d’identificateur pour déterminer quelle section doit contenir la chaîne. Les chaînes dont les identificateurs diffèrent uniquement dans les 4 bits inférieurs sont placées dans la même section.

Exemples

L’exemple suivant illustre l’utilisation de l’instruction STRINGTABLE pour afficher des chaînes ASCII :

#define IDS_HELLO    1
#define IDS_GOODBYE  2

STRINGTABLE
{
    IDS_HELLO,   "Hello"
    IDS_GOODBYE, "Goodbye"
} 

L’exemple suivant montre comment encoder des caractères Unicode :

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

L’exemple suivant montre des chaînes avec ASCII et Unicode. Notez que les chaînes sans le « L » initial utilisent le format d’échappement à 2 chiffres :

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

L’exemple suivant montre comment les continuations de ligne peuvent être utilisées :

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

Voir aussi

LoadString

ACCÉLÉRATEURS

CARACTÉRISTIQUES

LANGUE

MENU

RCDATA

VERSION