Posted on 2008-01-26 13:51
tanzek 閱讀(4696)
評論(0) 編輯 收藏
VC++中的ON_COMMAND_RANGE宏和ON_COMMAND等宏一樣，是用來聲明消息處理函數(shù)的，與
ON_COMMAND不同的是，此宏可用來定義一組消息的處理函數(shù)。
兩個宏的用法是：
ON_COMMAND(id,memberFxn)
ON_COMMAND_RANGE(id1,id2,memberFxn)
看起來其中memberFxn似乎沒有什么差別，但是在學習使用中，發(fā)現(xiàn)ON_COMMAND_RANGE宏中的memberFxn常常會被定義成帶參數(shù)的處理函數(shù)，而ON_COMMAND則是不帶參數(shù)的處理函數(shù)。這就讓我奇怪了，于是查閱MSDN的解釋，循著提供的線索一直查到了《Visual C++ Programmer’s Guide》中的《Handlers for Message-Map Ranges》一章，于是在《Declaring the Handler Function》一節(jié)中找到了答案，引用原文如下：
Handler functions for single commands normally take no parameters. With the exception of update handler functions, handler functions for message-map ranges require an extra parameter, nID, of type UINT. This parameter is the first parameter. The extra parameter accommodates the extra command ID needed to specify which command the user actually chose.?
為了幫助和我一樣不太懂英文的朋友，頂著頭皮翻譯了下：
單個命令（消息）的處理函數(shù)通常不帶參數(shù)。但是更新處理函數(shù)、針對消息映射范圍的處理函數(shù)需要一個額外的參數(shù)，一個UINT類型的nID。此參數(shù)是第一個參數(shù)，這個額外的參數(shù)收集了用來指定用戶真正選擇命令的命令I(lǐng)D。
因此完全可以一個帶參數(shù)的消息處理函數(shù)來接收指定的命令I(lǐng)D，不過這里要提醒朋友一點的是，并不是非得只有一個參數(shù)，可以使用多個參數(shù)的消息處理函數(shù)，如function(WPARAM wParam, LPARAM lParam)，但是真正能夠使用的參數(shù)是第一個參數(shù)wParam，它是用戶選擇的命令I(lǐng)D。
對于更新處理函數(shù)，也存在相對應(yīng)于ON_COMMAND_RANGE的
ON_UPDATE_COMMAND_UI_RANGE宏，它的作用也是處理連續(xù)的范圍(contiguous range)，但是它與ON_COMMAND_RANGE有一點點區(qū)別。通過上面可知，一般范圍處理函數(shù)(ON_COMMAND_RANGE)是通過在處理函數(shù)后面加一個參數(shù)，當消息進行處理時，將會把該命令I(lǐng)D傳至該參數(shù)。而ON_UPDATE_COMMAND_UI_RANGE則使用的是
pCmdUI，一個
CCmdUI的指針類型，它內(nèi)部就包含了一個數(shù)據(jù)成員(m_nID)，用來指向命令I(lǐng)D，具體請參考MSDN中的內(nèi)容。上述內(nèi)容在MSDN中的《
Visual C++ Programmer’s Guide》中的《Handlers for Message-Map Ranges》一章《Example for a Range of Command IDs》一節(jié)中可以找到原文：
Update handler functions for single commands normally take a single parameter, pCmdUI, of type CCmdUI*. Unlike handler functions, update handler functions for message-map ranges do not require an extra parameter, nID, of type UINT. The command ID, which is needed to specify which command the user actually chose, is found in the CCmdUI object.
意思大概也是：
單個命令的更新處理函數(shù)通常只帶一個參數(shù)，即一個CCmdUI指針類型的pCmdUI。不像普通的處理函數(shù)一樣，針對消息映射范圍的更新處理函數(shù)不需要一個額外的UINT參數(shù)nID，這個用來指定用戶真正選擇的命令I(lǐng)D，能夠在CCmdUI對象中找到。