符号名限制

更新:2007 年 11 月

对符号名的限制如下:

  • 所有符号在应用程序范围内必须唯一。这防止头文件中出现冲突的符号定义。

  • 符号名的有效字符包括 A-Z、a-z、0-9 和下划线 ( _ )。

  • 符号名不能以数字开头,并限制为 247 个字符。

  • 符号名不能包含空格。

  • 符号名不区分大小写,但保留第一个符号定义的大小写。资源编译器/编辑器和 C++ 程序都使用定义符号的头文件来引用在资源文件中定义的资源。对于只有大小写不同的两个符号名,C++ 程序将其视为两个分开的符号,而资源编译器/编辑器将这两个名称视为引用单个符号。

    说明:

    如果不遵循下面概述的标准符号名方案(ID*_[关键字]),并且符号名碰巧与资源脚本编译器已知的关键字相同,那么,当您试图生成资源脚本文件时,将导致生成难以诊断的随机错误。若要防止出现这种情况,请遵守标准命名方案。

符号名具有描述性前缀,这些前缀指示符号名表示的资源或对象种类。这些描述性前缀以文本组合 ID 开头。Microsoft 基础类库 (MFC) 使用下表所示的符号命名约定。

类别

前缀

使用

资源

IDR_ IDD_ IDC_ IDI_ IDB_

快捷键或菜单(和相关或自定义资源)、对话框、游标、图标、位图

菜单项

ID_

菜单项

命令

ID_

命令

控件和子窗口

IDC_

控件

字符串

IDS_

字符串表中的字符串

MFC

AFX_

保留给预定义 MFC 符号

有关将资源添加到托管项目的信息,请参见“.NET Framework 开发员指南”中的应用程序中的资源。有关手动将资源文件添加到托管项目、访问资源、显示静态资源和将资源字符串分配给属性的信息,请参见演练:本地化 Windows 窗体演练:将本地化资源用于 ASP.NET

要求

Win32

请参见

任务

更改符号或符号名 (ID)

参考

符号值限制

预定义符号 ID