CToolBarCtrl 類別

發行項
03/15/2013

提供視窗工具列上的通用控制項的功能。

class CToolBarCtrl : public CWnd

成員

公用建構函式

名稱	描述
CToolBarCtrl::CToolBarCtrl	建構 CToolBarCtrl 物件。

公用方法

名稱	描述
CToolBarCtrl::AddBitmap	將一或多個點陣圖按鈕設定為影像按鈕影像清單中可用的工具列控制項。
CToolBarCtrl::AddButtons	將一個或多個按鈕加入至工具列控制項。
CToolBarCtrl::AddString	將新的字串，做為資源 ID，將資料工具列的內部清單中。
CToolBarCtrl::AddStrings	將新的字串或字串，傳遞，指標空格分隔字串緩衝區，字串至工具列的內部清單中。
CToolBarCtrl::AutoSize	調整大小的工具列控制項。
CToolBarCtrl::ChangeBitmap	變更一個按鈕的點陣圖目前工具列控制項。
CToolBarCtrl::CheckButton	選取或清除工具列控制項的特定按鈕。
CToolBarCtrl::CommandToIndex	擷取按鈕的以零起始的索引與指定的命令識別項。
CToolBarCtrl::Create	建立工具列控制項並將其附加至 CToolBarCtrl 物件。
CToolBarCtrl::CreateEx	建立擁有指定之視窗的延伸樣式的工具列控制項並將其附加至 CToolBarCtrl 物件。
CToolBarCtrl::Customize	顯示自訂工具列的對話方塊。
CToolBarCtrl::DeleteButton	刪除工具列控制項中的按鈕。
CToolBarCtrl::EnableButton	啟用或停用在工具列控制項指定的按鈕。
CToolBarCtrl::GetAnchorHighlight	擷取工具列的錨定反白顯示設定。
CToolBarCtrl::GetBitmap	擷取點陣圖的索引與工具列上的按鈕。
CToolBarCtrl::GetBitmapFlags	取得旗標與工具列的點陣圖。
CToolBarCtrl::GetButton	擷取與指定之按鈕的資訊在工具列控制項。
CToolBarCtrl::GetButtonCount	目前擷取按鈕的計數] 工具列控制項。
CToolBarCtrl::GetButtonInfo	擷取一個按鈕的資訊在工具列上的。
CToolBarCtrl::GetButtonSize	擷取目前寬度和高度工具列按鈕，以像素為單位)。
CToolBarCtrl::GetColorScheme	擷取目前的工具列控制項的色彩配置。
CToolBarCtrl::GetDisabledImageList	擷取工具列控制項用來顯示停用的按鈕影像清單。
CToolBarCtrl::GetDropTarget	擷取工具列控制項的 IDropTarget 介面。
CToolBarCtrl::GetExtendedStyle	擷取工具列控制項的延伸樣式。
CToolBarCtrl::GetHotImageList	擷取工具列控制項用來顯示「作用中」按鈕的影像清單。表示當滑鼠指標在其上方時，項目群組的作用中按鈕會反白顯示。
CToolBarCtrl::GetHotItem	要擷取索引之項目的索引會在工具列上的。
CToolBarCtrl::GetImageList	擷取工具列控制項用來顯示在它們的預設狀態的按鈕的影像清單。
CToolBarCtrl::GetInsertMark	擷取工具列的目前插入標記。
CToolBarCtrl::GetInsertMarkColor	擷取用於將色彩繪製工具列的插入標記。
CToolBarCtrl::GetItemRect	擷取一個按鈕的週框 (Bounding Rectangle) 工具列控制項的。
CToolBarCtrl::GetMaxSize	擷取所有的總大小可見的按鈕和分隔符號在工具列上的。
CToolBarCtrl::GetMaxTextRows	擷取文字行的最大數目顯示於工具列按鈕上的。
CToolBarCtrl::GetMetrics	擷取工具列控制項的度量資訊。
CToolBarCtrl::GetPadding	擷取目前的工具列控制項的水平和垂直的邊框距離。
CToolBarCtrl::GetPressedImageList	擷取目前的工具列控制項用來表示處於已按下狀態的按鈕的影像清單。
CToolBarCtrl::GetRect	擷取指定的工具列按鈕的週框 (Bounding Rectangle)。
CToolBarCtrl::GetRows	擷取資料列數工具列目前顯示的按鈕。
CToolBarCtrl::GetState	擷取所指定的按鈕狀態資訊是以工具列控制項的，例如它是否已啟用，已按下或已核取。
CToolBarCtrl::GetString	擷取工具列字串。
CToolBarCtrl::GetStyle	擷取樣式目前使用中的工具列控制項。
CToolBarCtrl::GetToolTips	擷取工具提示控制項的控制代碼，如果有的話，與工具列控制項。
CToolBarCtrl::HideButton	隱藏或顯示在工具列控制項指定的按鈕。
CToolBarCtrl::HitTest	判斷某個點位於工具列控制項。
CToolBarCtrl::Indeterminate	設定或明確指定按鈕的不定狀態 (灰色) 在工具列控制項的。
CToolBarCtrl::InsertButton	在工具列控制項插入按鈕。
CToolBarCtrl::InsertMarkHitTest	擷取點的插入標記資訊] 工具列上的。
CToolBarCtrl::IsButtonChecked	會在工具列控制項指定的按鈕是否已核取。
CToolBarCtrl::IsButtonEnabled	會在工具列控制項的指定是否已啟用按鈕。
CToolBarCtrl::IsButtonHidden	會在工具列控制項指定的按鈕是否為隱藏。
CToolBarCtrl::IsButtonHighlighted	檢查工具列按鈕的焦點狀態。
CToolBarCtrl::IsButtonIndeterminate	會指定按鈕的狀態在工具列控制項的是否為不定 (灰色)。
CToolBarCtrl::IsButtonPressed	會在工具列控制項指定的按鈕是否已按下按鈕。
CToolBarCtrl::LoadImages	載入點陣圖為工具列控制項的影像中列出。
CToolBarCtrl::MapAccelerator	將一個快速鍵字元加入工具列按鈕。
CToolBarCtrl::MarkButton	設定指定之按鈕的反白狀態在工具列控制項的。
CToolBarCtrl::MoveButton	從某個索引捲動按鈕加入至另一個。
CToolBarCtrl::PressButton	按下或版本在工具列控制項指定的按鈕。
CToolBarCtrl::ReplaceBitmap	以新的點陣圖取代目前工具列控制項的現有的點陣圖。
CToolBarCtrl::RestoreState	還原工具列控制項的狀態。
CToolBarCtrl::SaveState	儲存工具列控制項的狀態。
CToolBarCtrl::SetAnchorHighlight	將工具列的錨定反白顯示設定。
CToolBarCtrl::SetBitmapSize	設定要加入的點陣影像的大小加入至工具列控制項。
CToolBarCtrl::SetButtonInfo	設定現有按鈕的資訊在工具列上的。
CToolBarCtrl::SetButtonSize	設定要加入之按鈕的大小加入至工具列控制項。
CToolBarCtrl::SetButtonStructSize	指定 TBBUTTON 結構的大小。
CToolBarCtrl::SetButtonWidth	會設定工具列控制項的最小和最大按鈕寬度。
CToolBarCtrl::SetCmdID	指定的按鈕時，設定要傳送的命令識別項至主控視窗。
CToolBarCtrl::SetColorScheme	設定目前工具列控制項的色彩配置。
CToolBarCtrl::SetDisabledImageList	設定工具列控制項用於顯示停用的按鈕影像清單。
CToolBarCtrl::SetDrawTextFlags	設定在 Win32 函式， DrawText的旗標可用來在指定矩形的文字格式化，以旗標如何設定。
CToolBarCtrl::SetExtendedStyle	設定工具列控制項的延伸樣式。
CToolBarCtrl::SetHotImageList	設定工具列控制項用於顯示「作用中」按鈕的影像清單。
CToolBarCtrl::SetHotItem	在工具列上設定作用中的項目。
CToolBarCtrl::SetImageList	將工具列將用來顯示按鈕在它們的預設狀態的影像清單。
CToolBarCtrl::SetIndent	將第一個按鈕的縮排、工具列控制項。
CToolBarCtrl::SetInsertMark	將工具列的目前插入標記。
CToolBarCtrl::SetInsertMarkColor	設定用於的色彩繪製工具列的插入標記。
CToolBarCtrl::SetMaxTextRows	將文字行的最大數目顯示於工具列按鈕上的。
CToolBarCtrl::SetMetrics	設定工具列控制項的度量資訊。
CToolBarCtrl::SetOwner	設定視窗接收來自工具列控制項的通知訊息。
CToolBarCtrl::SetPadding	設定目前工具列控制項的水平和垂直的邊框距離。
CToolBarCtrl::SetPressedImageList	設定目前工具列控制項用來表示處於已按下狀態的按鈕的影像清單。
CToolBarCtrl::SetRows	設定資料列數工具列顯示的按鈕。
CToolBarCtrl::SetState	設定指定之按鈕的狀態在工具列控制項。
CToolBarCtrl::SetStyle	設定工具列控制項的樣式。
CToolBarCtrl::SetToolTips	與工具提示控制項與工具列控制項。
CToolBarCtrl::SetWindowTheme	設定工具列控制項的視覺化樣式。

備註

這個控制項 (也 CToolBarCtrl 類別) 給在 Windows 95 /98 和 Windows NT 3.51 版之下的程式才能使用 (含) 以後版本。

視窗工具列通用控制項是包含一或多個按鈕之矩形的子視窗。這些按鈕可以顯示點陣圖影像，字串或兩者。當使用者選取按鈕時，它會將命令傳送訊息至工具列的主控視窗。一般而言，在工具列上的按鈕對應於應用程式的功能表項目，它們會為使用者提供一種直接的方式存取應用程式的命令。

CToolBarCtrl 物件包含數個重要內部資料結構:按鈕影像點陣圖清單或影像清單、按鈕標籤字串清單與關聯的影像和字串具有按鈕的位置、樣式、狀態和命令 ID 的 TBBUTTON 結構清單。每一種資料結構的項目之以零起始的索引參考。在您可以使用 CToolBarCtrl 物件之前，您必須將這些資料結構。字串清單可以為按鈕標籤只使用;您無法從工具列來擷取字串。

若要使用 CToolBarCtrl 物件，您通常會執行下列步驟:

CToolBarCtrl 建構物件。
呼叫建立建立視窗工具列上的通用控制項並將它附加至 CToolBarCtrl 物件。表示工具列樣式使用樣式，例如透明工具列的支援下拉式樣式按鈕的工具列上的 TBSTYLE_TRANSPARENT 或 TBSTYLE_DROPDOWN 。
識別如何所要顯示的工具列上的按鈕:
- 為按鈕要使用點陣圖影像，將按鈕點陣圖為工具列藉由呼叫 AddBitmap。
- 若要使用影像顯示的影像按鈕清單，藉由呼叫 SetImageList、 SetHotImageList或 SetDisabledImageList指定影像清單。
- 為按鈕要使用資料標記，請將字串加入至工具列藉由呼叫 AddString 和 AddStrings。
將按鈕加入至工具列結構藉由呼叫 AddButtons。
如果您想要一個工具列按鈕的工具提示在不是 CFrameWnd的主控視窗，您需要處理工具列上的主控視窗的 TTN_NEEDTEXT 訊息管理工具提示告知(如中所述。如果工具列的父視窗 CFrameWnd從衍生，工具提示會顯示，但不會從您的任何額外工作，因為 CFrameWnd 提供預設處理常式。
如果您想要讓使用者自訂工具列，請處理自訂在主控視窗的通知訊息管理自訂告知(如中所述。

您可以使用 SaveState 儲存工具列控制項的目前狀態中註冊和 RestoreState 還原根據資訊的狀態先前儲存在登錄中。除了儲存在應用程式中使用的之間工具列狀態，應用程式通常會儲存狀態，在使用者啟動自訂工具列之前，當使用者之後若要還原工具列回其原始狀態。

為 Internet Explorer 4.0 (含) 以後版本不支援

若要支援在 Internet Explorer 中加入的功能，版本 4.0 (含) 以後版本中， MFC 會針對工具列控制項提供影像清單和支援透明和平面樣式。

透明工具列可讓用戶端在工具列的來顯示。若要建立透明的工具列中，使用 TBSTYLE_FLAT 和 TBSTYLE_TRANSPARENT 樣式。透明工具列的熱追蹤和功能，也就是說，當滑鼠指標移至工具列上的按鈕的按鈕時，按鈕的外觀會變更。工具列建立 TBSTYLE_FLAT 模式會包含不透明按鈕。

影像清單支援提供控制項的預設行為、作用中影像和停用影像的更大的彈性。使用 GetImageList、 GetHotImageList和 GetDisabledImageList 以透明工具列會根據其狀態管理影像:

如需使用 CToolBarCtrl的資訊，請參閱控制項和使用 CToolBarCtrl。