C++、MFC变量命名常用前缀（汇总）

目录

• • 匈牙利命名法：
  • 常用前缀：
  • 例子：
  • Windows对象名称缩写：
  • VC常用宏定义命名列表：
  • Microsoft MFC宏命名规范
  • 库标识符命名法
  • 静态库版本命名规范
  • 动态连接库命名规范
  • Windows.h中新的命名规范
  • Reference：

匈牙利命名法：

• 微软推广的一种关于变量、函数、对象、前缀、宏定义等各种类型的符号的命名规范。

匈牙利命名法的主要思想：在变量和函数名中加入前缀以增进人们对程序的理解。
起源：它是由微软内部的一个匈牙利人发起使用的，结果它在微软内部逐渐流行起来，并且推广给了全世界的Windows开发人员。

并不是要求所有的读者都要去遵守，但是希望读者作为一个现代的软件开发人员都去遵守它。
a Array 数组

常用前缀：

b    BOOL (int) 布尔(整数)

by  Unsigned Char (Byte) 无符号字符(字节)

c    Char 字符(字节)

cb  Count of bytes 字节数

cr   Color reference value 颜色(参考)值

cx  Count of x (Short) x的集合(短整数)

dw DWORD(unsigned long) 双字(无符号长整数)

f     Flags (usually multiple bit values) 标志(一般是有多位的数值)

fn   Function 函数

g_  global 全局的

h    Handle 句柄

i     Integer 整数

l     Long 长整数

lp   Long pointer 长指针

m_  Data member of a class 一个类的数据成员

n   Short int 短整数

p   Pointer 指针

s   String 字符串

sz  Zero terminated String 以0结尾的字符串

tm  Text metric 文本规则

u   Unsigned int 无符号整数

ul  Unsigned long (ULONG) 无符号长整数

w  WORD (unsigned short) 无符号短整数

x,y   x, y coordinates (short) 坐标值/短整数

v  void 空

例子：

有关项目的全局变量用g_开始，类成员变量用m_，局部变量若函数较大则可考虑用l_用以显示说明其是局部变量。

前缀	类型	例子
g_	全局变量	g_Servers
C	类或者结构体	CDocument，CPrintInfo
m_	成员变量	m_pDoc，m_nCustomers

VC常用前缀列表：

前缀	类型	描述	例子
ch	char	8位字符	chGrade
ch	TCHAR	16位UNICODE类型字符	chName
b	BOOL	布尔变量	bEnabled
n	int	整型（其大小由操作系统决定）	nLength
n	UINT	无符号整型（其大小由操作系统决定）	nLength
w	WORD	16位无符号整型	wPos
l	LONG	32位有符号整型	lOffset
dw	DWORD	32位无符号整型	dwRange
p *	Ambient memory model pointer	内存模块指针，指针变量	pDoc
lp	long point	长指针	lpDoc
lpsz	LPSTR	32位字符串指针	lpszName
lpsz	LPCSTR	2位常量字符串指针	lpszName
lpsz	LPCTSTR	32位UNICODE类型常量指针	lpszName
h	handle	Windows	对象句柄 hWnd
lpfn	(*fn)()	回调函数指针 Callback Far pointer to CALLBACK function	lpfnAbort

LPSZ的全称：Long Pointer to Zero Terminated String | 中文意思：───长以零结尾的字符串的指针。

SDK： 软件开发工具包（Software Development Kit），一般都是一些被软件工程师用于为特定的软件包、软件框架、硬件平台、操作系统等建立应用软件的开发工具的集合。 

在 Windows 应用程序中， 窗口是通过窗口句柄（ HWND） 来标识的。 我们要对某个窗口进行操作， 首先就要得到这个窗口的句柄。 句柄（ HANDLE） 是 Windows 程序中一个重要的概念， 使用也非常频繁。 在 Windows 程序中， 有各种各样的资源（ 窗口、 图标、光标,画刷等）， 系统在创建这些资源时会为它们分配内存， 并返回标识这些资源的标识号， 即句柄。 在后面的内容中我们还会看到图标句柄（ HICON）、 光标句柄（ HCURSOR） 和画刷句柄（ HBRUSH）。

微软基础类库（英语：Microsoft Foundation Classes，简称MFC）是一个微软公司提供的类库（class libraries），以C++类的形式封装了Windows API，并且包含一个应用程序框架，以减少应用程序开发人员的工作量。

1. Afx 前缀的函数代表应用程序框架（ Application Framework） 函数。 应用程序框架实际上是一套辅助我们生成应用程序的框架模型。该模型把多个类进行了一个有机的集成，可以根据该模型提供的方案来设计我们自己的应用程序。在 MFC 中， 以Afx 为前缀的函数都是全局函数，可以在程序的任何地方调用它们。

CDC 图形设备环境(DC :Device Context)。Windows使用与设备无关的图形设备环境(DC :Device Context) 进行显示 。MFC基础类库定义了设备环境对象类----CDC类。

afx_xxxx: 全局函数，不属于某个类特有的

xxxEx： xxxW, 拓展

Windows对象名称缩写：

Windows对象 例子变量 MFC类 例子对象

HWND hWnd; CWnd* pWnd;
HDLG hDlg; CDialog* pDlg;
HDC hDC; CDC* pDC;
HGDIOBJ hGdiObj; CGdiObject* pGdiObj;
HPEN hPen; CPen* pPen;
HBRUSH hBrush; CBrush* pBrush;
HFONT hFont; CFont* pFont;
HBITMAP hBitmap; CBitmap* pBitmap;
HPALETTE hPalette; CPalette* pPalette;
HRGN hRgn; CRgn* pRgn;
HMENU hMenu; CMenu* pMenu;
HWND hCtl; CStatic* pStatic;
HWND hCtl; CButton* pBtn;
HWND hCtl; CEdit* pEdit;
HWND hCtl; CListBox* pListBox;
HWND hCtl; CComboBox* pComboBox;

VC常用宏定义命名列表：

前缀 符号类型 符号例子 范围

IDR_ 标识多个资源共享的类型 IDR_MAINFRAME 1~0x6FFF
IDD_ 对话框资源（Dialog） IDD_SPELL_CHECK 1~ 0x6FFF
HIDD_ 基于对话框的上下文帮助 HIDD_SPELL_CHECK 0x20001~0x26FF
IDB_ 位图资源（Bitmap） IDB_COMPANY_LOGO 1~0x6FFF
IDC_ 光标资源（Cursor） IDC_PENCIL 1~0x6FFF
IDI_ 图标资源（Icon） IDI_NOTEPAD 1~0x6FFF
ID_、IDM_ 工具栏或菜单栏的命令项 ID_TOOLS_SPELLING 0x8000~0xDFFF
HID_ 命令上下文帮助 HID_TOOLS_SPELLING 0x18000~0x1DFFF
IDP_ 消息框提示文字资源 IDP_INVALID_PARTNO 8~0xDFFF
HIDP_ 消息框上下文帮助 HIDP_INVALID_PARTNO 0x30008~0x3DFFF
IDS_ 字符串资源（String） IDS_COPYRIGHT 1~0x7FFF
IDC_ 对话框内的控制资源 IDC_RECALC 8~0xDFFF

Microsoft MFC宏命名规范

名称 类型

_AFXDLL 唯一的动态连接库（Dynamic Link Library，DLL）版本
_ALPHA 仅编译DEC Alpha处理器
_DEBUG 包括诊断的调试版本
_MBCS 编译多字节字符集
_UNICODE 在一个应用程序中打开Unicode
AFXAPI MFC提供的函数
CALLBACK 通过指针回调的函数

库标识符命名法

标识符 值和含义

u ANSI（N）或Unicode（U）
d 调试或发行：D = 调试；忽略标识符为发行

静态库版本命名规范

库 描述

NAFXCWD.LIB 调试版本：MFC静态连接库
NAFXCW.LIB 发行版本：MFC静态连接库
UAFXCWD.LIB 调试版本：具有Unicode支持的MFC静态连接库
UAFXCW.LIB 发行版本：具有Unicode支持的MFC静态连接库

动态连接库命名规范

名称 类型

_AFXDLL 唯一的动态连接库（DLL）版本
WINAPI Windows所提供的函数

Windows.h中新的命名规范

类型 定义描述

WINAPI 使用在API声明中的FAR PASCAL位置，如果正在编写一个具有导出API人口点的DLL，则可以在自己的API中使用该类型

CALLBACK 使用在应用程序回调程序，如窗口和对话框过程中的FAR PASCAL的位置

LPCSTR 与LPSTR相同，只是LPCSTR用于只读串指针，其定义类似（const char FAR*）
LPCTSTR ： long pointer const  text cstring

UINT 可移植的无符号整型类型，其大小由主机环境决定（对于Windows NT和Windows 9x为32位）；它是unsigned int的同义词

LRESULT 窗口程序返回值的类型

LPARAM 声明lParam所使用的类型，lParam是窗口程序的第四个参数

WPARAM 声明wParam所使用的类型，wParam是窗口程序的第三个参数

LPVOID 一般指针类型，与（void *）相同，可以用来代替LPSTR