天天看點

windows 命名規範

由于一直在命名方面很亂,這次決定好好規範下。

轉載至:http://blog.sina.com.cn/s/blog_52cbfc3f0100fdy6.html

匈牙利命名法是一種程式設計時的命名規範。基本原則是:變量名=屬性+類型+對象描述。其中每一對象的名稱都要求有明确含義,可以取對象名字全稱或名字的一部分。命名要基于容易記憶容易了解的原則。目前在Windows程式開發和MFC程式開發中常用的命名規則是匈牙利命名法。下面就是HN命名法的一般規則。

屬性部分

全局變量 g_

const常量 c_

c++類成員變量 m_

靜态變量 s_

類型部分

指針 p

函數 fn

無效 v

句柄 h

長整型 l

布爾 b

浮點型(有時也指檔案) f

雙字 dw

字元串 sz

短整型 n

雙精度浮點 d

計數 c(通常用cnt)

字元 ch(通常用c)

整型 i(通常用n)

位元組 by

字 w

實型 r

無符号 u

描述部分

最大 Max

最小 Min

初始化 Init

臨時變量 T(或Temp)

源對象 Src

目的對象 Dest

這裡順便寫幾個例子:

(1) hwnd : h 是類型描述,表示句柄, wnd 是變量對象描述,表示視窗,是以 hwnd 表示視窗句柄;

(2) pfnEatApple : pfn 是類型描述,表示指向函數的指針, EatApple 是變量對象描述,是以它表示

指向 EatApple 函數的函數指針變量。

(3) g_cch : g_ 是屬性描述,表示全局變量,c 和 ch 分别是計數類型和字元類型,一起表示變量類

型,這裡忽略了對象描述,是以它表示一個對字元進行計數的全局變量。

小結:匈牙利命名法

MFC、句柄、控件及結構的命名規範 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 hPaltte; CPalette* pPalette;

HRGN hRgn; CRgn* pRgn;

HMENU hMenu; CMenu* pMenu;

HWND hCtl; CState* pState;

HWND hCtl; CButton* pButton;

HWND hCtl; CEdit* pEdit;

HWND hCtl; CListBox* pListBox;

HWND hCtl; CComboBox* pComboBox;

HWND hCtl; CScrollBar* pScrollBar;

HSZ hszStr; CString pStr;

POINT pt; CPoint pt;

SIZE size; CSize size;

RECT rect; CRect rect;

一般字首命名規範 字首 類型執行個體

C 類或結構 CDocument,CPrintInfo

m_ 成員變量 m_pDoc,m_nCustomers

變量命名規範 字首 類型 描述執行個體

ch char 8位字元 chGrade

ch TCHAR 如果_UNICODE定義,則為16位字元 chName

b BOOL 布爾值 bEnable

n int 整型(其大小依賴于作業系統) nLength

n UINT 無符号值(其大小依賴于作業系統) nHeight

w WORD 16位無符号值 wPos

l LONG 32位有符号整型 lOffset

dw DWORD 32位無符号整型 dwRange

p * 指針 pDoc

lp FAR* 遠指針 lpszName

lpsz LPSTR 32位字元串指針 lpszName

lpsz LPCSTR 32位常量字元串指針 lpszName

lpsz LPCTSTR 如果_UNICODE定義,則為32位常量字元串指針 lpszName

h handle Windows對象句柄 hWnd

lpfn callback 指向CALLBACK函數的遠指針

資源類型命名規範 字首 符号類型執行個體 範圍

IDR_ 不同類型的多個資源共享辨別 IDR_MAIINFRAME 1~0x6FFF

IDD_ 對話框資源 IDD_SPELL_CHECK 1~0x6FFF

HIDD_ 對話框資源的Help上下文 HIDD_SPELL_CHECK 0x20001~0x26FF

IDB_ 位圖資源 IDB_COMPANY_LOGO 1~0x6FFF

IDC_ 光标資源 IDC_PENCIL 1~0x6FFF

IDI_ 圖示資源 IDI_NOTEPAD 1~0x6FFF

ID_ 來自菜單項或工具欄的指令 ID_TOOLS_SPELLING 0x8000~0xDFFF

HID_ 指令Help上下文 HID_TOOLS_SPELLING 0x18000~0x1DFFF

IDP_ 消息框提示 IDP_INVALID_PARTNO 8~0xDEEF

HIDP_ 消息框Help上下文 HIDP_INVALID_PARTNO 0x30008~0x3DEFF

IDS_ 串資源 IDS_COPYRIGHT 1~0x7EEF

IDC_ 對話框内的控件 IDC_RECALC 8~0xDEEF

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*)

UINT 可移植的無符号整型類型,它是unsigned int的同義詞

LRESULT 視窗程式傳回值的類型

LPARAM 聲明lParam所使用的類型,lParam是視窗程式的第四個參數

WPARAM 聲明wParam所使用的類型,wParam是視窗程式的第三個參數

LPVOID 一般指針類型,與(void *)相同,可以用來代替LPSTR

匈牙利程式設計命名規則

匈牙利命名法包括與下列命名有關的約定:變量、函數、類型和常量、類。

(1)變量的匈牙利命名法。

應用匈牙利命名法,所有的變量名都應該以字首+名字的形式出現。比如:

char* szName; //以0為結束符的符串,存儲的是名字變量

BOOL bCanExit; //布爾型變量,能退出嗎

DWORD dwMaxCount; //32位雙字變量,最大記數

(2)函數的匈牙利命名法。

與變量的命名不同的是,函數的命名不帶字首,函數中每一個單詞的開頭字母都要大寫。比如:

int ConvertNumber( int ix );

void ShowMessage( char* szMessage );

(3)類型和常量的匈牙利命名法。

所有的類型和常量命名都是大寫字母,比如:

#define MAX_NUM 256

typedef unsigned char UCHAR;

(4)類的匈牙利命名法。

類的命名規則是在名稱前面加上一個字母C,比如:

class CMyClass

{

public:

CMyClass();

~CMyClass();

private:

m_szName;

};

在對類的成員變量命名的時候,一般要在變量名前加上m_字首。一般來說,最好按照此規則來程式設計,這樣在以後讀程式或者修改程式時,能夠更快地了解變量的作用。