Beschränkungen bei Symbolnamen
Für Symbolnamen gelten folgende Beschränkungen:
Alle Namen von Symbolen müssen innerhalb des Gültigkeitsbereichs der Anwendung eindeutig sein. Dadurch werden Konflikte mit den Symboldefinitionen in den Headerdateien vermieden.
Zulässige Zeichen für Symbolnamen sind A-Z, a-z, 0-9 und Unterstriche ( _ ).
Symbolnamen dürfen nicht mit einer Zahl beginnen und sind auf 247 Zeichen begrenzt.
Symbolnamen dürfen keine Leerzeichen enthalten.
Bei Symbolnamen wird nicht zwischen Groß- und Kleinschreibung unterschieden, die Schreibweise der ersten Symboldefinition wird jedoch beibehalten. Die Headerdatei, durch die Symbole definiert werden, wird sowohl vom Ressourcencompiler/-Editor als auch von C++-Programmen für Verweise auf die in einer Ressourcendatei definierten Ressourcen verwendet. Zwei Symbolnamen, die sich lediglich hinsichtlich Groß- und Kleinschreibung unterscheiden, werden vom C++-Programm als zwei separate Symbole angesehen, während der Ressourcencompiler/-Editor beide Namen mit einem einzigen Symbol assoziiert.
Tipp
Wenn Sie das unten aufgeführte Standardschema für Symbolnamen (ID*_[Schlüsselwort]) nicht befolgen und Ihr Symbolname zufällig mit einem Schlüsselwort übereinstimmt, das vom Ressourcenskriptcompiler erkannt wird, werden durch die Erstellung der Ressourcenskriptdatei scheinbar willkürlich auftretende Fehler generiert, die nur schwer zu diagnostizieren sind. Um dies zu verhindern, sollten Sie das Standardnamensschema befolgen.
Symbolnamen verfügen über beschreibende Präfixe, durch die die Art der Ressource bzw. des Objekts, die oder das sie darstellen, angegeben wird. Diese beschreibenden Präfixe beginnen mit der Buchstabenkombination "ID". MFC (Microsoft Foundation Class Library) verwendet die in der folgenden Tabelle aufgeführten Konventionen für Symbolnamen.
Kategorie |
Präfix |
Verwendung |
|---|---|---|
Ressourcen |
IDR_ IDD_ IDC_ IDI_ IDB_ |
Zugriffstaste oder Menü (und verknüpfte oder benutzerdefinierte Ressourcen) Dialogfeld Cursor Symbol Bitmap |
Menüelemente |
ID_ |
Menüelement |
Befehle |
ID_ |
Befehl |
Steuerelemente und untergeordnete Fenster |
IDC_ |
Steuerelement |
Zeichenfolgen |
IDS_ |
Zeichenfolge in der Zeichenfolgentabelle |
MFC |
AFX_ |
Reserviert für vordefinierte MFC-Symbole |
Informationen zum Hinzufügen von Ressourcen zu verwalteten Projekten finden Sie unter Ressourcen in Anwendungen im .NET Framework-Entwicklerhandbuch. Informationen zum manuellen Hinzufügen von Ressourcendateien zu verwalteten Projekten, zum Zugreifen auf Ressourcen, zum Anzeigen statischer Ressourcen und zum Zuweisen von Ressourcenzeichenfolgen zu Eigenschaften finden Sie unter Exemplarische Vorgehensweise: Lokalisieren von Windows Forms und Exemplarische Vorgehensweise: Verwenden von Ressourcen zur Lokalisierung mit ASP.NET.
Anforderungen
Win32
Siehe auch
Aufgaben
Ändern eines Symbols oder Symbolnamens (ID)