EnableMenuItem

EnableMenuItem的意思是允許、禁止或變灰指定的選單條目。

函式說明

允許、禁止或變灰指定的選單條目

函式原型

BOOL EnableMenuItem(
　　HMENU hMenu, // handle to menu
UINT uIDEnableItem, // menu item to enable, disable, or gray
UINT wEnable // menu item flags
);

返回值 ：返回值指定的先前狀態選單項。如果選單項不存在,返回值是0xffffffff。

參數說明

參數類型及說明

hMenu ，選單句柄

uIDEnableItem ，欲允許或禁止的一個選單條目的標識符。如果在wEnable參數中設定了MF_BYCOMMAND標誌，這個參數就代表欲改變選單條目的命令ID。如設定的是MF_BYPOSITION，則這個參數代表選單條目在選單中的位置（第一個條目肯定是零）

wEnable ，參考ModifyMenu函式中的選單常數標誌定義表，其中列出了允許使用的所有常數。對於這個函式，只能指定下述常數：MF_BYCOMMAND，MF_BYPOSITION，MF_ENABLED，MF_DISABLED以及MF_GRAYED

這些值有下列含義：

· MF_BYCOMMAND 指定參數給出已存在的選單項的命令ID號。此為預設值。

· MF_BYPOSITION 指定參數給出已存在選單項的位置。第一項所在的位置是0。

· MF_DISABLED 使選單項無效，以便它不能被選擇，但不變灰。

· MF_ENABLED 使選單項有效，以便它能夠被選擇，並可從變灰的狀態中恢復出來。

· MF_GRAYED 使選單項無效，以便它不能被選擇並同時變灰。

註解

如指定的選單條目依附了一個彈出式選單，那么整個彈出式選單都會受到影響

備註

使選單項有效、無效或變灰。CreateMenu,InsertMenu,ModifyMenu和LoadMenuIndirect成員函式同時也設定選單項的狀態（有效、無效、或變灰）。

使用MF_BYPOSITION的值需要套用恰當的CMenu對象。若選單條的CMenu被使用，那么頂層選單項（選單條中的某項）將受影響。如果為了在彈出選單或嵌套的彈出選單中通過位置來設定項的狀態，那么套用必須指定彈出選單的CMenu。

當套用指定了MF_BYCOMMAND標誌，那么Windows將檢測所有的屬於CMenu的彈出選單項。因此，除非當前正在複製選單項，那么使用選單條的CMenu是非常有效的。