CMFCToolBar 類別
CMFCToolBar 類別與 CToolBar 類別，不過，提供使用者介面功能提供額外支援。 這些包括一般工具列、工具列具有作用中的影像，大圖示、頁面巡覽區按鈕、鎖定的工具列、Rebar 控制項、文字在影像的下方，背景影像和定位的工具列。 CMFCToolBar 類別也包含可停駐工具列和功能表之間的支援工具列和功能表的使用者自訂，拖放，下拉式方塊按鈕、編輯方塊按鈕、色彩選擇器和彙總按鈕。
class CMFCToolBar : public CMFCBaseToolBar
Members
.gif "Bb984480.collapse_all(zh-tw,VS.110).gif")
公用建構函式
名稱 |
描述 |
|---|---|
CMFCToolBar::CMFCToolBar |
預設建構函式。 |
CMFCToolBar::~CMFCToolBar |
解構函式。 |
公用方法
名稱 |
描述 |
|---|---|
將功能表命令加入至永遠顯示命令的清單，當使用者按一下 功能表時。 |
|
會將與給定的命令計數器。 |
|
從使用者介面資源將影像加入至影像的集合在應用程式中。 |
|
重新計算工具列的大小和位置。 (覆寫 CBasePane::AdjustLayout)。 |
|
重新計算工具列大小。 |
|
指定文字標籤是否可以顯示在工具列按鈕的影像的下方。 |
|
指定在影像中的文字標籤是在工具列按鈕目前是否顯示。 |
|
啟用或停用非現用的按鈕影像的自動產生。 |
|
傳回指定之物件的索引 CMFCToolBarButton 類別 位於這個工具列上的。 |
|
計算工具列的水平大小。 (覆寫 CBasePane::CalcFixedLayout)。 |
|
呼叫框架做為配置計算處理序的一部分。 (覆寫 CPane::CalcSize)。 |
|
決定工具列及其同層級是否在同一個窗格上。 |
|
釋放為工具列影像配置的系統資源。 |
|
來釋放鎖定的工具列影像配置的系統資源。 |
|
指定使用者是否可以關閉工具列。 (覆寫 CBasePane::CanBeClosed)。 |
|
決定系統是否可以還原工具列到原來的狀態在自訂之後。 |
|
指定窗格是否可以接收焦點。 (覆寫 CBasePane::CanFocus)。 |
|
決定工具列及其同層級是否在同一個窗格上。 |
|
傳回按鈕的索引會在工具列上的這個執行個體具有指定的命令 ID 的 . |
|
建立 CMFCToolBar 物件。 |
|
建立使用其他樣式選項的 CMFCToolBar 物件，例如大型圖示。 |
|
停用工具列。 |
|
啟用或停用顯示於工具列尾端的 [加入或移除按鈕] 按鈕。 |
|
啟用窗格的停駐到主要畫面格。 (覆寫 CBasePane::EnableDocking)。 |
|
啟用或停用 工具列按鈕的大圖示。 |
|
啟用或停用 工具列的快速自訂，以便讓使用者可以按 [Alt] 鍵和按鈕拖曳至新位置。 |
|
啟用或停用命令反映。 |
|
啟用或停用文字標籤在工具列按鈕影像的下方。 |
|
擷取指標包含指定的視窗控制代碼的 CMFCToolBar 物件。 |
|
傳回在工具列上的 按鈕的唯讀清單。 |
|
傳回在應用程式中所有工具列的唯讀清單。 |
|
傳回在應用程式定義的基本命令的唯讀清單。 |
|
傳回指向具有指定的工具列按鈕的索引 CMFCToolBarButton 物件。 |
|
會傳回按鈕的命令 ID、樣式和影像索引位於指定索引的。 |
|
傳回維度在工具列上的每個按鈕。 |
|
傳回位於指定索引處的工具列按鈕的目前樣式。 |
|
傳回具有指定索引的按鈕的文字標籤。 |
|
傳回指向冷工具列按鈕影像的集合在應用程式中。 |
|
傳回工具列按鈕的寬度。 |
|
傳回所有具有從工具列的指定命令 ID 在應用程式中按鈕的清單。 |
|
傳回按鈕和分隔符號數目工具列。 |
|
擷取指標與工具列的 CMFCCustomizeButton 物件。 |
|
傳回預設影像之索引鍵的工具列按鈕的這個執行個體具有指定的命令 ID 的 . |
|
傳回指向是停用的工具列按鈕使用在應用程式的影像集合。 |
|
傳回指向會停用功能表上的 按鈕會使用應用程式的影像集合。 |
|
擷取指標目前顯示它的子功能表的功能表按鈕物件。 |
|
指定要停用按鈕影像是否是標準按鈕影像的呈現暗灰色的版本或接受從停用按鈕影像的集合。 |
|
會將指標傳至目前反白顯示的工具列按鈕。 |
|
決定工具列按鈕的色彩。 |
|
傳回反白顯示的工具列按鈕的文字色彩。 |
|
將控制代碼傳回至具有輸入焦點的視窗，請在工具列之前。 |
|
指定設定的呼叫按鈕標籤是否會被忽略。 |
|
傳回工具列按鈕影像的目前大小。 |
|
傳回指向儲存在應用程式的預設按鈕影像的集合。 |
|
傳回用於索引的位移來尋找這個工具列的工具列按鈕影像在工具列按鈕影像的全域清單。 |
|
擷取必須位於指定索引的按鈕重繪工作區的區域。 |
|
傳回工具列按鈕的命令 ID 在指定之索引處的。 |
|
會傳回按鈕的週框 (Bounding Rectangle) 中指定之索引處。 |
|
傳回指向大冷工具列按鈕影像的集合在應用程式中。 |
|
傳回指向大停用工具列按鈕影像的集合在應用程式中。 |
|
傳回指向主要工具列按鈕影像的集合在應用程式中。 |
|
傳回指向鎖定冷影像集合在工具列上的。 |
|
傳回指向鎖定的停用影像集合在工具列上的。 |
|
傳回指向鎖定的按鈕影像的集合在工具列上的。 |
|
傳回鎖定的工具列影像的預設大小。 |
|
傳回指向鎖定的工具列上的 功能表上的影像集合在工具列上的。 |
|
傳回功能表按鈕的大小在應用程式中。 |
|
傳回功能表在應用程式中的按鈕影像的大小。 |
|
傳回指向功能表在應用程式中的按鈕影像的集合。 |
|
擷取工具列的非自訂的按鈕集合。 |
|
擷取工具列的非自訂的重設按鈕的集合。 |
|
擷取工具列的資源 ID。 |
|
判斷哪個物件、父框架或擁有者，將命令加入至工具列。 |
|
傳回高度工具列按鈕。 |
|
指定工具提示是否根據工具列按鈕顯示。 |
|
擷取工具列的同層級。 |
|
傳回指向使用者定義的工具列按鈕影像的集合在應用程式中。 |
|
傳回位於指定位置的工具列按鈕的索引。 |
|
插入按鈕至工具列。 |
|
插入分隔符號插入工具列。 |
|
失效存在於所提供的索引工具列按鈕的工作區。 |
|
判斷使用者使用 [自訂] 功能表選項，即可加入或移除工具列按鈕。 |
|
指定 快取文件層級自訂中 是否用於拖曳按鈕。 |
|
指定非現用 (非反白顯示的) 按鈕影像的自動產生是否已啟用。 |
|
判斷命令是否在基本的命令清單。 |
|
決定工具列是否可以顯示擴充框線按鈕。 |
|
判斷在工具列上的按鈕是否會反白顯示。 |
|
判斷命令是否允許。 |
|
判斷是否很少使用命令 (請參閱 CMFCToolBar::SetCommandUsageOptions)。 |
|
指定工具列框架是否在自訂模式。 |
|
決定工具列按鈕拖曳。 |
|
判斷是否包含 [自訂] 工具列按鈕。 |
|
決定工具列是否浮動。 |
|
指定應用程式的工具列目前是否顯示大圖示。 |
|
判斷這個最近執行命令是從指定的工具列按鈕會傳送。 |
|
決定工具列是否已鎖定。 |
|
決定工具列及其同層級工具列是否在同一資料列上。 |
|
指定工具列是否為使用者定義。 |
|
從應用程式的資源載入工具列影像。 |
|
從應用程式的資源載入工具列影像。 包含大型影像。 |
|
從 Windows 登錄載入全域工具列上選取 。 |
|
從 Windows 登錄裝載工具列的狀態資訊。 (覆寫 CPane::LoadState)。 |
|
從應用程式的資源載入工具列。 |
|
從應用程式的資源載入工具列使用 CMFCToolBarInfo Helper 類別可讓應用程式使用大型影像。 |
|
呼叫框架，當使用者選取 工具列上的按鈕。 |
|
會呼叫由 CBasePane::DoPaint 框架填滿工具列背景。 |
|
還原工具列還原為其原始狀態。 |
|
(覆寫 CBasePane::OnSetAccData)。 |
|
還原工具列按鈕上的文字為其預設狀態。 |
|
CMFCToolBar::OnUpdateCmdUI |
內部使用。 |
從工具列移除所有按鈕。 |
|
移除按鈕具有指定索引處的工具列。 |
|
刪除工具列的狀態資訊從 Windows 登錄。 |
|
用另一個工具列按鈕取代工具列按鈕。 |
|
若要還原所有工具列的原始狀態。 |
|
清除在應用程式中所有工具列影像集合。 |
|
還原工具列的原始狀態。 |
|
將工具列的狀態資訊儲存在 Windows 登錄中。 (覆寫 CPane::SaveState)。 |
|
CMFCToolBar::Serialize |
(覆寫 CBasePane::Serialize)。 |
設定永遠顯示命令的清單，當使用者按一下 功能表時。 |
|
將工具列按鈕的命令 ID、樣式和影像 ID。 |
|
將工具列按鈕的樣式指定索引處的。 |
|
將工具列按鈕的文字標籤。 |
|
將工具列的按鈕。 |
|
當有不常用命令未出現在應用程式的功能表，指定。 |
|
可啟用或停用所有工具列的自訂方式在應用程式。 |
|
指定在工具列上的按鈕是否顯示為暗灰色，或者停用影像是停用的按鈕來使用。 |
|
將工具列的高度。 |
|
指定工具列按鈕的色彩。 |
|
設定按鈕的工具列按鈕的文字色彩。 |
|
指定工具列按鈕是否顯示大圖示。 |
|
設定鎖定的按鈕的大小與工具列上的鎖定的影像。 |
|
將工具列按鈕和功能表其影像的大小。 |
|
設定使用者無法執行命令的清單。 |
|
在同一行上放置工具列及其同層級。 |
|
指定使用者是否可以關閉工具列。 |
|
指定父視窗或主控框架是否傳送命令加入至工具列。 |
|
指定這個框架是否顯示工具提示。 |
|
指定工具列的同層級。 |
|
在任何指定工具列按鈕的大小和影像。 |
|
在 工具列按鈕的屬性指定。 |
|
在不同的行上放置工具列及其同層級。 |
|
設定使用者定義的影像集合在應用程式中。 |
|
垂直或水平縮放工具列。(覆寫 CBasePane::StretchPane)。 |
|
如果指定的按鍵碼對應到有效的鍵盤快速鍵，執行命令按鈕。 |
|
更新指定按鈕的狀態。 |
|
將放置在指定的維度中的工具列按鈕。 |
受保護的方法
名稱 |
描述 |
|---|---|
決定工具列是否在 [自訂] 對話方塊的窗格 [工具列] 的清單隨即顯示。 |
|
計算指定按鈕的最大高度工具列上的。 |
|
會重新繪製工具列。 |
|
會重新繪製工具列按鈕。 |
|
會在工具列的分隔符號。 |
|
呼叫框架時，按鈕的工具提示會顯示。 |
資料成員
名稱 |
描述 |
|---|---|
在高 DPI 模式指定工具列是否會縮放影像。 |
|
在指定的維度 (寬度或高度) 大型影像和維度的比例規則影像之間。 |
備註
若要合併 CMFCToolBar 物件加入至您的應用程式，請遵循下列步驟:
將物件加入至 CMFCToolBar 主框架視窗。
當您處理主框架視窗的 WM_CREATE 訊息時，請呼叫 CMFCToolBar::Create 或 CMFCToolBar::CreateEx 建立工具列和指定其樣式。
呼叫 CBasePane::EnableDocking 指定停駐樣式。
您可以使用 CMFCToolBar::ReplaceButton，要插入使用特殊的按鈕 (例如，下拉式方塊或下拉式工具列，在父資源保留空的按鈕，並取代假設的按鈕是在執行階段。 如需詳細資訊，請參閱 逐步解說： 放置在工具列上的控制項。
CMFCToolBar 是 MFC 程式庫類別的 CMFCMenuBar 類別、 CMFCPopupMenuBar 類別和 CMFCDropDownToolBar 類別基底類別。
範例
下列範例會在 CMFCToolBar 類別會示範如何使用各種方法。 這個範例顯示如何設定工具列的 Windows 標籤的文字，將框線，請將 窗格中的樣式和啟用顯示於工具列尾端的 [加入或移除按鈕。] 按鈕。 這個程式碼片段是 IE 示範範例的一部分。
CMFCToolBar m_wndToolBar;
...
m_wndToolBar.SetWindowText (_T("Standard"));
m_wndToolBar.SetBorders ();
//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle (m_wndToolBar.GetPaneStyle() &
~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));
m_wndToolBar.EnableCustomizeButton (TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));
需求
標題: afxtoolbar.h