CCommandBar::AddAdornments

更新：2007 年 11 月

在命令列中加入 [關閉] 按鈕，並選擇性地加入 [說明] 和 [確定] 按鈕。

BOOL AddAdornments(
Dword dwFlags = 0 );

參數

下表會說明 CCommandBar 類別之 AddAdornments 方法的參數。

dwFlags

指定要加入至命令列中的選擇性按鈕。如果只需要加入 [關閉] 按鈕，則其值為零；如果要建立其他按鈕，則為下列各值的組合：

值	說明
CMDBAR_HELP	將 [說明] 按鈕加入至命令列。按一下這個按鈕時，它會傳送 WM_HELP 訊息。
CMDBAR_OK	將 [確定] 按鈕加入至命令列。選取這個按鈕時，它會傳送含有 IDOK 做為訊息識別項的 WM_COMMAND 訊息。

如果成功，則為 true，否則為 false。

這個方法至少會建立兩個按鈕：一個是分隔符號，它會將選取的按鈕對齊至命令列的右邊，另一個則是您所選取的按鈕。

當使用者按一下 [關閉]、[確定] 或 [說明] 按鈕時，就會在應用程式的訊息佇列中置入和該按鈕相關聯的訊息。每一個命令列都必須要有 [關閉] 按鈕，至於 [確定] 按鈕和 [說明] 按鈕則是選擇性的按鈕。

請在所有其他元素 (例如功能表、按鈕和下拉式方塊) 都加入至命令列之後，再呼叫這個方法。

現有的應用程式應該要重新設計，以移除對 AddAdornments 的相依性。

Windows CE 5.0 (含) 以後版本。

標頭檔：在 Afxext.h 中宣告。