第十六章　功能表（一）

功能表簡介

前兩章談到了資源描述檔，介紹了三種資源：圖示、滑鼠游標與位元圖。接下來的幾章將再接再厲，介紹另一種資源，功能表（menu，也有文獻翻譯成選單，大陸翻成菜單）。

功能表的種類

在 Windows 作業系統中，依據出現位置，功能表可分為下列三種：

主功能表（main menu）：也翻譯成主選單、主菜單或頂層功能表（top-level menu），位於標題欄下方，如下面右圖紫框線框住的部分。
系統功能表（system menu）：也稱為系統選單、系統菜單或是視窗功能表（window menu）或控制功能表（control menu）。當使用者把滑鼠游標移到視窗標題欄左邊的圖示上，再按下滑鼠左鍵出現的功能表，如下面左圖的紅色框線框住的功能表。
快捷功能表（shortcut menu）：也叫快捷選單或突現式功能表（popup menu，也翻譯成突現式選單）。當使用者把滑鼠移到工作區任一處，再按下滑鼠右鍵出現的功能表。

一般而言，當視窗建立成功並顯示於螢幕上，主功能表就會出現，是最容易為使用者發現，所以本章的重點在於主功能表，下一章再介紹快捷功能表與系統功能表。

主功能表、子功能表與選項

在功能表上的項目，分為三種：①選項（menuitem）、②彈出選項（pop menu）、③分隔線（separator）。分隔線只是視覺上的作用，用來分類功能表上不同種類的選項。選項及彈出選項的差別在於當使用者選擇選項後，功能表會消失，應用程式就完成該選項所指定的工作；使用者選擇彈出選項時，會出現另一個更詳細的功能表，再供使用者選擇，這種更詳細的功能表稱為「子功能表」（submenu 或 popup menus，也翻成子選單或下拉式功能表）。一般而言，彈出選項右邊有個箭號，表示點擊後會出現子功能表。

像上圖的應用程式，小畫家的主選單包含檔案、編輯、檢視、影像、色彩、說明，它們都是彈出選項，它們可視為第一層功能表。當使用者選擇主功能表中的檢視時，會出現子功能表，為第二層功能表，包含了工具箱、色塊、狀態列、文字工具列、檢視點陣圖等均為選項；而縮放是彈出選項，如果選擇它，又會再出現一個「子功能表」，為第三層功能表。這個子功能表本應是「孫功能表」，但這樣太麻煩了。我們規定，最上層的是主功能表，之後由彈出選項引發的都稱為子功能表。

上面例子中的工具箱、色塊、狀態列、文字工具列等，稱為選項（menuitem），選項具有底下的屬性：

名稱：名稱是顯示在功能表上的字串。有時也可以用位元圖顯示。
選項識別碼（ID）或功能表代碼（menu handle）：分三部分討論：
1. 選項：具有選項識別碼，但沒有選項代碼。當使用者選定某個選項後，系統會發出含有該選項識別碼的 WM_COMMAND 訊息給視窗函式。
2. 彈出選項：沒有選項識別碼，但出現的子功能表具有功能表代碼，主功能表也有功能表代碼。
3. 分隔線僅用於表示視覺上分類效果之用，既沒有識別碼也沒有代碼，更不會發出 WM_COMMAND 訊息。但分隔線占用一個位置。
狀態：選項可以有下面三組狀態：
1. 啟用、禁用、無效的：禁用（inactive）與無效（grayed）的選項都以灰色字串表示，當使用者把滑鼠游標點選時都不會發出 WM_COMMAND 訊息，差別在於禁用的選項不能被選擇。啟用（active）的選項字串以正常顯示，可以被選擇，並且發出 WM_COMMAND。
2. 勾選的、未勾選的：勾選（checked）的選項前會有一個「✔」或「●」的記號，代表使用者已選擇了這個選項。像上圖檢視彈出選項引出的子功能表，工具箱、色塊等選項均為勾選的，表示小畫家會顯示工具箱、色塊。「✔」或「●」的差別在於前者是不互斥的，可勾選多個；後者是互斥的，只能勾選一個。
3. 被選擇的、不被選擇的：當滑鼠游標移到某個選項上時，該選項背景會以高亮度光棒顯示，文字則以反白顯示，則此選項稱為被選擇（selected）的選項；反之則是不被選擇的選項。如右圖的縮放及顯示縮圖。
位置：每一個選項、彈出選項、分隔線都佔有一個位置，這些位置皆由零開始。對主功能表而言，最左邊的位置為零，每向右一項就增加一；對子功能表而言，最上邊的位置為零，每向下一項就增加一。如右圖，紅色字是主功能表各彈出選項的位置，藍色字是檢視子功能表中各選項的位置。

功能表訊息

WM_COMMAND 訊息

有關功能表的訊息很多，其中最重要的是 WM_COMMAND。當使用者以滑鼠點選功能表中的某個已啟用的選項時，會產生 WM_COMMAND 訊息。不過能產生 WM_COMMAND 訊息的不僅僅功能表，子控制項與加速鍵也都能產生 WM_COMMAND 訊息。整理如下表：

事件	wParam		lParam
事件	16～31 位元	0～15 位元	lParam
使用者點擊選項或按下助憶鍵	0	選項識別碼	0
使用者按下加速鍵	1	加速鍵識別碼	0
使用者點擊控制項	通知碼	控制項識別碼	控制項代碼

假如有一個程式，有功能表、助憶鍵、控制項、加速鍵，要區分使用者到底是點選哪一個，查閱上表就能知道。如果使用者點選選項，那麼 WM_COMMAND 中的 lParam 為零，且 wParam 的高字組（即第 16～31 位元）亦為零。程式可以由 WM_COMMAND 中，wParam 的第 0～15 位元，就能知道使用者點選了哪個選項。

WM_INITMENUPOPUP 訊息

當 Windows 即將顯示子功能表時，會產生 WM_INITMENUPOPUP 訊息，此訊息一般情形會交給 DefWindowProc 處理。但是如果要在子功能表中啟用或禁用某些選項，那就要處理 WM_INITMENUPOPUP 訊息。例如文書處理軟體在尚未複製文字前，應該禁用「貼上」選項。WM_INITMENUPOPUP 訊息中的 wParam 是子功能表代碼，lParam 的第 0～15 位元是彈出的子功能表位於第幾個位置，第 16～31 位元是代表是否為系統功能表，如為系統功能表該數值為一，否則為零。

資源描述檔中的功能表

MENU 區塊

建立功能表的方法，最常用的是在資源描述檔中建立 MENU 區塊，MENU 不像 ICON 或 CURSOR 需要用到額外的檔案，它可以直接在資源描述檔中直接以文字描述。MENU 區塊的格式如下︰

MenuTableName   MENU
[optional-statements]
BEGIN
  MENUITEM      text, ID [,option]
  ⁝
END

MenuTableName 是在 1 到 65535 之間的正整數，此為功能表識別碼；但 MenuID 也可以是字串，即為功能表名稱。雖然兩者均可，但在原始程式中，必須相互配合，也就是說如果在資源描述檔中的 MenuID 是正整數，那麼原始程式中載入功能表時也要以相同的正整數為參數呼叫 LoadMenu；反之亦然。

optional-statements 在一對「[」、「]」內代表可以全部省略，也可以是出現下面一種、兩種或全都出現情形：

CHARACTERISTICS dword：定義加速鍵區塊的特徵資料，這資料僅一個雙字組大小，而且只保留在 RES 檔中，在連結之後不會保留在 EXE 檔內。因此這資料只能被資源編輯器或資源編譯器使用，對系統而言沒什麼用途。
LANGUAGE language, sublanguage：指定主要語言與次要語言，直到下一個 LANGUAGE 語句或檔案末端。
VERSION dword：指定版本號碼。

在 BEGIN／END 之間的內容，是每個選項的定義，BEGIN／END 也可以用一對「{」、「}」代替。在 BEGIN／END 或一對大括號之間可以使用兩種敘述：

①、MENUITEM：用於定義一般選項或分隔線，語法如下：

MENUITEM    text, ID [,option]
MENUITEM    SEPARATOR

其中的「text」是以一對引號，也就是兩個「"」包含住的字串，不可使用「'」，此字串會顯示在功能表上面。text 內可以包含「\T」或「\t」字元，在這字元之後的文字會向右對齊，通常用來表示加速鍵。text 也可以包含「&」字元，緊接著「&」之後的字元，會在使用者按下 ALT 鍵之後會出現底線，該字元的按鍵稱為存取鍵。（「\t」與「&」的例子見第十九章）

ID 是選項識別碼，是在 1 到 65535 之間的整數，當使用者選擇此選項後，選項識別碼會隨著 WM_COMMAND 訊息傳送至視窗函式之中。

MENUITEM 最後面的「option」以中括號（[ ]）括住，表示可以省略，如果不省略時可以用下面幾種，若超過一種時以「,」隔開。

CHECKED：會在選項字串之前有個「✔」記號，代表此選項具有「勾選的」屬性。
GRAYED：此選項具有「無效的」屬性。
HELP：只能用於主功能表的彈出選項或選項上，具此屬性者以及其後者，都會顯示在主功能表的右側。
INACTIVE：此選項具有「禁用的」屬性。
MENUBARBREAK：在子功能表中的選項具有 MENUBARBREAK 時，會使子功能表多一行，且由此選項開始顯示於多的一行，且有一鉛錘線分隔於兩行之間。如果是在主功能表的選項具有 MENUBARBREAK，那麼會使主功能表多一列，從這個選項開始都顯示於下一列，且無水平線分隔此二列。
MENUBREAK：與 MENUBARBREAK 幾乎一樣，但行與行之間沒有分隔線。

「MENUITEM SEPARATOR」會在功能表上畫出橫線，代表分隔之意，在分隔線上方與下方的選項所代表的功能並不相關。

②、POPUP：用於定義彈出選項，其語法如下：

POPUP   text[,option]
{
    ⁝
}

當使用者點選彈出選項時，會出現子功能表，子功能表定義在 POPUP 之後的一對大括號內，大括號也能用「BEGIN」和「END」代替。在這對大括號或「BEGIN/END」之間可以是 MENUITEM，也可以是另一個 POPUP。如果是另一個 POPUP，那麼就表示這功能表有好幾層。在 POP 之後的 text 與 option 與前述 MENUITEM 之後的相同。

例子

底下來看兩個完整的 MENU 例子。先來看左邊的例子，它所產生的主功能表在表下面的左圖，注意到 MENU 區塊中，紫紅色的「,CHECKED,MENUBREAK」，使得「黑」選項前有個「✔」記號，同時自這個「黑」選項開始，顯示於子功能表多出的一行。再注意到白色字的「,HELP」使得從「幫助」選項開始顯示在主功能表的右邊。

DRAW2      MENU
{
  MENUITEM "離開",IDM_QUIT
  POPUP    "檢視"
           {
             MENUITEM  "座標",IDM_XY,CHECKED
             MENUITEM  "畫筆顏色",IDM_COLOR,CHECKED
           }
  POPUP    "繪圖"
           {
             MENUITEM   "橢圓",IDM_ELLIPSE
             MENUITEM   "手繪圖",IDM_TRACE,CHECKED
             MENUITEM   "黑",IDM_BLACK,CHECKED,MENUBREAK
             MENUITEM   "紅",IDM_RED
             MENUITEM   "綠",IDM_GREEN
             MENUITEM   "藍",IDM_BLUE
           }
  MENUITEM "幫助",IDM_HELP,HELP
}
DRAW2      MENU
{
  MENUITEM "離開",IDM_QUIT
  POPUP    "檢視"
           {
             MENUITEM  "座標",IDM_XY,CHECKED
             MENUITEM  "畫筆顏色",IDM_COLOR,CHECKED
           }
  POPUP    "繪圖",MENUBARBREAK
           {
             MENUITEM  "橢圓",IDM_ELLIPSE
             MENUITEM  "手繪圖",IDM_TRACE,CHECKED
             MENUITEM  "黑",IDM_BLACK,CHECKED,MENUBARBREAK
             MENUITEM  "紅",IDM_RED
             MENUITEM  "綠",IDM_GREEN
             MENUITEM  "藍",IDM_BLUE
           }
  MENUITEM "幫助",IDM_HELP
}

第二個例子的 MENU 區塊內容如上表右邊，而其產生的主功能表如上面右圖。注意到表中的藍字，「,MENUBARBREAK」，它使得從「黑」選項顯示在下一行，但兩行之間有一條鉛錘線，這點與 MENUBREAK 不同。黃色字的「,MENUBARBREAK」是在第一層功能表，因此使主功能表多了一列，也就是「離開」、「檢視」同一列，而「繪圖」、「幫助」在下一列，但兩列之間無水平線分隔。

上面兩例有些瑕疵，如果使用者用該繪圖程式畫圖，如果選擇黑色畫筆就不可能又同時使用其他色筆，因此上面子功能表中的四種顏色是互斥的，勾選狀態應以●表示。同樣的，橢圓與手繪圖也是互斥的。但小木偶用這兩個例子只是說明 MENU 區塊，勉強一用，實際寫程式時應加以修改。

在程式中載入功能表

載入功能表的三種方法

在資源描述檔中定義好功能表之後，並不是立即就能在程式中看見功能表，還必須在原始程式以某些程式碼載入才能看到功能表，方法有三：

①、在註冊視窗類別時引用功能表。這種方式很單純，在呼叫 RegisterClassEx 之前，直接在 WNDCLASSEX 結構體中的 lpszMenuName 欄位填上資源描述檔中功能表名稱或功能表識別碼即可。例如底下的例子，資源描述檔中定義的功能表為：

DRAW2   MENU
{
    ⁝
}

那麼在原始程式中，引用功能表時，可以使用下面步驟：

.DATA
szMenuName  DB          "DRAW2",0
wc          WNDCLASSEX  <>
    ⁝
.CODE
    ⁝
    lea     rdx,szMenuName
    mov     wc.lpszMenuName,rdx
    invoke  RegisterClassEx,ADDR wc

更簡單的方法是，在資源描述檔定義功能表時，不使用字串作為功能表名稱，而改用功能表識別碼。因為功能表識別碼是一個 1 至 65535 之間的整數，所以在原始程式中，只需把 wc.lpszMenuName 之值成改該整數即可。

②、在建立視窗時引用功能表。這種方式是在呼叫 CreateWindowEx 建立視窗之前，先呼叫 LoadMenu API 取得資源描述檔中的功能表代碼，然後將此功能表代碼做為 CreateWindowEx 的第十個參數。例如底下的例子，假設資源描述檔中定義的功能表跟上面方式一樣，而原始程式中則是寫成下面的樣子：

.DATA
szMenuName  DB          "DRAW2",0
hMenu       HMENU       ?
    ⁝
.CODE
    ⁝
    invoke  LoadMenu,hInstance,ADDR szMenuName
    mov     hMenu,rax
    invoke  CreateWindowEx,0,OFFSET szClassName,OFFSET szAppName,WS_OVERLAPPEDWINDOW,0,\
            0,400,400,0,hMenu,hInstance,0

③、假如不在上面①、②情況中引用功能表，也可以在處理 WM_CREATE 訊息時呼叫 SetMenu API 引用功能表。例如底下的例子：

.DATA
szMenuName  DB          "DRAW2",0
hMenu       HMENU       ?
    ⁝
.CODE
    ⁝
  .elseif uMsg==WM_CREATE
    invoke  LoadMenu,hInstance,ADDR szMenuName
    mov     hMenu,rax
    invoke  SetMenu,hWnd,hMenu

上面已經說完用三種方式載入功能表，但其中有些 Win64 API 未曾介紹，底下就這些以及稍後範例會使用到的 Win64 API 加以說明。

LoadMenu API

LoadMenu API 從可執行檔中的資源載入功能表，其語法是：

invoke  LoadMenu,\
        hInstance,\     ; handle of application instance
        lpMenuName      ; menu name string or menu-resource identifier

hInstance 是模組代碼，是呼叫 GetModuleHandle API 後的回傳值。lpMenuName 是功能表名稱的位址或是功能表識別碼，不論哪一種，都必須與資源描述檔中的選項名稱或功能表識別碼一樣。如果呼叫成功，那麼 LoadMenu 的回傳值是功能表代碼；如果失敗，傳回 0。

SetMenu API

SetMenu API 為視窗指定某個功能表，其語法如下：

invoke  SetMenu,\
        hWnd,\          ; handle of window
        hMenu           ; handle of menu

hWnd 是視窗代碼，若成功執行 SetMenu 後此視窗會顯示功能表，而 hMenu 即為顯示的功能表之代碼。SetMenu 的回傳值為零，表示呼叫失敗；若為非零，表示呼叫成功。

如果該視窗本身已有功能表，那麼參數 hMenu 所指定功能表會取代原有的功能表，但原有的功能表並沒有銷毀。必須呼叫 DestroyMenu 才能使功能表銷毀。

GetSubMenu API

呼叫 LoadMenu 時，由資源載入的功能表包含了主功能表與子功能表，但 LoadMenu 只能傳回主功能表代碼。如果要獲得子功能表代碼，必須呼叫 GetSubMenu，GetSubMenu 的語法是：

invoke  GetSubMenu,\
        hMenu,\         ; handle of menu
        nPos            ; menu item position

hMenu 是上層功能表的功能表代碼，如果要獲得「孫功能表」的功能表代碼，那麼這個 hMenu 就應該是「子功能表」的功能表代碼。nPos 是子功能表所在位置，由零開始，如有分隔線也算一個。如果呼叫成功，GetSubMenu 的回傳值即為子功能表的功能表代碼；如果失敗，例如該位置不是子功能表，則回傳值為零。

CheckMenuItem API

CheckMenuItem 是用來設定功能表內的選項為「勾選的」還是「未勾選的」，通常用在不具互斥的選項上，也就是可以選擇超過一個的情形，因此在選項前出現的是「✔」。雖然微軟已宣布它被功能更多的 SetMenuItemInfo 取代，但如果只是單純地改變選項勾選狀態的話，呼叫 CheckMenuItem API 還是非常方便的。CheckMenuItem 的語法是：

invoke  CheckMenuItem,\
        hMenu,\         ; handle to menu
        uIDCheckItem,\  ; menu item to check or uncheck
        uCheck          ; menu item flags

hMenu 是要改變勾選狀態選項所在的功能表代碼。uIDCheckItem 是要改變勾選狀態選項之選項識別碼或是選項位置，到底是選項識別碼，還是選項位置，由第三個參數決定。

第三個參數，uCheck 可以是 MF_BYCOMMAND 或 MF_BYPOSITION 其中之一，與 MF_CHECKED 或 MF_UNCHECKED 其中之一搭配的組合。說明如下：

MF_BYCOMMAND 或 MF_BYPOSITION：此二者只能二選一，MF_BYCOMMAND 代表 uIDCheckItem 是選項識別碼，如果 uCheck 沒有指定的話，此為預設值；MF_BYPOSITION 代表 uIDCheckItem 是選項位置，選項位置是由零開始，如有分隔線也算一個。
MF_CHECKED 或 MF_UNCHECKED：此二者只能二選一，MF_CHECKED 代表要把選項設成勾選的；MF_UNCHECKED 代表把選項設成未勾選的。

CheckMenuRadioItem API

CheckMenuRadioItem 可以在子功能表內，指定數個連續的選項為一組，而設定其中的某一選項為勾選的，而其他選項設為未勾選的。指定的一組選項，可以依據選項位置，也可以依據選項識別碼。因為只能指定其中某一項為勾選的，所以常用於具有互斥的選項，在勾選的選項前出現的是「●」記號。

invoke  CheckMenuRadioItem,\
        hMenu,\         ; handle to menu
        idFirst,\       ; identifier or position of the first menu item
        idLast,\        ; identifier or position of the last menu item
        idCheck,\       ; identifier or position of the menu item to check
        uFlags          ; menu item flags

hMenu 是要改變勾選狀態選項所在的子功能表代碼。idFirst、idLast 分別是指定一組連續選項的第一個和最後一個選項。idCheck 是指定一組選項內的哪一個選項要設為勾選的。uFlags 可以是 MF_BYCOMMAND 或 MF_BYPOSITION 其中之一，前者代表 idFirst、idLast、idCheck 代表選項識別碼，後者代表該三者為選項位置。

如果 CheckMenuRadioItem 執行成功，回傳值為非零；如果失敗，回傳值為 0。

Ellipse API

Ellipse 是用來繪製橢圓的，繪製方式是指定兩個點，這兩個點構成一個矩形（矩形就是長方形），此矩形的長與水平線平行、高與鉛錘線平行的矩形。而此矩形並不會畫出來，要畫出來的橢圓就是該矩形的內切橢圓，所以繪製出來的橢圓長軸、短軸也會與水平線和鉛錘線平行。由上面就能知道，要經由 Ellipse 畫出橢圓，必須指定此外切矩形的左上角與右下角座標，所以 Ellipse 的語法如下，也就不奇怪了。

invoke  Ellipse,\
        hdc,\           ; handle to device context
        nLeftRect,\     ; x-coord. of bounding rectangle's upper-left corner
        nTopRect,\      ; y-coord. of bounding rectangle's upper-left corner
        nRightRect,\    ; x-coord. of bounding rectangle's lower-right corner
        nBottomRect     ; y-coord. bounding rectangle's f lower-right corner

nLeftRect、nTopRect 分別是矩形的左上角 X、Y 座標，nRightRect、nBottomRect 則是矩形的右下角 X、Y 座標。雖然這四個參數，指名矩形的左上角及右下角，但實際上也可以是左下角與右上角。Ellipse 會以當前畫筆繪出橢圓輪廓，同時以當前畫刷塗滿橢圓內部區域。如果 Ellipse 成功畫出橢圓，傳回非零值；如果失敗，傳回零值。

下面右圖是 Ellipse 畫出的藍色橢圓，也是這一章的例子，DRAW2，執行的結果。下面右圖中的紅色矩形是 Ellipse 第二～五個參數所指定的，為橢圓的外切矩形，實際上並不會畫出來，Ellipse 也不會顯示左上角、及右下角的座標及點。

範例：DRAW2

這一章的例子是 DRAW2，執行結果如上面左圖。主功能表上有四個選項，離開、檢視、繪圖、幫助，只有「檢視」、「繪圖」是彈出選項，另外兩個則是一般選項。「幫助」選項在標題欄上靠右對齊，所以「幫助」選項的「option」是「HELP」。

在檢視子功能表中，有兩個選項：座標、畫筆顏色。顧名思義，選擇座標就會在工作區顯示滑鼠游標所在位置的座標，再選一次就不顯示。點選畫筆顏色，會顯示使用者當前選擇的畫筆顏色，再選一次則不顯示。預設是顯示座標及畫筆顏色，且它們之間沒有互斥的關係，因此這兩個選項前有「✔」記號。

使用者點選繪圖選項時，可以選擇畫橢圓還是手繪圖，也可以選擇使用黑、紅、綠、藍哪一種顏色畫圖。如果選擇四色中的任一色，不僅之後繪出的圖形變為該種顏色，滑鼠游標也會變成該種色筆形狀的游標，見上面右圖滑鼠游標已變為藍筆形狀的游標。DRAW2 一開始時預設是手繪圖與黑色，這兩個選項前有「●」的記號，當使用者選擇別種選項時，「●」記號就會變成在該選項之前。

資源描述檔名稱為「E:\HP\SOURCE\W64\DRAW\DRAW2.RC」，內容如下：

#define IDM_QUIT 3000

#define IDM_XY 3001

#define IDM_COLOR 3002

#define IDM_ELLIPSE 3003

#define IDM_TRACE 3004

#define IDM_BLACK 3005

#define IDM_RED 3006

#define IDM_GREEN 3007

#define IDM_BLUE 3008

#define IDM_HELP 3009

#define IDCUR_BLKPEN 6000

#define IDCUR_REDPEN 6001

#define IDCUR_GRNPEN 6002

#define IDCUR_BLUPEN 6003

DRAW2 MENU

{

MENUITEM "離開",IDM_QUIT

POPUP "檢視"

{

MENUITEM "座標",IDM_XY,CHECKED

MENUITEM "畫筆顏色",IDM_COLOR,CHECKED

}

POPUP "繪圖"

{

MENUITEM "橢圓",IDM_ELLIPSE

MENUITEM "手繪圖",IDM_TRACE /* 預設手繪圖 */

MENUITEM SEPARATOR

MENUITEM "黑",IDM_BLACK /* 預設黑筆 */

MENUITEM "紅",IDM_RED

MENUITEM "綠",IDM_GREEN

MENUITEM "藍",IDM_BLUE

}

MENUITEM "幫助",IDM_HELP,HELP /* HELP使「幫助」字樣在主功能表右邊 */

}

DRAW2 ICON "DRAW2.ICO" /* 圖示 */

/* 以下游標檔下載位址：https://www.cursors-4u.com/pencil/ */

IDCUR_BLKPEN CURSOR "blkpen.cur" /* 黑筆形狀的游標 */

IDCUR_REDPEN CURSOR "redpen.cur" /* 紅筆形狀的游標 */

IDCUR_GRNPEN CURSOR "grnpen.cur" /* 綠筆形狀的游標 */

IDCUR_BLUPEN CURSOR "blupen.cur" /* 藍筆形狀的游標 */

原始程式名稱為「E:\HP\SOURCE\W64\DRAW\DRAW2.ASM」，內容如下：

OPTION CASEMAP:NONE

OPTION WIN64:7

INCLUDE WINDOWS.INC

INCLUDELIB GDI32.LIB

INCLUDELIB KERNEL32.LIB

INCLUDELIB USER32.LIB

IDM_QUIT EQU 3000

IDM_XY EQU 3001

IDM_COLOR EQU 3002

IDM_ELLIPSE EQU 3003

IDM_TRACE EQU 3004

IDM_BLACK EQU 3005

IDM_RED EQU 3006

IDM_GREEN EQU 3007

IDM_BLUE EQU 3008

IDM_HELP EQU 3009

IDCUR_BLKPEN EQU 6000

IDCUR_REDPEN EQU 6001

IDCUR_GRNPEN EQU 6002

IDCUR_BLUPEN EQU 6003

;*****************************************************************************************

.CONST

szMenuName LABEL BYTE

szIconName LABEL BYTE

szClassName DB "DRAW2",0

szAppName DB "超簡單繪圖",0

szText DB "DRAW2僅能繪製橢圓與手繪圖",0dh,0ah,"，且不能存檔也不能編輯。",0

szMouseFmt DB "(%03d,%03d)",0

szColor DB "黑色紅色綠色藍色"

szClear DB 5 DUP ("　")

;*****************************************************************************************

.DATA

hInstance DQ ? ;模組代碼

hwnd HWND ? ;視窗代碼

hMenu HMENU ? ;主功能表代碼

hViewSubMenu HMENU ? ;檢視子功能表代碼

hDrawSubMenu HMENU ? ;繪圖子功能表代碼

pCursor DQ 0 ;哪種顏色的畫筆，也代表哪一種游標，預設黑筆及黑筆形狀游標

hCursor HCURSOR 4 DUP(?);四種游標的代碼，依序是黑筆、紅筆、綠筆、藍筆形狀的游標

hPen HPEN 4 DUP(?);四種顏色的畫筆代碼，依序是黑筆、紅筆、綠筆、藍筆

draw_what DQ 1 ;要畫什麼：0－橢圓、1－手繪圖(預設)

line_pen DQ 0 ;畫手繪圖時畫筆的狀態：0－提起畫筆，1－放下畫筆

ellips_pen DQ 0 ;畫橢圓步驟：0－第一點未確定，1－第二點未確定，2－畫出來

fXy DQ 1 ;是否於工作區顯示座標：0－不顯示，1－顯示

fColor DQ 1 ;是否於工作區顯示畫筆顏色：0－不顯示，1－顯示

line_start POINT <> ;起點

line_end POINT <> ;終點

lt_rect POINT <> ;繪製橢圓時，橢圓外切矩形的左上角座標

rb_rect POINT <> ;繪製橢圓時，橢圓外切矩形的右下角座標

mouse POINT <> ;滑鼠游標所在座標，當fXy為一時顯示在工作區左上角

cyChar DD ? ;字元高度

;*****************************************************************************************

.CODE

;-----------------------------------------------------------------------------------------

WndProc PROC hWnd:HWND,uMsg:UINT,wParam:WPARAM,lParam:LPARAM

LOCAL ps:PAINTSTRUCT,rect:RECT,buffer[64]:BYTE,tm:TEXTMETRIC

.switch uMsg

.case WM_PAINT

invoke BeginPaint,hWnd,ADDR ps

mov rax,pCursor ;改變畫筆

lea r10,hPen[rax*8] ;R10＝畫筆代碼所在位址

invoke SelectObject,ps.hdc,QWORD PTR [r10]

;當fXy=1時，顯示滑鼠座標

.if fXy==1

invoke wsprintf,ADDR buffer,OFFSET szMouseFmt,mouse.x,mouse.y

lea r9,buffer

.else

mov r9,OFFSET szClear

mov eax,SIZEOF szClear

.ENDIF

invoke TextOut,ps.hdc,0,0,r9,eax

;當fColor=1時，顯示畫筆顏色

.if fColor==1

mov r10,pCursor

lea r9,szColor[r10*4]

.else

mov r9,OFFSET szClear

.endif

invoke TextOut,ps.hdc,0,cyChar,r9,4

;當draw_what=0時，繪製橢圓；當draw_what=1時，手繪圖

.if (draw_what==0)&&(ellips_pen==2)

invoke Ellipse,ps.hdc,lt_rect.x,lt_rect.y,rb_rect.x,rb_rect.y

sub ellips_pen,2

.elseif draw_what==1

.if line_pen==1

invoke MoveToEx,ps.hdc,line_start.x,line_start.y,0

invoke LineTo,ps.hdc,line_end.x,line_end.y

mov r10d,line_end.x

mov r11d,line_end.y

xchg line_start.x,r10d

xchg line_start.y,r11d

.endif

invoke EndPaint,hWnd,ADDR ps

.case WM_MOUSEMOVE

mov r8,r9

shr r9,10h

and r8,0ffffh

mov line_end.x,r8d ;把像素的X座標存於line_end.x

mov line_end.y,r9d ;把像素的Y座標存於line_end.y

mov mouse.x,r8d

mov mouse.y,r9d

invoke InvalidateRect,hWnd,0,0 ;對本身發出WM_PAINT訊息

.case WM_LBUTTONDOWN

mov r8,r9

shr r9,10h ;R9＝Y座標

and r8,0ffffh ;R8＝X座標

.if draw_what==0

.if ellips_pen==0

mov lt_rect.x,r8d

mov lt_rect.y,r9d

inc ellips_pen

.elseif ellips_pen==1

mov rb_rect.x,r8d

mov rb_rect.y,r9d

inc ellips_pen

invoke InvalidateRect,hWnd,0,0

.endif

.elseif draw_what==1

.if line_pen==0

mov line_start.x,r8d;把起點的X座標存於line_start.x

mov line_start.y,r9d;把起點的Y座標存於line_start.y

.endif

xor line_pen,1

.endif

.case WM_SETCURSOR

mov rax,pCursor

lea r10,hCursor[rax*8]

invoke SetCursor,QWORD PTR [r10]

.case WM_COMMAND

mov line_pen,0

mov ellips_pen,0

.if r8w==IDM_QUIT

jmp quit

.elseif r8w==IDM_HELP

invoke MessageBox,hWnd,OFFSET szText,OFFSET szAppName,MB_OK or MB_ICONQUESTION

.elseif r8w==IDM_ELLIPSE

mov draw_what,0

invoke CheckMenuRadioItem,hDrawSubMenu,0,1,0,MF_BYPOSITION

.elseif r8w==IDM_TRACE

mov draw_what,1

invoke CheckMenuRadioItem,hDrawSubMenu,0,1,1,MF_BYPOSITION

.elseif r8w==IDM_XY

mov r8d,MF_UNCHECKED or MF_BYPOSITION

xor fXy,1

jz @f

mov r8d,MF_CHECKED or MF_BYPOSITION

@@: invoke CheckMenuItem,hViewSubMenu,0,r8d

.elseif r8w==IDM_COLOR

mov r8d,MF_UNCHECKED or MF_BYPOSITION

xor fColor,1

jz @f

mov r8d,MF_CHECKED or MF_BYPOSITION

@@: invoke CheckMenuItem,hViewSubMenu,1,r8d

.elseif r8w>=IDM_BLACK

movzx r10,r8w

mov r9,r8

sub r10,IDM_BLACK

mov pCursor,r10

invoke CheckMenuRadioItem,hDrawSubMenu,IDM_BLACK,IDM_BLUE,r9d,MF_BYCOMMAND

.endif

.case WM_CREATE

;建立四色畫筆並將其代碼依序存入hPen陣列中

invoke CreatePen,PS_SOLID,1,0

mov hPen,rax

invoke CreatePen,PS_SOLID,1,0ffh

mov hPen[8],rax

invoke CreatePen,PS_SOLID,1,0ff00h

mov hPen[16],rax

invoke CreatePen,PS_SOLID,1,0ff0000h

mov hPen[24],rax

;載入四色畫筆形狀的游標，並將其代碼存入hCursor陣列中

invoke LoadCursor,hInstance,IDCUR_BLKPEN

mov hCursor,rax

invoke LoadCursor,hInstance,IDCUR_REDPEN

mov hCursor[8],rax

invoke LoadCursor,hInstance,IDCUR_GRNPEN

mov hCursor[16],rax

invoke LoadCursor,hInstance,IDCUR_BLUPEN

mov hCursor[24],rax

;獲得檢視子功能表代碼及繪圖子功能表代碼，分別存於hViewSubMenu、hDrawSubMenu

invoke GetSubMenu,hMenu,1

mov hViewSubMenu,rax

invoke GetSubMenu,hMenu,2

mov hDrawSubMenu,rax

;將繪圖子功能表中的手繪圖選項和黑色選項前顯示圓點的勾選記號

invoke CheckMenuRadioItem,hDrawSubMenu,0,1,1,MF_BYPOSITION

invoke CheckMenuRadioItem,hDrawSubMenu,IDM_BLACK,IDM_BLUE,IDM_BLACK,MF_BYCOMMAND

;獲得一行文字高度，並存於cyChar中

invoke GetDC,hWnd

mov ps.hdc,rax

invoke GetTextMetrics,ps.hdc,ADDR tm

mov r11d,tm.tmHeight

add r11d,tm.tmExternalLeading

mov cyChar,r11d

invoke ReleaseDC,hWnd,ps.hdc

.case WM_DESTROY

quit: invoke PostQuitMessage,0

.default

invoke DefWindowProc,hWnd,uMsg,wParam,lParam

ret

.endsw

xor rax,rax

ret

WndProc ENDP

;-----------------------------------------------------------------------------------------

main PROC

LOCAL wc:WNDCLASSEX,msg:MSG

invoke GetModuleHandle,0

mov hInstance,rax

mov wc.cbSize,SIZEOF WNDCLASSEX

mov wc.style,CS_HREDRAW or CS_VREDRAW

lea rdx,WndProc

mov wc.lpfnWndProc,rdx

mov wc.cbClsExtra,0

mov wc.cbWndExtra,0

mov wc.hInstance,rax

invoke LoadIcon,hInstance,OFFSET szIconName

mov wc.hIcon,rax

mov wc.hIconSm,rax

mov wc.hbrBackground,COLOR_WINDOW+1

mov wc.lpszMenuName,0

lea rdx,szClassName

mov wc.lpszClassName,rdx

invoke RegisterClassEx,ADDR wc

invoke LoadMenu,hInstance,OFFSET szMenuName ;載入選單

mov hMenu,rax

invoke CreateWindowEx,0,ADDR szClassName,ADDR szAppName,WS_OVERLAPPEDWINDOW,\

50,50,500,375,0,hMenu,hInstance,0

mov hwnd,rax

invoke ShowWindow,hwnd,SW_SHOWNORMAL

invoke UpdateWindow,hwnd

.while TRUE

invoke GetMessage,ADDR msg,0,0,0

.break .if rax==0

invoke TranslateMessage,ADDR msg

invoke DispatchMessage,ADDR msg

.endw

invoke ExitProcess,0

main ENDP

;*****************************************************************************************

END main

將上面兩個純文字檔儲存於磁碟裏的同一子目錄後，依下面方式組譯及連結：

Microsoft Windows [版本 6.1.7601]
Copyright (c) 2009 Microsoft Corporation.  All rights reserved.

C:\Users\wanker>uasm [Enter] →執行 UASM.BAT 批次檔，設定組譯及連結環境，省了許多打字輸入

C:\Users\wanker>SET INCLUDE=C:\UASM\Include

C:\Users\wanker>SET LIB=C:\UASM\lib64

C:\Users\wanker>SET PATH=C:\UASM;C:\UASM\bin64;C:\Windows\system32;C:\Windows;C:
\Windows\System32\Wbem;C:\Windows\System32\WindowsPowerShell\v1.0\;C:\Program Fi
les (x86)\UltraEdit-32

C:\Users\wanker>E:

E:\>CD E:\HOMEPAGE\SOURCE\WIN64
LINK=/SUBSYSTEM:WINDOWS /DEBUG →到此 UASM.BAT 已執行完畢

E:\HomePage\SOURCE\Win64>cd DRAW [Enter] →設定 DRAW2.ASM 所在子目錄為當前目錄

E:\HomePage\SOURCE\Win64\DRAW>uasm64 -win64 DRAW2.ASM [Enter] →組譯
UASM v2.56, Oct 27 2022, Masm-compatible assembler.
Portions Copyright (c) 1992-2002 Sybase, Inc. All Rights Reserved.
Source code is available under the Sybase Open Watcom Public License.

DRAW2.ASM: 252 lines, 3 passes, 771 ms, 0 warnings, 0 errors →沒有錯誤，成功組譯完成

E:\HomePage\SOURCE\Win64\DRAW>rc draw2.rc [Enter] →編譯資源描述檔
Microsoft (R) Windows (R) Resource Compiler Version 10.0.10011.16384
Copyright (C) Microsoft Corporation.  All rights reserved.
    →沒有訊息，代表編譯成功並生成 DRAW2.RES 資源檔

E:\HomePage\SOURCE\Win64\DRAW>link DRAW2.OBJ DRAW2.RES /LARGEADDRESSAWARE:NO [Enter] →連結
Microsoft (R) Incremental Linker Version 14.25.28614.0
Copyright (C) Microsoft Corporation.  All rights reserved.

/SUBSYSTEM:WINDOWS /DEBUG →沒有訊息，代表DRAW2.EXE 成功製作好了

E:\HomePage\SOURCE\Win64\DRAW>

組譯與連結的過程與前幾章類似，不多做敘述，不同之處僅一處。那就是在連結時，必須下達「/LARGEADDRESSAWARE:NO」選項，如果沒有這個選項，連結器會告訴你發生錯誤，必須加上它。加上這選項的原因稍後解釋。

解說 DRAW2

定義游標代碼陣列與其指標

執行 DRAW2 後，使用者可以在「繪圖」子功能表中，於黑、紅、綠、藍四色之中選擇一種，改變之後繪出圖形的顏色，及改變滑鼠游標為該種色筆形狀的游標。也就是說，使用者選藍色，滑鼠游標變藍筆形狀的游標，而後畫出的橢圓或手繪圖都是藍色。

在 DRAW2.ASM 裏，把四種色筆形狀的滑鼠游標之游標代碼，組成含有四個元素的陣列（array），這個陣列定義在 DRAW2.ASM 的第 41 行，稱為 hCursor，其第零、一、二、三個元素分別是黑筆、紅筆、綠筆、藍筆形狀的游標之游標代碼。

在第 40 行，還定義了一個變數，pCursor，它其實是指標，代表使用者選擇 hCorsor 陣列中的第幾個元素，由零開始。換句話說，當 pCursor 為零時，代表使用者選擇第零個元素，也就是黑筆形狀的游標；當 pCursor 為一時，代表使用者選擇第一個元素，也就是紅筆形狀的游標……其餘依此類推。因為 DRAW2 預設是黑色，所以 pCursor 預設值是 0。如果使用者在功能表裏改變顏色，pCursor 之值也會改變，但只能是 0～3 之間的整數。底下第 40～41 行定義了 pCursor 變數及 hCursor 陣列：

pCursor     DQ      0       ;哪種游標，預設是黑筆的游標形狀
hCursor     HCURSOR 4 DUP(?);四種游標的代碼，依序是黑筆、紅筆、綠筆、藍筆形狀的游標

hCursor 陣列中的四個游標代碼，都是在處理 WM_CREATE 訊息時，呼叫 LoadCursor 由資源中載入並將獲得的代碼存入對應的元素中，見第 179～187 行。另外，HCURSOR 是資料類型，事實上就是 DQ 或 QWORD。

那麼，DEAW2 又是如何將使用者所選擇的顏色，變為 pCursor 之值呢？這段過程是在使用者選定選項時，處理 WM_COMMAND 訊息發生的。

處理 WM_COMMAND 訊息

DRAW2.ASM 第 136～167 行用來處理 WM_COMMAND 訊息。DRAW2 沒有快速鍵及控制項，情況單純，如果視窗函式收到 WM_COMMAND 訊息，那麼，必是使用者點選功能表中的選項所致。當使用者點選功能表時，DRAW2 假設不論是繪製橢圓還是手繪圖，都重新開始，因此第 137～138 行，將 line_pen、ellips_pen 均設為 0。

WM_COMMAND 訊息中 wParam 的低字組保存著使用者點選的選項識別碼，而 wParam 是視窗函式的第三個參數。當 Windows 作業系統將 WM_COMMAND 訊息發送到視窗函式 WndProc 時，wParam 之值就已存於 R8 暫存器裏，換句話說，R8W 裏就是選項識別碼。所以接下來只需用 .if/.elseif/.endif 檢查 R8W 之值，即可知道使用者點選的哪一個選項。

例如第 139～140 行，是處理使用者按下主選單的離開選項，R8W 便是 IDM_QUIT，那麼就退出程式，跳躍至處理 WM_DESTROY 訊息之處，也就是 quit: 標記處，結束程式。IDM_QUIT 是主功能表中，離開選項的識別碼，分別定義在 DRAW2.ASM 及 DRAW2.RC 中的第 9 行及第一行，其值均為 3000。

當使用者更換顏色時，R8W 必定會大於或等於 IDM_BLACK，表示。本來應該是每種顏色分開來處理，但這樣會增加程式碼。因為不管哪一種顏色，處理方式大同小異，所以一起處理。處理過程分成兩步驟：改變 pCursor 並設定新的滑鼠游標，然後設定新顏色的勾選狀態。底下先說第一步。

第一步在 DRAW2.ASM 的第 162～165 行。這四色選項之識別碼依序是 IDM_BLACK、IDM_RED、IDM_GREEN、IDM_BLUE，其值由 3005 至 3008，因此將存於 R8W 的選項識別碼減去 IDM_BLACK 就是新的 pCursor。例如，使用者選了綠色，那麼 R8W 之值是 IDM_GREEN，也就是 3007，減去 IDM_BLACK（IDM_BLACK 等於 3005），就變成 2；此數值就是新的 pCursor，也恰好對應到 hCursor 陣列中的第二個元素，綠筆形狀的游標。

第二步改變顏色勾選狀態，見第 166 行。因為選擇了某種顏色就不可能是其他種顏色，例如使用者選了綠色，就不可能是黑、紅、藍三色，像這種具有互斥特性的勾選狀態，一般呼叫 CheckMenuRadioItem 來完成，非常方便。但即使完成這兩步驟，也僅僅是把 pCursor 設為使用者選擇 hCursor 陣列中的正確元素而已，螢幕上並未真正改變所選色筆形狀的游標，要達此目的要處理 WM_SETCURSOR 訊息。

處理 WM_SETCURSOR

前面曾提過，每當移動滑鼠時，系統會發出 WM_SETCURSOR 訊息以重繪滑鼠游標。如果視窗函式不處理 WM_SETCURSOR 訊息，那麼會由 DefWindowProc 處理，而 DefWindowProc 處理方式是以註冊視窗類別時，WNDCLASSEX 結構體中的 hCursor 欄位之游標代碼來繪製游標。

為了讓 DRAW2 能依使用者的選擇變換游標，因此 DRAW2 的視窗函式得自行處理 WM_SETCURSOR 訊息，見第 131～134 行。這幾行的功能就是依據 pCursor 取出在 hCursor 陣列中的四種游標代碼中的一個。這四行指令是：

 .case WM_SETCURSOR
        mov     rax,pCursor
        lea     r10,hCursor[8*rax]
        invoke  SetCursor,QWORD PTR [r10]

其中的最後兩行涉及間接定址，間接定址有許多種，在第二章介紹了其中的兩種，此處再介紹兩種，附錄二介紹最後兩種。

間接定址：暫存器乘以二的冪方與暫存器乘以二的冪方加偏移位址

⑶、第三種的形式為：

[ reg*n ]

此處的 reg 是 64 位元的通用暫存器，可以是 RAX、RBX、RCX、RDX、RSI、RDI、RSP、RBP、R8～R15 中的其中一種。n 只能是 1、2、4、8 四種數值中的一種，如果是 1，可以省略。「reg*n」代表位址，「[ reg*n ]」代表存於該位址內的數值。

⑷、第四種形式常用於存取陣列中的元素，可以寫成下面兩種樣子，意義均相同：

var [ reg*n ]
[ reg*n＋var ]

其中 reg、n 均與第三種形式的意義一樣，var 代表變數，一般此變數是陣列。我們知道變數其實代表某個位址中的數值，而變數名稱代表位址，在此處可以看成是偏移位址。上面的寫法，「var [ reg*n ]」，是高階語言表示陣列中某個元素數值的寫法，組合語言採用這種寫法常讓人詬病，不過為了配合高階語言，許多組譯器仍能組譯這種寫法。下面的寫法，較為具體，「reg*n＋var」代表位址，「[ reg*n＋var ]」代表存於該位址內的數值。

底下就以 DRAW2 中存取 hCursor 陣列為例。見右圖，假設 DRAW2 執行時，pCursor 變數在位址 5C5048H 處，hCursor 陣列在 5C5050H 處。又假設，使用者由功能表中選取綠色，那麼 pCursor 之值為 2，在處理 WM_SETCURSOR 訊息時候會執行四行指令，如下：

 .case WM_SETCURSOR
        mov     rax,pCursor
        lea     r10,hCursor[8*rax]
        invoke  SetCursor,QWORD PTR [r10]

執行到「LEA R10,hCursor[8*RAX]」時，RAX 為 2，8*RAX 為 16，換算成十六進位為 10H。「hCursor[10H]」與「[10H＋hCursor]」同義，代表位址 5C5060H 內所儲存的數值，也就是綠筆的游標代碼。而 LEA 指令是取得 LEA 之後運算元的所在位址，所以「LEA R10,hCursor[8*RAX]」執行完畢時，R10 之值為 5C5060H。下一道指令是「invoke SetCursor,QWORD PTR [r10]」，其中的「QWORD PTR [r10]」就是 R10 所指位址內的數值，也就是綠筆的游標代碼。因為這道指令沒有其他資料可提供此數值長度，所以加上「QWORD PTR」以指定長度。

講了這麼複雜，上面最後兩行指令先取得運算元（[10H＋hCursor]），再用 LEA 由運算元取得其位址，然後又以該位址取得數值（QWORD PTR [r10]）。你或許會想怎麼這麼迂迴麻煩，為何不直接寫成：

 .case WM_SETCURSOR
        mov     rax,pCursor
        mov     r10,hCursor[8*rax]
        invoke  SetCursor,r10

沒錯，正常寫法就是這樣，但是小木偶不知是何原因，用 UASM64.EXE 無法組譯，但如果改用 ML64.EXE 卻能組譯成功（見附錄二）。儘管不知道原因，但是可以利用上述迂迴麻煩的方式，變通處理而後達到目的。（如果要用 ML64.EXE 組譯，DRAW2.ASM 必須稍微修改，可以自行試試）

不管你用 UASM64.EXE 組譯或是用 ML64.EXE 組譯，最後用 LINK.EXE 連結時，都必須使用「/LARGEADDRESSAWARE:NO」選項。原因是「.DATA」區段的位址是 64 位元的，而使用上述⑷形式的間接定址方式時，偏移位址是 32 位元，因此在連結時必須用「/LARGEADDRESSAWARE:NO」調整。「/LARGEADDRESSAWARE:NO」並沒限制大小寫，均用小寫或大小寫夾雜，都可以。

選擇畫筆

在前面「處理 WM_COMMAND 訊息」提到，改變顏色時，同時會改變滑鼠游標變為該顏色形狀的畫筆。事實上，更重要的是要改變畫筆。因為在裝置內容（device context）畫出不同顏色的橢圓或線段，必須使用不同顏色的畫筆。在 DRAW2 中，畫筆的顏色共有四種，在第 170～178 行，建立了四種畫筆而得到的四色畫筆代碼，與滑鼠游標一樣，存入含有四個元素的 hPen 陣列中。

要使用哪一種畫筆，與滑鼠游標一樣，用間接定址的第⑷種形式。存取 hCursor 陣列用 pCursor 作為指標，那麼存取 hPen 陣列呢？幸運的是，因為這兩個陣列的顏色排列順序一樣，所以也能 pCursor 來存取 hPen 陣列。畫橢圓或手繪圖都發生於處理 WM_PAINT 訊息時，也是此時才需要在 hPen 陣列讀取畫筆。這段程式碼見 DRAW2.ASM 的第 61～64 行，也就是底下程式碼的第 3～5 行。

畫橢圓

Ellipse 繪製橢圓的原理見前面，也就是必須在工作區內以滑鼠左鍵點選不同的兩個點，選定第二個點之後才能在工作區中畫出橢圓。指定兩個點是在處理 WM_LBUTTONDOWN 訊息時發生，畫出橢圓是在處理 WM_PAINT 訊息中。DRAW2.ASM 中以 ellips_pen 表示這三個步驟，尚未指定第一點時 ellips_pen 為零，已指定第一個點尚未指定第二個點時 ellips_pen 為一，已選定兩個點之後 ellips_pen 為二，此刻就該呼叫 InvalidateRect 畫出橢圓。這段過程的程式碼如下：

  .case WM_PAINT
        invoke  BeginPaint,hWnd,ADDR ps
        mov     rax,pCursor     ;改變畫筆
        lea     r10,hPen[rax*8] ;R10＝畫筆代碼所在位址
        invoke  SelectObject,ps.hdc,QWORD PTR [r10]
    ;當draw_what=0時，繪製橢圓；當draw_what=1時，手繪圖
    .if (draw_what==0)&&(ellips_pen==2)
        invoke  Ellipse,ps.hdc,lt_rect.x,lt_rect.y,rb_rect.x,rb_rect.y
        sub     ellips_pen,2
    .elseif draw_what==1
        ⁝
  .case WM_LBUTTONDOWN
        mov     r8,r9
        shr     r9,10h          ;R9＝Y座標
        and     r8,0ffffh       ;R8＝X座標
    .if draw_what==0
      .if ellips_pen==0         ;畫橢圓時處理第一個點
        mov     lt_rect.x,r8d
        mov     lt_rect.y,r9d
        inc     ellips_pen
      .elseif ellips_pen==1     ;畫橢圓時處理第二個點
        mov     rb_rect.x,r8d
        mov     rb_rect.y,r9d
        inc     ellips_pen
        invoke  InvalidateRect,hWnd,0,0
      .endif

以滑鼠左鍵點選第一個點時，DRAW2 將其座標存於 lt_rect 內。lt_rect 中的 lt 代表左（left）、上（top）的意思，存完之後將 ellips_pen 變為一，就結束了第一步驟。第二個點座標存於 rb_rect 內並使 ellips_pen 變為二，然後呼叫 InvalidateRect，強迫生成 WM_PAINT 訊息。在處理 WM_PAINT 時，DRAW2 必須面對除了畫出橢圓之外，有時要畫出手繪圖、有時要顯示滑鼠游標的座標、有時要顯示選擇畫筆的顏色等過程，所以用 .if/.elseif/.endif 檢查是哪一種狀況。畫出橢圓是在 draw_what 為零，且 ellips_pen 為二時發生，見 DRAW2.ASM 第 83～85 行。

顯示座標

DRAW2 可以讓使用者自行決定是否於工作區左上角顯示滑鼠游標所在的座標。DRAW2 用變數 fXy 來表示顯示或不顯示，若 fXy 為 1，就顯示座標；若為 0，不顯示座標。這種情形很像 CPU 的旗標，所以 fXy 的 f 就是旗標 flag 的意思。

DRAW2 預設會顯示滑鼠座標，使用者可以用滑鼠左鍵點選「檢視」→「座標」使 DRAW2 不顯示；若再點選座標一次，又能顯示；若再點選一次，則不顯示……如此切換不已。這種情形很像 XOR 運算（見第一章），也就是如此，所以在第 151 行，使用「XOR fXy,1」就能完成這樣的切換運算。

這是發生在使用者點選「座標」選項，所以是在處理 WM_COMMAND 訊息中發生的事。如果不顯示座標，那麼接下來改變「座標」選項為不勾選，就完成了；但如果要顯示座標，那麼除了改變「座標」選項為勾選之外，還牽涉到滑鼠游標移動時的座標，及於工作區顯示該座標。這些事件分別牽涉到 WM_MOUSEMOVE、WM_PAINT 訊息。也就是說，當使用者點選座標選項，牽涉到 WM_COMMAND、WM_MOUSEMOVE、WM_PAINT 三則訊息，此三則訊息不僅要處理點選座標選項的事件，也要處理其他像畫橢圓、點選顯示顏色等事件，底下僅列出與點選座標相關的程式碼：

.DATA
szMouseFmt      DB      "(%03d,%03d)",0
szClear         DB      5 DUP ("　")
mouse           POINT   <>      ;滑鼠游標所在座標，當fXy為一時顯示在工作區左上角
  ⁝
.CODE
WndProc PROC    hWnd:HWND,uMsg:UINT,wParam:WPARAM,lParam:LPARAM
        LOCAL   buffer[16]:BYTE
.switch uMsg
  .case WM_PAINT
        invoke  BeginPaint,hWnd,ADDR ps
    ;當fXy=1時，顯示滑鼠座標
    .if fXy==1
        invoke  wsprintf,ADDR buffer,OFFSET szMouseFmt,mouse.x,mouse.y
        lea     r9,buffer
    .else
        mov     r9,OFFSET szClear
        mov     eax,SIZEOF szClear
    .ENDIF
        invoke  TextOut,ps.hdc,0,0,r9,eax
          ⁝
        invoke  EndPaint,hWnd,ADDR ps

  .case WM_MOUSEMOVE
        mov     r8,r9
        shr     r9,10h      ;R9D＝Y座標
        and     r8,0ffffh   ;R8D＝X座標
        mov     mouse.x,r8d
        mov     mouse.y,r9d
        invoke  InvalidateRect,hWnd,0,0 ;對本身發出WM_PAINT訊息

  .case WM_COMMAND
    .if r8w==IDM_XY
        mov     r8d,MF_UNCHECKED or MF_BYPOSITION
        xor     fXy,1
        jz      @f
        mov     r8d,MF_CHECKED or MF_BYPOSITION
@@:     invoke  CheckMenuItem,hViewSubMenu,0,r8d
    .elseif r8w==IDM_COLOR
          ⁝

先看如何處理 WM_COMMAND 訊息。因為 DRAW2.ASM 的功能表上有許多選項，所以會有一大串 .if/.elseif/.endif 來檢查選項識別碼，而選項識別碼是存在於 R8W 內，這原理前面提過。當處理使用者按下座標選項時，不論當前選項是否為勾選的，都先假設未勾選，也就是先將 R8D 設為「MF_UNCHECKED or MF_BYPOSITION」，然後執行「XOR fXy,1」，如此一來就能設定使用者選定後的勾選狀態，同時也能設定運算結果是否為 0。若為 0，因為在做 XOR 運算前已先假設好了，所以直接跳至「@@:」標記處即可；若為非零，那就要改變 R8D 為「MF_CHECKED or MF_BYPOSITION」。（註一）

要如何獲得滑鼠游標移動過程中，幾乎每一點的座標呢？答案是處理 WM_MOUSEMOVE 訊息，在此訊息中 lParam 的第 0～15 位元是滑鼠游標的 X 座標，第 16～31 位元是 Y 座標。將這點座標存於 mouse 變數中，然後呼叫 InvalidateRect，強迫發出 WM_PAINT 訊息，以在工作區繪製座標。

在 WM_PAINT 訊息中，依據 fXy 之值，印出不同字串。當 fXy 為一時，印出座標；為零時，印出空白字串，szClear，做為清除。程式碼很值觀就在上面，應該不需要解釋。

後記

DRAW2 就解釋到這兒，雖然還有手繪圖與顯示顏色選項未解釋，但前者在第十三章的例子 DRAW1 已說明過，後者可參照座標選項，應可瞭解。

在說明完 DRAW2 之後，不知道各位讀者是否有底下的感受。Windows 程式設計的每項功能，似乎要拆成許多部分，分散在數個訊息中處理。例如剛剛提到的，要在工作區顯示滑鼠游標移動的座標，要在 WM_COMMAND、WM_MOUSEMOVE、WM_PAINT 訊息中分別設定勾選狀態、獲得滑鼠游標的座標，印出座標來。而 WM_COMMAND 等三則訊息，也不是只處理工作區顯示滑鼠游標的座標而已，還有其他事件要處理。因為以上原因，Windows 程式最後呈現的看來非常雜亂，這似乎也是沒辦法的。

註解

註一

先說 XOR 運算的特性。XOR 中文是互斥或，它有個特性，「某個數與同一數連做兩次互斥或運算仍得到原數」，底下是粗淺的證明：

1 XOR 1 ＝ 0
0 XOR 1 ＝ 1

1 與 1 作互斥貨運算得 0，其結果與同一數，1，再作一次互斥或，又得回原數 1。回到 DRAW2 的程式裏，fXy 若為 1 表示要顯示座標，若為 0 代表不顯示座標。考慮底下兩種情形：

若現在 fXy 為 1，要顯示座標，而此時使用者以滑鼠左鍵點選功能表中的座標選項，就不顯示座標，fXy 應設為 0；此結果和 fXy 與 1 進行互斥或運算的結果一樣，都為 0。
若現在 fXy 為 0，不顯示座標，而此時使用者以滑鼠左鍵點選功能表中的座標選項，就要顯示座標，fXy 應設為 1；此結果和 fXy 與 1 進行互斥或運算的結果一樣，都為 1。

從上面敘述的結果來看，如果有像 DRAW2 中，點選座標選項就切換某項特性，就可應用 XOR 運算來完成，不僅程式碼小而且執行快速，非常方便。另外，這段程式如果寫成下面的樣子：

  .case WM_COMMAND
    .if r8w==IDM_XY
        xor     fXy,1
      .if fXy==1
        mov     r8d,MF_UNCHECKED or MF_BYPOSITION
      .else
        mov     r8d,MF_CHECKED or MF_BYPOSITION
      .endif
        invoke  CheckMenuItem,hViewSubMenu,0,r8d

較具可讀性，也較容易瞭解；但是這樣子的話，程式碼就有八行、共 55 個位元組。如果寫成底下的樣子：

  .case WM_COMMAND
    .if r8w==IDM_XY
        mov     r8d,MF_UNCHECKED or MF_BYPOSITION
        xor     fXy,1
        jz      @f
        mov     r8d,MF_CHECKED or MF_BYPOSITION
@@:     invoke  CheckMenuItem,hViewSubMenu,0,r8d

就只有六行程式碼、共 45 個位元組。這其中的利害得失，得自己拿捏了。另外，XOR 運算會改變零值旗標，假如運算結果為 0，那麼就會設定零值旗標，而下一個 JZ 指令是檢查零值旗標是否設定，如果是，就發生跳躍。

第十六章 功能表（一）

功能表簡介

功能表的種類

主功能表、子功能表與選項

功能表訊息

WM_COMMAND 訊息

WM_INITMENUPOPUP 訊息

資源描述檔中的功能表

MENU 區塊

例子

在程式中載入功能表

載入功能表的三種方法

LoadMenu API

SetMenu API

GetSubMenu API

CheckMenuItem API

CheckMenuRadioItem API

Ellipse API

範例：DRAW2

解說 DRAW2

定義游標代碼陣列與其指標

處理 WM_COMMAND 訊息

處理 WM_SETCURSOR

間接定址：暫存器乘以二的冪方與暫存器乘以二的冪方加偏移位址

選擇畫筆

畫橢圓

顯示座標

後記

註解

註一

第十六章　功能表（一）