Posted on 2007-03-29 09:28
北緯91℃ 閱讀(452)
評(píng)論(0) 編輯 收藏 引用 所屬分類:
Win32 / MFC / Visual C++
AND_CATCHAND_CATCH
AND_CATCH(exception_class,exception _object_point_name)
說(shuō)明：
定義一個(gè)代碼塊，它用于獲取廢除當(dāng)前TRY塊中的附加異常類型。使用CATCH宏以獲得一個(gè)異常類型，然后使用AND_CATCH宏獲得隨后的異常處理代碼可以訪問(wèn)異常對(duì)象（若合適的話)已得到關(guān)于異常的特別原因的更多消息。在AND_CATCH塊中調(diào)用THROW_LAST宏以便把處理過(guò)程移到下個(gè)外部異常框架。AND_CATCH可標(biāo)記CATCH或AND_CATCH塊的末尾。
注釋：
AND_CATCH塊被定義成為一個(gè)C++作用域（由花括號(hào)來(lái)描述）。若用戶在此作用域定義變量，那么記住他們只在此作用域中可以訪問(wèn)。他也用于exception_object_pointer_name變量。
ASSERT
ASSERT(booleanExpression)
說(shuō)明：
計(jì)算變量的值。如果結(jié)構(gòu)的值為0，那么此宏便打印一個(gè)診斷消息并且成訊運(yùn)行失敗。如果條件為非0，那么什么也不做。 診斷消息的形式為： assertion failed in file in line 其中name是元文件名，num是源文件中運(yùn)行失敗的中斷號(hào)。在Release版中，ASSERT不計(jì)算表達(dá)式的值也就不中斷程序。如果必須計(jì)算此表達(dá)式的值且不管環(huán)境如何那么用VERIFY代替ASSERT。
注釋：
ASSERT只能在Debug版中用
ASSERT_VAILD
ASSERT_VAILD(pObject)
說(shuō)明：
用于檢測(cè)關(guān)于對(duì)象的內(nèi)部狀態(tài)的有效性。ASSERT_VALID調(diào)用此對(duì)象的AssertValid成員函數(shù)（把它們作為自己的變量來(lái)傳遞）。在 Release版中ASSERT_VALID什么也不做。在DEBUG版中，他檢查指針，以不同于NULL的方式進(jìn)行檢查，并調(diào)用對(duì)象自己的 AssertValid成員函數(shù)。如果這些檢測(cè)中有任何一個(gè)失敗的話，那么他會(huì)以與ASSERT相同的方法顯示一個(gè)警告的消息。
注釋：
此函數(shù)只在DEBUG版中有效。
BEGIN_MESSAGE_MAP
BEGIN_MESSAGE_MAP(the class,baseclass)
說(shuō)明：
使用BEGIN_MESSAGE_MAP開始用戶消息映射的定義。在定義用戶類函數(shù)的工具（.cpp）文件中，以BEGIN_MESSAGE_MAP宏開始消息映射，然后為每個(gè)消息處理函數(shù)增加宏項(xiàng)，接著以END_MESSAGE_MAP宏完成消息映射。
CATCH
CATCH(exception_class,exception_object_pointer_name)
說(shuō)明：
使用此用定義一個(gè)代碼塊，此代碼用來(lái)獲取當(dāng)前TRY塊中都一個(gè)異常類型。異常處理代碼可以訪問(wèn)異常對(duì)象，如何合適的話，就會(huì)得到關(guān)于異常的特殊原因的更多消息。調(diào)用THROW_LAST宏以把處理過(guò)程一下一個(gè)外部異常框架，如果exception-class是類CExceptioon,那么會(huì)獲取所有異常類型。用戶可以使用CObject::IsKindOf成員函數(shù)以確定那個(gè)特別異常被排除。一種獲取異常的最好方式是使用順序的AND_CATCH語(yǔ)句，每個(gè)帶一個(gè)不同的異常類型。此異常類型的指針由宏定義，用戶不必定義。
注釋：
此CATCH塊被定義作一個(gè)C++范圍（由花括號(hào)描述）。如用戶在此范圍定義變量，那么它們只在吃范圍內(nèi)可以訪問(wèn)。他還可以用于異常對(duì)象的指針名。
DEBUG_NEW
#define new DEBUG_NEW
說(shuō)明：
幫助查找內(nèi)存錯(cuò)誤。用戶在程序中使用DEBUG_NEW,用戶通常使用new運(yùn)算符來(lái)從堆上分配。在Debug模式下（但定義了一個(gè)DEBUG符號(hào)）， DEBUG_NEW為它分配的每個(gè)對(duì)象記錄文件名和行號(hào)。然后，在用戶使用CMemoryState::DumpAllObjectSince成員函數(shù)時(shí)，每個(gè)以DEBUG_NEW分配的對(duì)象分配的地方顯示出文件名和行號(hào)。 為了使用DEBUG_NEW,應(yīng)在用戶的資源文件中插入以下指令： #define new DEBUG_NEW 一旦用戶插入本指令，預(yù)處理程序?qū)⒃谑褂胣ew的地方插入DEBUG_NEW，而MFC作其余的工作。但用戶編譯自己的程序的一個(gè)發(fā)行版時(shí)， DEBUG_NEW便進(jìn)行簡(jiǎn)單的new操作，而且不產(chǎn)生文件名和行號(hào)消息。
DECLARE_DYNAMIC
DECLARE_DYNAMIC(class_name)
說(shuō)明：
但從CObject派生一個(gè)類時(shí)，此宏增加關(guān)于一個(gè)對(duì)象類的訪問(wèn)運(yùn)行時(shí)間功能。把DECLARE_DYNAMIC宏加入類的頭文件中，然后在全部需要訪問(wèn)詞類對(duì)象的.CPP文件中都包含此模塊。如果像所描述那樣使用DELCARE_DYNAMIC和IMPLEMENT_DYNAMIC宏，那么用戶便可使用 RUNTIME_CLASS宏和CObject::IsKindOf函數(shù)以在運(yùn)行時(shí)間決定對(duì)象類。如果DECLARE_DYNAMIC包含在類定義中，那么IMPLEMETN_DYNAMIC必須包含在類工具中。
DECLARE_DYNCREATE
DECLARE_DYNCREATE(class_name)
說(shuō)明：
使用DECLARE_DYNCRETE宏以便允許CObject派生類的對(duì)象在運(yùn)行時(shí)刻自動(dòng)建立。主機(jī)使用此功能自動(dòng)建立新對(duì)象，例如，但它在串行化過(guò)程中從磁盤讀一個(gè)對(duì)象時(shí)，文件及視圖和框架窗應(yīng)該支持動(dòng)態(tài)建立，因?yàn)榭蚣苄枰詣?dòng)建立它。把DECLARE_DYNCREATE宏加入類的.H文件中，然后在全部需要訪問(wèn)此類對(duì)象的.CPP文件中包含這一模式。如果DECLARE_DYNCREATE包含在類定義中，那么 IMPLEMENT_DYNCREATE必須包含在類工具中。
DECLARE_MESSAGE_MAP
DECLARE_MESSAGE_MAP()
說(shuō)明：
用戶程序中的每個(gè)CCmdTarget派生類必須提供消息映射以處理消息。在類定義的末尾使用DECLARE_MESSAGE_MAP宏。接著，在定義類成員函數(shù)的.CPP文件中，使用BEGIN_MESSAGE_MAP宏，每個(gè)用戶消息處理函數(shù)的宏項(xiàng)下面的列表以及END_MESSAGE_MAP宏。
注釋：
如果在DECLARE_MESSAGE_MAP之后定義任何一個(gè)成員，那么必須為他們指定一個(gè)新存取類型（公共的，私有的，保護(hù)的）。
DECLARE_SERIAL
DECLARE_SERIAL(class_name)
說(shuō)明：
DECLARE_SERIAL 為一個(gè)可以串行化的CObject派生類產(chǎn)生必要的C++標(biāo)題代碼。串行化是把某個(gè)對(duì)象的內(nèi)容從一個(gè)文件讀出和寫入一文件。在.H文件中使用 DECLARE_SERIAL宏，接著在需要訪問(wèn)此類對(duì)象的全部.CPP文件中包含此文件。如果DECLARE_SERIAL包含在類定義中，那么 IMPLEMENT_SERIAL必須包含在類工具中。DECLARE_SERIAL宏包含全部DECLARE_DYNAMIC, IMPLEMENT_DYCREATE的功能。
END_CATCH
END_CATCH
說(shuō)明：
標(biāo)識(shí)最后的CATCH或AND_CATCH塊的末尾。
END_MESSAGE_MAP
END_MESSAGE_MAP
說(shuō)明：
使用END_MESSAGE_MAP宏結(jié)束用戶的消息映射定義
IMPLEMENT_DYNAMIC
IMPLEMENT_DYNAMIC(class_name,base_class_name)
說(shuō)明：
通過(guò)運(yùn)行時(shí)在串行結(jié)構(gòu)中為動(dòng)態(tài)CObject派生類訪問(wèn)類名和位置來(lái)產(chǎn)生必要的C++代碼。在.CPP文件中使用IMPLEMENT_DYNAMIC宏，接著一次鏈接結(jié)果對(duì)象代碼
IMPLEMENT_DYNCREATE
IMPLEMENT_DYNCREATE(class_name,base_class_name)
說(shuō)明：
通過(guò)DECLARE_DYNCREATE宏來(lái)使用IMPLEMENT_DYNCREATE宏，以允許CObject派生類對(duì)象在運(yùn)行時(shí)自動(dòng)建立。主機(jī)使用此功能自動(dòng)建立對(duì)象，例如，但它在串行化過(guò)程中從磁盤讀去一個(gè)對(duì)象時(shí)，他在類工具里加入IMPLEMENT_DYNCREATE宏。若用戶使用 DECLARE_DYNCREATE和IMPLEMENT_DYNCREATE宏,那么接著使用RUNTIME_CLASS宏和CObject:: IsKindOf成員函數(shù)以在運(yùn)行時(shí)確定對(duì)象類。若declare_dyncreate包含在定義中，那么IMPLEMENT_DYNCREATE必須包含在類工具中。
IMPLEMENT_SERIAL
IMPLEMENT_SERIAL(class_name,base_class_name,wSchema)
說(shuō)明：
通過(guò)運(yùn)行時(shí)在串行結(jié)構(gòu)中動(dòng)態(tài)CObject派生類訪問(wèn)類名和位置來(lái)建立必要的C++代碼。在.CPP文件中使用IMPLEMENT_SERIAL宏，然后一次鏈接結(jié)果對(duì)象代碼。
ON_COMMAND
ON_COMMAND(id,memberFxn)
說(shuō)明：
此宏通過(guò)ClassWizard或手工插入一個(gè)消息映射。它表明那個(gè)函數(shù)將從一個(gè)命令用戶接口（例如一個(gè)菜單項(xiàng)或toolbar按鈕）處理一個(gè)命令消息。當(dāng)一個(gè)命令對(duì)象通過(guò)指定的ID接受到一個(gè)Windows WM_COMMAND消息時(shí)，ON_COMMAND將調(diào)用成員函數(shù)memberFxn處理此消息。在用戶的消息映射中，對(duì)于每個(gè)菜單或加速器命令（必須被映射到一個(gè)消息處理函數(shù)）應(yīng)該確實(shí)有一個(gè)ON_COMMAND宏語(yǔ)句。
ON_CONTROL
ON_CONTROL(wNotifyCode,id,memberFxn)
說(shuō)明：
表明哪個(gè)函數(shù)將處理一個(gè)常規(guī)控制表示消息。控制標(biāo)識(shí)消息是那些從一個(gè)控制夫發(fā)送到母窗口的消息。
ON_MESSAGE
ON_MESSAGE(message,memberFxn)
說(shuō)明：
指明哪個(gè)函數(shù)將處理一用戶定義消息。用戶定義消息通常定義在WM_USER到0x7FF范圍內(nèi)。用戶定義消息是那些不是標(biāo)準(zhǔn)Windows WM_MESSAGE消息的任何消息。在用戶的消息映射中，每個(gè)必須被映射到一個(gè)消息處理函數(shù)。用戶定義消息應(yīng)該有一個(gè)ON_MESSAGE宏語(yǔ)句。
ON_REGISTERED_MESSAGE
ON_REGISTERED_MESSAGE(nmessageVarible,memberFxn)
說(shuō)明：
Windows的RegisterWindowsMesage函數(shù)用于定義一個(gè)新窗口消息，此消息保證在整個(gè)系統(tǒng)中是唯一的。此宏表明哪個(gè)函數(shù)處理已注冊(cè)消息。變量nMessageViable應(yīng)以NEAR修飾符來(lái)定義。
ON_UPDATE_COMMAND_UI
ON_UPDATE_COMMAND_UI(id，memberFxn)
說(shuō)明：
此宏通常通過(guò)ClassWizard被插入一個(gè)消息映射，以指明哪個(gè)函數(shù)將處理一個(gè)用戶接口個(gè)更改命令消息。在用戶的消息映射中，每個(gè)用戶接口更改命令（比訊被映射到一個(gè)消息處理函數(shù)）應(yīng)該有一個(gè)ON_UPDATE_COMMAND_UI宏語(yǔ)句。
ON_VBXEVENT
ON_VBXEVENT(wNotifyCode,memberFxn)
說(shuō)明：
此宏通常通過(guò)ClassWizard被插入一個(gè)消息映射，以指明哪個(gè)函數(shù)將處理一個(gè)來(lái)自VBX控制的消息。在用戶的消息映射中每個(gè)被映射到一消息處理函數(shù)的VBX控制消息應(yīng)該有一個(gè)宏語(yǔ)句。
RUNTIME_CLASS
RUNTIME_CLASS(class_name)
說(shuō)明：
使用此宏從c++類民眾獲取運(yùn)行時(shí)類結(jié)構(gòu)。RUNTIME_CLASS為由class_name指定的類返回一個(gè)指針到CRuntimeClass結(jié)構(gòu)。只有以DECLARE_DYNAMIC,DECLARE_DYNCREATE或DECLARE_SERIAL定義的CObject派生類才返回到一個(gè) CRuntimeClass結(jié)構(gòu)的指針。
THROW
THROW(exception_object_pointer)
說(shuō)明：
派出指定的異常。THROW中斷程序的運(yùn)行，把控制傳遞給用戶程序中的相關(guān)的CATCH塊。如果用戶沒有提供CATCH塊，那么控制被傳遞到一個(gè)MFC模塊，他打印出一個(gè)錯(cuò)誤并終止運(yùn)行。
THROW_LAST
THROW_LAST()
說(shuō)明：
此宏允許用戶派出一個(gè)局部建立的異常。如果用戶試圖排除一個(gè)剛發(fā)現(xiàn)的異常，那么一般此異常將溢出并被刪除。使用THROW_LAST,此異常被直接傳送到下一個(gè)CATCH處理程序。
TRACE
TRACE(exp)
說(shuō)明：
把一個(gè)格式化字符串送到轉(zhuǎn)儲(chǔ)設(shè)備，例如，文件或調(diào)試監(jiān)視器，而提供與printf相似的功能。同MS_DOS下C程序的printf一樣，TRACE宏是一個(gè)在程序運(yùn)行時(shí)跟蹤變量值的方便形式。在DEBUG環(huán)境中，TRACE宏輸出到afxDump。在Release版中他不做任何工作。
注釋：
此宏只在MFC的DEBUG版中有效。
TRACE0
TRACE0(exp)
說(shuō)明：
與TRACE 相似，但他把跟蹤字符串放在代碼段中，而不是DGROUP,因此使用少的DGROUP空間。TRACE0是一組跟蹤宏的一個(gè)變體，這些宏可用于調(diào)試輸出。這一組包括TRACE0,TRACE1,TRACE2和TRACE3,這些宏不同在于所取參數(shù)的數(shù)目不同。TRACE0只取一個(gè)格式化字符串并可用于簡(jiǎn)單文本消息。TRACE1取一格式化字符串加上一個(gè)變量——一個(gè)將轉(zhuǎn)儲(chǔ)的變量。同樣，TRACE2,TRACE3分別取2個(gè)或3個(gè)參數(shù)（在格式化字符串之后）。如果用戶以便以了應(yīng)用程序的發(fā)行版，那么它只把數(shù)據(jù)轉(zhuǎn)儲(chǔ)到afxDump。
注釋：
此宏只在MFC的DEBUG中有效。
TRACE1，TRACE2，TRACE3
TRACE1(exp,param1)，TRACE2(exp,param1,param2)，TRACE3(exp,param1,param1,param2,param3)
說(shuō)明：
參見TRACE0
TRY
TRY
說(shuō)明：
使用此宏建立一TRY塊。一個(gè)TRY識(shí)別一個(gè)可排除異常的代碼塊。這些異常在隨后的CATCH和AND_CATCH塊處理。傳遞是允許的：異常可以傳遞一個(gè)外部TRY塊，或者忽略它們或者使用THROW_LAST宏。
VERIFY
VERIFY(booleanExpression)
說(shuō)明：
在MFC 的DEBUG版中，VERIFY宏計(jì)算它的變量值。如果結(jié)果為0，那么宏打印一個(gè)診斷消息并中止程序。如果條件不為0，那么什么工作也不作。診斷有如下形式： assertion failed in file in line 其中name是源文件的名字，num是在源文件中失敗的中止行號(hào)。在MFC的Release版中，VERIFY計(jì)算表達(dá)式值但不打印或中止程序。例如：如果表達(dá)式是個(gè)函數(shù)調(diào)用，那么調(diào)用成功。