Partager via


Restrictions relatives au nom de symbole

Les restrictions liées aux noms de symboles sont les suivantes :

  • Tous les symboles doivent être uniques dans la portée de l'application. Cela empêche les définitions de symbole en conflit dans les fichiers d'en-tête.

  • Les caractères valides pour un nom de symbole sont A-Z, a-z, 0-9 et les traits de soulignement ( _ ).

  • Les noms de symboles ne peuvent pas commencer par un chiffre et sont limités à 247 caractères.

  • Les noms de symboles ne peuvent pas contenir d'espace.

  • Les noms de symboles ne respectent pas la casse, mais la casse utilisée lors de la définition du symbole est conservée. Le fichier d'en-tête qui définit les symboles est utilisé par le compilateur/l'éditeur de ressources et les programmes C++ pour faire référence aux ressources définies dans un fichier de ressources. Pour deux noms de symboles qui diffèrent uniquement par la casse, le programme C++ considérera qu'il s'agit de deux symboles séparés là où le compilateur/éditeur de ressources n'en verra qu'un.

    Notes

    Si vous ne suivez pas le schéma de nom de symbole standard (ID*_[motclé]) décrit ci-dessous et que votre nom de symbole est identique à un mot clé connu du compilateur de script de ressources, la génération du fichier de script de ressources entraînera des erreurs aléatoires très difficiles à diagnostiquer. Pour empêcher cela, respectez le schéma d'affectation de noms standard.

Les noms de symboles utilisent des préfixes descriptifs qui indiquent le type de ressource ou d'objet qu'ils représentent. Ces préfixes descriptifs commencent par l'ID de la combinaison du texte. La Bibliothèque MFC (Microsoft Foundation Class) utilise les conventions d'affectation des noms de symbole affichées dans le tableau suivant.

Catégorie

Préfixe

Utilisation

Ressources

IDR_ IDD_ IDC_ IDI_ IDB_

Accélérateur ou menu (et ressources associées ou personnalisées) Boîte de dialogue Curseur Icône Bitmap

Éléments de menu

ID_

Menu Item

Commandes

ID_

Commande

Contrôles et fenêtres enfants

IDC_

Contrôle

Chaînes

IDS_

Chaîne de la table de chaînes

MFC

AFX_

Réservé pour les symboles MFC prédéfinis

Pour plus d'informations sur l'ajout de ressources aux projets managés, consultez Ressources dans les applications dans le Guide du développeur .NET Framework. Pour obtenir des informations sur l'ajout de fichiers de ressources aux projets managés, l'accès aux ressources, l'affichage de ressources statiques et l'assignation de chaînes de ressources aux propriétés, et ce manuellement, consultez Procédure pas à pas : localisation des applications Windows Forms et Procédure pas à pas : utilisation de ressources pour la localisation avec ASP.NET.

Configuration requise

Win32

Voir aussi

Tâches

Modification d'un symbole ou d'un nom de symbole (ID)

Référence

Restrictions relatives à la valeur d'un symbole

ID de symbole prédéfinis