`CToolBar` 類別

發行項
10/12/2023

有一列點陣圖按鈕和選擇性分隔線的控制列。

語法

class CToolBar : public CControlBar

成員

公用建構函式

名稱	描述
`CToolBar::CToolBar`	建構 `CToolBar` 物件。

公用方法

名稱	描述
`CToolBar::CommandToIndex`	傳回具有指定命令識別碼之按鈕的索引。
`CToolBar::Create`	建立 Windows 工具列，並將它附加至 `CToolBar` 物件。
`CToolBar::CreateEx`	建立 `CToolBar` 具有內嵌 `CToolBarCtrl` 物件之其他樣式的物件。
`CToolBar::GetButtonInfo`	擷取按鈕的識別碼、樣式和影像編號。
`CToolBar::GetButtonStyle`	擷取按鈕的樣式。
`CToolBar::GetButtonText`	擷取會出現在按鈕上的文字。
`CToolBar::GetItemID`	傳回指定索引處按鈕或分隔符號的命令識別碼。
`CToolBar::GetItemRect`	擷取指定索引處專案的顯示矩形。
`CToolBar::GetToolBarCtrl`	允許直接存取基礎通用控制項。
`CToolBar::LoadBitmap`	載入包含點陣圖按鈕影像的點陣圖。
`CToolBar::LoadToolBar`	載入使用資源編輯器建立的工具列資源。
`CToolBar::SetBitmap`	設定點陣圖影像。
`CToolBar::SetButtonInfo`	設定按鈕的識別碼、樣式和影像編號。
`CToolBar::SetButtons`	設定點陣圖內的按鈕樣式和按鈕影像的索引。
`CToolBar::SetButtonStyle`	設定按鈕的樣式。
`CToolBar::SetButtonText`	設定將在按鈕上顯示的文字。
`CToolBar::SetHeight`	設定工具列的高度。
`CToolBar::SetSizes`	設定按鈕和其點陣圖的大小。

備註

按鈕可以像按鈕、核取方塊按鈕或選項按鈕一樣運作。 CToolBar 物件通常是衍生自類別 CFrameWnd 或 CMDIFrameWnd 之框架視窗物件的內嵌成員。

CToolBar::GetToolBarCtrl是 MFC 4.0 的新功能成員函式，可讓您利用 Windows 通用控制項對工具列自訂和其他功能的支援。 CToolBar 成員函式提供 Windows 通用控制項的大部分功能;不過，當您呼叫 GetToolBarCtrl 時，您可以為您的工具列提供更多 Windows 95/98 工具列的特性。當您呼叫 GetToolBarCtrl 時，它會傳回物件的參考 CToolBarCtrl 。如需使用 Windows 通用控制項設計工具列的詳細資訊，請參閱 CToolBarCtrl 。如需通用控制項的詳細資訊，請參閱 Windows SDK 中的通用控制項。

Visual C++ 提供兩種方法來建立工具列。若要使用資源編輯器建立工具列資源，請遵循下列步驟：

建立工具列資源。
建構 CToolBar 物件。
Create呼叫（或 CreateEx ）函式以建立 Windows 工具列，並將它附加至 CToolBar 物件。
呼叫 LoadToolBar 以載入工具列資源。

否則，請遵循下列步驟：

建構 CToolBar 物件。
Create呼叫（或 CreateEx ）函式以建立 Windows 工具列，並將它附加至 CToolBar 物件。
呼叫 LoadBitmap 以載入包含工具列按鈕影像的點陣圖。
呼叫 SetButtons 以設定按鈕樣式，並將每個按鈕與點陣圖中的影像產生關聯。

工具列中的所有按鈕影像都是取自一個點陣圖，每個按鈕都必須包含一個影像。所有影像的大小都必須相同;預設值為 16 圖元寬，高 15 圖元。影像必須並排在點陣圖中。

函 SetButtons 式會取得控制項識別碼陣列的指標，以及指定陣列中專案數目的整數。函式會將每個按鈕的識別碼設定為數組中對應元素的值，並為每個按鈕指派影像索引，以指定按鈕影像在點陣圖中的位置。如果陣列元素具有值 ID_SEPARATOR ，則不會指派任何影像索引。

點陣圖中的影像順序通常是在畫面上繪製影像的順序，但您可以使用函 SetButtonInfo 式來變更影像順序與繪製順序之間的關聯性。

工具列中的所有按鈕大小都相同。預設值為 24 x 22 圖元，根據 軟體設計的 Windows 介面指導方針。影像和按鈕維度之間的任何額外空間都用來形成影像周圍的框線。

每個按鈕都有一個影像。從該影像產生各種按鈕狀態和樣式（按下、向上、向下、停用、停用和不確定）。雖然點陣圖可以是任何色彩，但您可以使用黑色和灰色陰影的影像達到最佳結果。

警告

CToolBar 支援最多 16 種色彩的點陣圖。當您將影像載入工具列編輯器時，Visual Studio 會視需要自動將影像轉換成 16 色點陣圖，並在影像已轉換時顯示警告訊息。如果您使用超過 16 種色彩的影像（使用外部編輯器來編輯影像），應用程式可能會出人意料地運作。

工具列按鈕預設會模仿按鈕。不過，工具列按鈕也可以模仿核取方塊按鈕或選項按鈕。核取方塊按鈕有三種狀態：已核取、清除和不確定。選項按鈕只有兩種狀態：已核取和清除。

若要設定個別按鈕或分隔符號樣式而不指向陣列，請呼叫 GetButtonStyle 以擷取樣式，然後呼叫 SetButtonStyle 而非 SetButtons 。 SetButtonStyle 當您想要在執行時間變更按鈕的樣式時，最有用。

若要指派要出現在按鈕上的文字，請呼叫 GetButtonText 以擷取要出現在按鈕上的文字，然後呼叫 SetButtonText 以設定文字。

若要建立核取方塊按鈕，請在處理常式中 ON_UPDATE_COMMAND_UI 指派樣式 TBBS_CHECKBOX 或使用 CCmdUI 物件 SetCheck 的成員函式。呼叫 SetCheck 會將按鈕轉換成核取方塊按鈕。針對未核取傳遞 SetCheck 0 的引數、檢查的 1 或 2 表示不確定。

若要建立選項按鈕，請從 ON_UPDATE_COMMAND_UI 處理常式呼叫 CCmdUI 物件的 SetRadio 成員函式。針對未核取或非零的已核取傳遞 SetRadio 0 的引數。若要提供單選群組的互斥行為，您必須擁有 ON_UPDATE_COMMAND_UI 群組中所有按鈕的處理常式。

如需使用 CToolBar 的詳細資訊，請參閱 MFC 工具列實作和技術附注 31：控制列一文。

繼承階層架構

CToolBar

需求

標頭：afxext.h

`CToolBar::CommandToIndex`

此成員函式會傳回第一個工具列按鈕的索引，從位置 0 開始，其命令識別碼符合 nIDFind 。

int CommandToIndex(UINT nIDFind) const;

參數

nIDFind
工具列按鈕的命令識別碼。

傳回值

按鈕的索引，如果沒有按鈕具有指定的命令識別碼，則為 -1。

`CToolBar::Create`

此成員函式會建立 Windows 工具列（子視窗），並將它與 CToolBar 物件產生關聯。

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_TOP,
    UINT nID = AFX_IDW_TOOLBAR);

參數

pParentWnd
指向工具列父系之視窗的指標。

dwStyle
工具列樣式。支援的其他工具列樣式如下：

CBRS_TOP 控制列位於框架視窗頂端。
CBRS_BOTTOM 控制列位於框架視窗底部。
CBRS_NOALIGN 當父項調整大小時，控制項列不會重新置放。
CBRS_TOOLTIPS 控制列會顯示工具提示。
CBRS_SIZE_DYNAMIC 控制列是動態的。
CBRS_SIZE_FIXED 控制列是固定的。
CBRS_FLOATING 控制列是浮動的。
CBRS_FLYBY 狀態列會顯示按鈕的相關資訊。
CBRS_HIDE_INPLACE 控制項列不會向使用者顯示。

nID
工具列的子視窗識別碼。

傳回值

如果成功則為非零；否則為 0。

備註

它也會將工具列高度設定為預設值。

範例

// This code fragment is taken from CMainFrame::OnCreate
// CMainFrame is derived from CMDIFrameWnd.

//This example creates a dockable toolbar.
if (!m_wndToolBar.Create(this) ||
   !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
{
   TRACE0("Failed to create toolbar\n");
   return -1;      // fail to create
}

//Make the toolbar dockable
m_wndToolBar.EnableDocking(CBRS_ALIGN_ANY);
EnableDocking(CBRS_ALIGN_ANY);
DockControlBar(&m_wndToolBar);

`CToolBar::CreateEx`

呼叫此函式以建立 Windows 工具列（子視窗），並將它與 CToolBar 物件產生關聯。

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle = TBSTYLE_FLAT,
    DWORD dwStyle = WS_CHILD | WS_VISIBLE | CBRS_ALIGN_TOP,
    CRect rcBorders = CRect(
    0,
    0,
    0,
    0),
    UINT nID = AFX_IDW_TOOLBAR);

參數

pParentWnd
指向工具列父系之視窗的指標。

dwCtrlStyle
建立內嵌 CToolBarCtrl 物件的其他樣式。根據預設，此值會設定為 TBSTYLE_FLAT 。如需工具列樣式的完整清單，請參閱 dwStyle 。

dwStyle
工具列樣式。如需適當樣式的清單，請參閱 Windows SDK 中的工具列控制項和按鈕樣式。

rcBorders
CRect物件，定義工具列視窗框線的寬度。根據預設，這些框線會設定為 0,0,0,0,0,0,0,0，因此會產生沒有框線的工具列視窗。

nID
工具列的子視窗識別碼。

傳回值

如果成功則為非零；否則為 0。

備註

它也會將工具列高度設定為預設值。

當建立內嵌工具列控制項時，需要有特定樣式時，請使用 CreateEx ，而不是 Create 。例如，將設定 dwCtrlStyle 為 TBSTYLE_FLAT | TBSTYLE_TRANSPARENT 以建立類似 Internet Explorer 4 工具列的工具列。

範例

// This example demonstrates CToolBar::CreateEx by creating a 
// toolbar as part of a child frame window. It also calls the 
// LoadToolbar and EnableDocking functions
int CChildFrame::OnCreate(LPCREATESTRUCT lpCreateStruct)
{
   if (CMDIChildWnd::OnCreate(lpCreateStruct) == -1)
      return -1;

   if (!m_wndMyToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE | CBRS_TOP
      | CBRS_GRIPPER | CBRS_TOOLTIPS | CBRS_FLYBY | CBRS_SIZE_DYNAMIC) ||
      !m_wndMyToolBar.LoadToolBar(IDR_MYTOOLBAR))
   {
      TRACE0("Failed to create toolbar\n");
      return -1;      // fail to create
   }

   m_wndMyToolBar.EnableDocking(CBRS_ALIGN_ANY);
   EnableDocking(CBRS_ALIGN_ANY);
   DockControlBar(&m_wndMyToolBar);

   return 0;
}

`CToolBar::CToolBar`

這個成員函式會 CToolBar 建構物件，並設定預設大小。

CToolBar();

備註

Create呼叫成員函式以建立工具列視窗。

`CToolBar::GetButtonInfo`

這個成員函式會擷取工具列按鈕或分隔符號在所 nIndex 指定位置的控制項識別碼、樣式和影像索引。

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

參數

nIndex
要擷取其資訊的工具列按鈕或分隔符號的索引。

nID
設定為按鈕命令識別碼的 UINT 參考。

nStyle
設定為按鈕樣式的 UINT 參考。

iImage
設定為點陣圖內按鈕影像索引的整數參考。

備註

這些值會指派給、 nStyle 和 iImage 所 nID 參考的變數。影像索引是影像在點陣圖中的位置，其中包含所有工具列按鈕的影像。第一個影像位於位置 0。

如果 nIndex 指定分隔符號， iImage 則會設定為以圖元為單位的分隔符號寬度。

`CToolBar::GetButtonStyle`

呼叫這個成員函式，以擷取工具列上按鈕或分隔符號的樣式。

UINT GetButtonStyle(int nIndex) const;

參數

nIndex
要擷取之工具列按鈕或分隔符號樣式的索引。

傳回值

所 nIndex 指定按鈕或分隔符號的樣式。

備註

按鈕的樣式會決定按鈕的顯示方式，以及它如何回應使用者輸入。如需按鈕樣式的範例，請參閱 SetButtonStyle 。

`CToolBar::GetButtonText`

呼叫這個成員函式，以擷取出現在按鈕上的文字。

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

參數

nIndex
要擷取之文字的索引。

rString
物件的參考 CString ，其中包含要擷取的文字。

傳回值

CString物件，包含按鈕文字。

備註

這個成員函式的第二種 CString 形式會以字串文字填滿物件。

`CToolBar::GetItemID`

這個成員函式會傳回所 nIndex 指定按鈕或分隔符號的命令識別碼。

UINT GetItemID(int nIndex) const;

參數

nIndex
要擷取其識別碼的專案索引。

傳回值

所 nIndex 指定按鈕或分隔符號的命令識別碼。

備註

分隔符號會傳回 ID_SEPARATOR 。

`CToolBar::GetItemRect`

此成員函式會 RECT 填入結構，其位址包含于 lpRect 的按鈕或分隔符號座標中 nIndex 。

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

參數

nIndex
要擷取其矩形座標的專案索引（按鈕或分隔符號）。

lpRect
RECT將包含專案座標之結構的位址。

備註

座標以圖元表示，相對於工具列左上角。

使用 GetItemRect 取得您要取代為下拉式方塊或其他控制項之分隔符號的座標。

範例

請參閱的 CToolBar::SetSizes 範例。

`CToolBar::GetToolBarCtrl`

此成員函式允許直接存取基礎通用控制項。

CToolBarCtrl& GetToolBarCtrl() const;

傳回值

對 CToolBarCtrl 物件的參考。

備註

使用 GetToolBarCtrl 來利用 Windows 工具列通用控制項的功能，並利用工具列自訂的支援 CToolBarCtrl 。

如需使用通用控制項的詳細資訊，請參閱 Windows SDK 中的控制項和通用控制項一文。

範例

// This code fragment is taken from CMainFrame::OnCreate
// CMainFrame is derived from CMDIFrameWnd.

//This example shows how to add text to toolbar buttons.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE
   | CBRS_TOP) || !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
{
   TRACE0("Failed to create toolbar\n");
   return -1;      // fail to create
}

//Show text on toolbar buttons.
VERIFY(m_wndToolBar.SetButtonText(0, _T("New")));
VERIFY(m_wndToolBar.SetButtonText(1, _T("Open")));
VERIFY(m_wndToolBar.SetButtonText(2, _T("Save")));
VERIFY(m_wndToolBar.SetButtonText(4, _T("Cut")));
VERIFY(m_wndToolBar.SetButtonText(5, _T("Copy")));
VERIFY(m_wndToolBar.SetButtonText(6, _T("Paste")));
VERIFY(m_wndToolBar.SetButtonText(8, _T("Print")));
VERIFY(m_wndToolBar.SetButtonText(9, _T("About")));

CRect temp;
m_wndToolBar.GetItemRect(0, &temp);
m_wndToolBar.GetToolBarCtrl().SetButtonSize(CSize(temp.Width(),
   temp.Height()));

`CToolBar::LoadBitmap`

呼叫這個成員函式以載入或 nIDResource 所 lpszResourceName 指定的點陣圖。

BOOL LoadBitmap(LPCTSTR lpszResourceName);
BOOL LoadBitmap(UINT nIDResource);

參數

lpszResourceName
要載入之點陣圖資源名稱的指標。

nIDResource
要載入之點陣圖的資源識別碼。

傳回值

如果成功則為非零；否則為 0。

備註

點陣圖應該包含每個工具列按鈕的一個影像。如果影像不是標準大小（寬 16 圖元，高 15 圖元），請呼叫 SetSizes 以設定按鈕大小及其影像。

警告

`CToolBar::LoadToolBar`

呼叫這個成員函式以載入或 nIDResource 所 lpszResourceName 指定的工具列。

BOOL LoadToolBar(LPCTSTR lpszResourceName);
BOOL LoadToolBar(UINT nIDResource);

參數

lpszResourceName
要載入之工具列資源名稱的指標。

nIDResource
要載入之工具列的資源識別碼。

傳回值

如果成功則為非零；否則為 0。

備註

如需建立工具列資源的詳細資訊，請參閱中的工具列編輯器。

範例

請參閱的 CToolBar::CreateEx 範例。

`CToolBar::SetBitmap`

呼叫這個成員函式來設定工具列的點陣圖影像。

BOOL SetBitmap(HBITMAP hbmImageWell);

參數

hbmImageWell
與工具列相關聯的點陣圖影像控制碼。

傳回值

如果成功則為非零；否則為 0。

備註

例如，在使用者對變更按鈕動作的檔採取動作之後，呼叫 SetBitmap 以變更點陣圖影像。

`CToolBar::SetButtonInfo`

呼叫此成員函式，以設定按鈕的命令識別碼、樣式和影像編號。

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

參數

nIndex
要設定資訊之按鈕或分隔符號之以零起始的索引。

nID
設定按鈕命令識別碼的值。

nStyle
新的按鈕樣式。支援下列按鈕樣式：

TBBS_BUTTON 標準推播按鈕（預設值）
TBBS_SEPARATOR 分離
TBBS_CHECKBOX 自動核取方塊按鈕
TBBS_GROUP 標記按鈕群組的開頭
TBBS_CHECKGROUP 標記一組核取方塊按鈕的開頭
TBBS_DROPDOWN 建立下拉式清單按鈕。
TBBS_AUTOSIZE 按鈕的寬度會根據按鈕的文字來計算，而不是根據影像的大小來計算。
TBBS_NOPREFIX 按鈕文字不會有與其相關聯的快速鍵前置詞。

iImage
點陣圖內按鈕影像的新索引。

備註

對於具有樣式 TBBS_SEPARATOR 的分隔符號，此函式會將分隔符號的寬度設定為儲存在中的 iImage 值。

注意

您也可以使用 nStyle 參數來設定按鈕狀態;不過，由於按鈕狀態是由 ON_UPDATE_COMMAND_UI 處理常式控制，因此您在下次閒置處理期間會遺失您設定 SetButtonInfo 的任何狀態。如需詳細資訊，請參閱如何更新使用者介面物件和 TN031：控制列。

如需點陣圖影像和按鈕的相關資訊，請參閱概 CToolBar 觀和 CToolBar::LoadBitmap 。

`CToolBar::SetButtons`

這個成員函式會將每個工具列按鈕的命令識別碼設定為數組 lpIDArray 對應專案所指定的值。

BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount);

參數

lpIDArray
命令識別碼陣列的指標。配置空白按鈕可以是 Null。

nIDCount
所指向 lpIDArray 陣列中的專案數目。

傳回值

如果成功則為非零；否則為 0。

備註

如果陣列的專案具有值 ID_SEPARATOR ，則會在工具列的對應位置中建立分隔符號。此函式也會將每個按鈕的樣式設定為 TBBS_BUTTON ，並將每個分隔符號的樣式設定為 TBBS_SEPARATOR ，並將影像索引指派給每個按鈕。影像索引會指定按鈕影像在點陣圖中的位置。

您不需要考慮點陣圖中的分隔符號，因為此函式不會為分隔符號指派影像索引。如果您的工具列具有位於位置 0、1 和 3 的按鈕，且位置為 2 的分隔符號，則點陣圖中位置 0、1 和 2 的影像會分別指派給位置 0、1 和 3 的按鈕。

如果 lpIDArray 為 Null，則此函式會為所 nIDCount 指定的專案數目配置空間。使用 SetButtonInfo 來設定每個專案的屬性。

`CToolBar::SetButtonStyle`

呼叫這個成員函式，以設定按鈕或分隔符號的樣式，或設定為群組按鈕。

void SetButtonStyle(
    int nIndex,
    UINT nStyle);

參數

nIndex
要設定其資訊的按鈕或分隔符號索引。

nStyle
按鈕樣式。支援下列按鈕樣式：

TBBS_BUTTON 標準推播按鈕（預設值）
TBBS_SEPARATOR 分離
TBBS_CHECKBOX 自動核取方塊按鈕
TBBS_GROUP 標記按鈕群組的開頭
TBBS_CHECKGROUP 標記一組核取方塊按鈕的開頭
TBBS_DROPDOWN 建立下拉式清單按鈕
TBBS_AUTOSIZE 按鈕的寬度會根據按鈕的文字來計算，而不是根據影像的大小來計算
TBBS_NOPREFIX 按鈕文字不會有與其相關聯的快速鍵前置詞

備註

按鈕的樣式會決定按鈕的顯示方式，以及它如何回應使用者輸入。

呼叫 SetButtonStyle 之前，請先呼叫 GetButtonStyle 成員函式以擷取按鈕或分隔符號樣式。

注意

您也可以使用 nStyle 參數來設定按鈕狀態;不過，由於按鈕狀態是由 ON_UPDATE_COMMAND_UI 處理常式控制，因此您在下次閒置處理期間會遺失您設定 SetButtonStyle 的任何狀態。如需詳細資訊，請參閱如何更新使用者介面物件和 TN031：控制列。

`CToolBar::SetButtonText`

呼叫此函式以設定按鈕上的文字。

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

參數

nIndex
要設定其文字的按鈕索引。

lpszText
指向按鈕上要設定的文字。

傳回值

如果成功則為非零；否則為 0。

範例

請參閱的 CToolBar::GetToolBarCtrl 範例。

`CToolBar::SetHeight`

這個成員函式會將工具列的高度設定為中指定的 cyHeight 值，以圖元為單位。

void SetHeight(int cyHeight);

參數

cyHeight
工具列的高度，以圖元為單位。

備註

呼叫 SetSizes 之後，請使用這個成員函式來覆寫標準工具列高度。如果高度太小，按鈕會裁剪在底部。

如果未呼叫此函式，架構會使用按鈕的大小來判斷工具列高度。

`CToolBar::SetSizes`

呼叫這個成員函式，將工具列的按鈕設定為中指定的 sizeButton 大小，以圖元為單位。

void SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

參數

sizeButton
每個按鈕的大小，以圖元為單位。

sizeImage
每個影像的大小，以圖元為單位。

備註

參數 sizeImage 必須包含工具列點陣圖中影像的大小，以圖元為單位。中的 sizeButton 維度必須足以容納影像加上 7 圖元的額外寬度和 6 圖元的高度。此函式也會設定工具列高度以符合按鈕。

僅針對未遵循 按鈕和影像大小軟體設計 建議的 Windows 介面指導方針的工具列呼叫此成員函式。

範例

// This code fragment is taken from CMainFrame::OnCreate
// CMainFrame is derived from CMDIFrameWnd

// This example shows how to add text to toolbar buttons.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_FLAT, WS_CHILD | WS_VISIBLE 
   | CBRS_TOP) || !m_wndToolBar.LoadToolBar(IDR_MAINFRAME))
{
   TRACE0("Failed to create toolbar\n");
   return -1;      // fail to create
}

//Show text on toolbar buttons.
VERIFY(m_wndToolBar.SetButtonText(0, _T("New")));
VERIFY(m_wndToolBar.SetButtonText(1, _T("Open")));
VERIFY(m_wndToolBar.SetButtonText(2, _T("Save")));
VERIFY(m_wndToolBar.SetButtonText(4, _T("Cut")));
VERIFY(m_wndToolBar.SetButtonText(5, _T("Copy")));
VERIFY(m_wndToolBar.SetButtonText(6, _T("Paste")));
VERIFY(m_wndToolBar.SetButtonText(8, _T("Print")));
VERIFY(m_wndToolBar.SetButtonText(9, _T("About")));

CRect temp;
m_wndToolBar.GetItemRect(0,&temp);
m_wndToolBar.SetSizes(CSize(temp.Width(),
   temp.Height()),CSize(16,15));

另請參閱

MFC 範例 CTRLBARS
MFC 範例 DLGCBR32
MFC 範例 DOCKTOOL
CControlBar 類
 階層架構圖表
 CToolBarCtrl 類

共用方式為

CToolBar 類別

語法

成員

公用建構函式

公用方法

備註

繼承階層架構

需求

CToolBar::CommandToIndex

參數

傳回值

CToolBar::Create

參數

傳回值

備註

範例

CToolBar::CreateEx

參數

傳回值

備註

範例

CToolBar::CToolBar

備註

CToolBar::GetButtonInfo

參數

備註

CToolBar::GetButtonStyle

參數

傳回值

備註

CToolBar::GetButtonText

參數

傳回值

備註

CToolBar::GetItemID

參數

傳回值

備註

CToolBar::GetItemRect

參數

備註

範例

CToolBar::GetToolBarCtrl

傳回值

備註

範例

CToolBar::LoadBitmap

參數

傳回值

備註

CToolBar::LoadToolBar

參數

傳回值

備註

範例

CToolBar::SetBitmap

參數

傳回值

備註

CToolBar::SetButtonInfo

參數

備註

CToolBar::SetButtons

參數

傳回值

備註

CToolBar::SetButtonStyle

參數

備註

CToolBar::SetButtonText

參數

傳回值

範例

CToolBar::SetHeight

參數

備註

CToolBar::SetSizes

參數

備註

`CToolBar` 類別

`CToolBar::CommandToIndex`

`CToolBar::Create`

`CToolBar::CreateEx`

`CToolBar::CToolBar`

`CToolBar::GetButtonInfo`

`CToolBar::GetButtonStyle`

`CToolBar::GetButtonText`

`CToolBar::GetItemID`

`CToolBar::GetItemRect`

`CToolBar::GetToolBarCtrl`

`CToolBar::LoadBitmap`

`CToolBar::LoadToolBar`

`CToolBar::SetBitmap`

`CToolBar::SetButtonInfo`

`CToolBar::SetButtons`

`CToolBar::SetButtonStyle`

`CToolBar::SetButtonText`

`CToolBar::SetHeight`

`CToolBar::SetSizes`