CToolBar Kelas

Bilah kontrol yang memiliki baris tombol bitmapped dan pemisah opsional.

Sintaks

class CToolBar : public CControlBar

Anggota

Konstruktor Publik

Nama	Deskripsi
CToolBar::CToolBar	Membuat CToolBar objek.

Metode Publik

Nama	Deskripsi
CToolBar::CommandToIndex	Mengembalikan indeks tombol dengan ID perintah yang diberikan.
CToolBar::Create	Membuat bilah alat Windows dan melampirkannya ke CToolBar objek.
CToolBar::CreateEx	CToolBar Membuat objek dengan gaya tambahan untuk objek yang disematkanCToolBarCtrl.
CToolBar::GetButtonInfo	Mengambil ID, gaya, dan nomor gambar tombol.
CToolBar::GetButtonStyle	Mengambil gaya untuk tombol.
CToolBar::GetButtonText	Mengambil teks yang akan muncul pada tombol.
CToolBar::GetItemID	Mengembalikan ID perintah tombol atau pemisah pada indeks yang diberikan.
CToolBar::GetItemRect	Mengambil persegi panjang tampilan untuk item pada indeks yang diberikan.
CToolBar::GetToolBarCtrl	Memungkinkan akses langsung ke kontrol umum yang mendasar.
CToolBar::LoadBitmap	Memuat bitmap yang berisi gambar bitmap-button.
CToolBar::LoadToolBar	Memuat sumber daya toolbar yang dibuat dengan editor sumber daya.
CToolBar::SetBitmap	Mengatur gambar bitmapped.
CToolBar::SetButtonInfo	Mengatur ID, gaya, dan nomor gambar tombol.
CToolBar::SetButtons	Mengatur gaya tombol dan indeks gambar tombol dalam bitmap.
CToolBar::SetButtonStyle	Mengatur gaya untuk tombol.
CToolBar::SetButtonText	Mengatur teks yang akan muncul pada tombol.
CToolBar::SetHeight	Mengatur tinggi bilah alat.
CToolBar::SetSizes	Mengatur ukuran tombol dan bitmapnya.

Keterangan

Tombol dapat bertindak seperti tombol tekan, tombol kotak centang, atau tombol radio. CToolBar objek biasanya disematkan anggota objek jendela bingkai yang berasal dari kelas CFrameWnd atau CMDIFrameWnd.

CToolBar::GetToolBarCtrl, fungsi anggota yang baru untuk MFC 4.0, memungkinkan Anda memanfaatkan dukungan kontrol umum Windows untuk penyesuaian toolbar dan fungsionalitas tambahan. CToolBar fungsi anggota memberi Anda sebagian besar fungsionalitas kontrol umum Windows; namun, ketika Anda memanggil GetToolBarCtrl, Anda dapat memberi toolbar Anda lebih banyak karakteristik toolbar Windows 95/98. Saat Anda memanggil GetToolBarCtrl, itu akan mengembalikan referensi ke CToolBarCtrl objek. Lihat CToolBarCtrl untuk informasi selengkapnya tentang merancang bilah alat menggunakan kontrol umum Windows. Untuk informasi umum selengkapnya tentang kontrol umum, lihat Kontrol Umum di Windows SDK.

Visual C++ memberi Anda dua metode untuk membuat toolbar. Untuk membuat sumber daya toolbar menggunakan Editor Sumber Daya, ikuti langkah-langkah berikut:

1. Buat sumber daya toolbar.

2. Buat CToolBar objek.

3. Create Panggil fungsi (atau CreateEx) untuk membuat toolbar Windows dan melampirkannya ke CToolBar objek.

4. Panggil LoadToolBar untuk memuat sumber daya toolbar.

Jika tidak, ikutilah langkah-langkah berikut:

1. Buat CToolBar objek.

2. Create Panggil fungsi (atau CreateEx) untuk membuat toolbar Windows dan melampirkannya ke CToolBar objek.

3. Panggil LoadBitmap untuk memuat bitmap yang berisi gambar tombol toolbar.

4. Panggil SetButtons untuk mengatur gaya tombol dan kaitkan setiap tombol dengan gambar di bitmap.

Semua gambar tombol di toolbar diambil dari satu bitmap, yang harus berisi satu gambar untuk setiap tombol. Semua gambar harus berukuran sama; defaultnya adalah lebar 16 piksel dan tinggi 15 piksel. Gambar harus berdampingan di bitmap.

Fungsi ini SetButtons mengambil penunjuk ke array ID kontrol dan bilangan bulat yang menentukan jumlah elemen dalam array. Fungsi mengatur ID setiap tombol ke nilai elemen array yang sesuai dan menetapkan setiap tombol indeks gambar, yang menentukan posisi gambar tombol dalam bitmap. Jika elemen array memiliki nilai ID_SEPARATOR, tidak ada indeks gambar yang ditetapkan.

Urutan gambar dalam bitmap biasanya adalah urutan di mana gambar digambar di layar, tetapi Anda dapat menggunakan SetButtonInfo fungsi untuk mengubah hubungan antara urutan gambar dan urutan gambar.

Semua tombol dalam toolbar berukuran sama. Defaultnya adalah 24 x 22 piksel, sesuai dengan Pedoman Antarmuka Windows untuk Desain Perangkat Lunak. Ruang tambahan antara dimensi gambar dan tombol digunakan untuk membentuk batas di sekitar gambar.

Setiap tombol memiliki satu gambar. Berbagai status dan gaya tombol (ditekan, atas, bawah, dinonaktifkan, dinonaktifkan, dan tidak ditentukan) dihasilkan dari satu gambar tersebut. Meskipun bitmap bisa berwarna apa pun, Anda dapat mencapai hasil terbaik dengan gambar dalam warna hitam dan warna abu-abu.

Tombol toolbar meniru tombol push secara default. Namun, tombol toolbar juga dapat meniru tombol kotak centang atau tombol radio. Tombol kotak centang memiliki tiga status: dicentang, dikosongkan, dan tidak ditentukan. Tombol radio hanya memiliki dua status: dicentang dan dibersihkan.

Untuk mengatur tombol individual atau gaya pemisah tanpa menunjuk ke array, panggil GetButtonStyle untuk mengambil gaya, lalu panggil SetButtonStyle alih-alih SetButtons. SetButtonStyle paling berguna ketika Anda ingin mengubah gaya tombol pada waktu proses.

Untuk menetapkan teks agar muncul pada tombol, panggil GetButtonText untuk mengambil teks agar muncul di tombol, lalu panggil SetButtonText untuk mengatur teks.

Untuk membuat tombol kotak centang, tetapkan gaya TBBS_CHECKBOX atau gunakan CCmdUI fungsi anggota objek SetCheck dalam ON_UPDATE_COMMAND_UI handler. SetCheck Panggilan mengubah tombol tekan menjadi tombol kotak centang. Berikan SetCheck argumen 0 untuk tidak dicentang, 1 untuk diperiksa, atau 2 untuk tidak ditentukan.

Untuk membuat tombol radio, panggil CCmdUI fungsi anggota objek SetRadio dari ON_UPDATE_COMMAND_UI handler. Berikan SetRadio argumen 0 untuk tidak dicentang atau bukan nol untuk diperiksa. Untuk memberikan perilaku grup radio yang saling eksklusif, Anda harus memiliki ON_UPDATE_COMMAND_UI handler untuk semua tombol dalam grup.

Untuk informasi selengkapnya tentang menggunakan CToolBar, lihat artikel Implementasi Toolbar MFC dan Catatan Teknis 31: Bilah Kontrol.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CControlBar

CToolBar

Persyaratan

Header: afxext.h

CToolBar::CommandToIndex

Fungsi anggota ini mengembalikan indeks tombol toolbar pertama, mulai dari posisi 0, yang ID perintahnya cocok nIDFind.

int CommandToIndex(UINT nIDFind) const;

Parameter

nIDFind
ID Perintah tombol toolbar.

Tampilkan Nilai

Indeks tombol, atau -1 jika tidak ada tombol yang memiliki ID perintah yang diberikan.

CToolBar::Create

Fungsi anggota ini membuat bilah alat Windows (jendela anak) dan mengaitkannya dengan CToolBar objek.

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

Parameter

pParentWnd
Penunjuk ke jendela yang merupakan induk bilah alat.

dwStyle
Gaya bilah alat. Gaya toolbar tambahan yang didukung adalah:

• CBRS_TOP Bilah kontrol berada di bagian atas jendela bingkai.

• CBRS_BOTTOM Bilah kontrol berada di bagian bawah jendela bingkai.

• CBRS_NOALIGN Bilah kontrol tidak diposisikan ulang saat induk diubah ukurannya.

• CBRS_TOOLTIPS Bilah kontrol menampilkan tips alat.

• CBRS_SIZE_DYNAMIC Bilah kontrol bersifat dinamis.

• CBRS_SIZE_FIXED Bilah kontrol diperbaiki.

• CBRS_FLOATING Bilah kontrol mengambang.

• CBRS_FLYBY Bilah status menampilkan informasi tentang tombol .

• CBRS_HIDE_INPLACE Bilah kontrol tidak ditampilkan kepada pengguna.

nID
ID jendela anak bilah alat.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Ini juga mengatur tinggi toolbar ke nilai default.

Contoh

// 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

Panggil fungsi ini untuk membuat bilah alat Windows (jendela anak) dan kaitkan dengan CToolBar objek.

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);

Parameter

pParentWnd
Penunjuk ke jendela yang merupakan induk bilah alat.

dwCtrlStyle
Gaya tambahan untuk pembuatan objek yang disematkan CToolBarCtrl . Secara default, nilai ini diset ke TBSTYLE_FLAT. Untuk daftar lengkap gaya toolbar, lihat dwStyle.

dwStyle
Gaya bilah alat. Lihat Kontrol Toolbar dan Gaya Tombol di Windows SDK untuk daftar gaya yang sesuai.

rcBorders
Objek CRect yang menentukan lebar batas jendela toolbar. Batas ini diatur ke 0,0,0,0 secara default, sehingga menghasilkan jendela toolbar tanpa batas.

nID
ID jendela anak bilah alat.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Ini juga mengatur tinggi toolbar ke nilai default.

Gunakan CreateEx, alih-alih Create, ketika gaya tertentu perlu ada selama pembuatan kontrol bilah alat yang disematkan. Misalnya, atur dwCtrlStyle ke TBSTYLE_FLAT | TBSTYLE_TRANSPARENT untuk membuat bilah alat yang menyerupai bilah alat Internet Explorer 4.

Contoh

// 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

Fungsi anggota ini membuat CToolBar objek dan mengatur ukuran default.

CToolBar();

Keterangan

Create Panggil fungsi anggota untuk membuat jendela toolbar.

CToolBar::GetButtonInfo

Fungsi anggota ini mengambil ID kontrol, gaya, dan indeks gambar tombol toolbar atau pemisah di lokasi yang ditentukan oleh nIndex.

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

Parameter

nIndex
Indeks tombol toolbar atau pemisah yang informasinya akan diambil.

nID
Referensi ke UINT yang diatur ke ID perintah tombol.

nStyle
Referensi ke UINT yang diatur ke gaya tombol.

iImage
Referensi ke bilangan bulat yang diatur ke indeks gambar tombol dalam bitmap.

Keterangan

Nilai-nilai tersebut ditetapkan ke variabel yang direferensikan oleh nID, nStyle, dan iImage. Indeks gambar adalah posisi gambar dalam bitmap yang berisi gambar untuk semua tombol toolbar. Gambar pertama berada di posisi 0.

Jika nIndex menentukan pemisah, iImage diatur ke lebar pemisah dalam piksel.

CToolBar::GetButtonStyle

Panggil fungsi anggota ini untuk mengambil gaya tombol atau pemisah pada toolbar.

UINT GetButtonStyle(int nIndex) const;

Parameter

nIndex
Indeks tombol toolbar atau gaya pemisah yang akan diambil.

Tampilkan Nilai

Gaya tombol atau pemisah yang ditentukan oleh nIndex.

Keterangan

Gaya tombol menentukan bagaimana tombol muncul dan bagaimana tombol merespons input pengguna. Lihat SetButtonStyle contoh gaya tombol.

CToolBar::GetButtonText

Panggil fungsi anggota ini untuk mengambil teks yang muncul pada tombol.

CString GetButtonText(int nIndex) const;

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

Parameter

nIndex
Indeks teks yang akan diambil.

rString
Referensi ke CString objek yang akan berisi teks yang akan diambil.

Tampilkan Nilai

Objek CString yang berisi teks tombol.

Keterangan

Bentuk kedua fungsi anggota ini mengisi CString objek dengan teks string.

CToolBar::GetItemID

Fungsi anggota ini mengembalikan ID perintah tombol atau pemisah yang ditentukan oleh nIndex.

UINT GetItemID(int nIndex) const;

Parameter

nIndex
Indeks item yang ID-nya akan diambil.

Tampilkan Nilai

ID perintah tombol atau pemisah yang ditentukan oleh nIndex.

Keterangan

Pemisah mengembalikan ID_SEPARATOR.

CToolBar::GetItemRect

Fungsi anggota ini mengisi RECT struktur yang alamatnya terkandung dalam lpRect dengan koordinat tombol atau pemisah yang ditentukan oleh nIndex.

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

Parameter

nIndex
Indeks item (tombol atau pemisah) yang koordinat persegi panjangnya akan diambil.

lpRect
RECT Alamat struktur yang akan berisi koordinat item.

Keterangan

Koordinat dalam piksel relatif terhadap sudut kiri atas toolbar.

Gunakan GetItemRect untuk mendapatkan koordinat pemisah yang ingin Anda ganti dengan kotak kombo atau kontrol lainnya.

Contoh

Lihat contoh untuk CToolBar::SetSizes.

CToolBar::GetToolBarCtrl

Fungsi anggota ini memungkinkan akses langsung ke kontrol umum yang mendasar.

CToolBarCtrl& GetToolBarCtrl() const;

Tampilkan Nilai

Referensi ke CToolBarCtrl objek.

Keterangan

Gunakan GetToolBarCtrl untuk memanfaatkan fungsionalitas kontrol umum toolbar Windows, dan untuk memanfaatkan dukungan CToolBarCtrl yang disediakan untuk penyesuaian toolbar.

Untuk informasi selengkapnya tentang menggunakan kontrol umum, lihat artikel Kontrol dan Kontrol Umum di Windows SDK.

Contoh

// 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

Panggil fungsi anggota ini untuk memuat bitmap yang ditentukan oleh lpszResourceName atau nIDResource.

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

Parameter

lpszResourceName
Penunjuk ke nama sumber daya bitmap yang akan dimuat.

nIDResource
ID sumber daya bitmap yang akan dimuat.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Bitmap harus berisi satu gambar untuk setiap tombol toolbar. Jika gambar tidak berukuran standar (lebar 16 piksel dan tinggi 15 piksel), panggil SetSizes untuk mengatur ukuran tombol dan gambarnya.

CToolBar::LoadToolBar

Panggil fungsi anggota ini untuk memuat toolbar yang ditentukan oleh lpszResourceName atau nIDResource.

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

Parameter

lpszResourceName
Arahkan ke nama sumber daya toolbar yang akan dimuat.

nIDResource
ID sumber daya toolbar yang akan dimuat.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Lihat editor toolbar di untuk informasi selengkapnya tentang membuat sumber daya toolbar.

Contoh

Lihat contoh untuk CToolBar::CreateEx.

CToolBar::SetBitmap

Panggil fungsi anggota ini untuk mengatur gambar bitmap untuk toolbar.

BOOL SetBitmap(HBITMAP hbmImageWell);

Parameter

hbmImageWell
Menangani gambar bitmap yang terkait dengan toolbar.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Misalnya, panggil SetBitmap untuk mengubah gambar bitmapped setelah pengguna mengambil tindakan pada dokumen yang mengubah tindakan tombol.

CToolBar::SetButtonInfo

Panggil fungsi anggota ini untuk mengatur ID perintah, gaya, dan nomor gambar tombol.

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

Parameter

nIndex
Indeks berbasis nol tombol atau pemisah yang informasinya akan diatur.

nID
Nilai tempat ID perintah tombol diatur.

nStyle
Gaya tombol baru. Gaya tombol berikut didukung:

• TBBS_BUTTON Tombol dorong standar (default)

• TBBS_SEPARATOR Pemisah

• TBBS_CHECKBOX Tombol kotak centang otomatis

• TBBS_GROUP Menandai awal sekelompok tombol

• TBBS_CHECKGROUP Menandai awal grup tombol kotak centang

• TBBS_DROPDOWN Membuat tombol daftar drop-down.

• TBBS_AUTOSIZE Lebar tombol akan dihitung berdasarkan teks tombol, bukan pada ukuran gambar.

• TBBS_NOPREFIX Teks tombol tidak akan memiliki awalan akselerator yang terkait dengannya.

iImage
Indeks baru untuk gambar tombol dalam bitmap.

Keterangan

Untuk pemisah, yang memiliki gaya TBBS_SEPARATOR, fungsi ini mengatur lebar pemisah dalam piksel ke nilai yang disimpan di iImage.

Untuk informasi tentang gambar dan tombol bitmap, lihat CToolBar Gambaran Umum dan CToolBar::LoadBitmap.

CToolBar::SetButtons

Fungsi anggota ini mengatur ID perintah setiap tombol toolbar ke nilai yang ditentukan oleh elemen array lpIDArrayyang sesuai.

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

Parameter

lpIDArray
Penunjuk ke array id perintah. Dapat berupa NULL untuk mengalokasikan tombol kosong.

nIDCount
Jumlah elemen dalam array yang ditujukkan oleh lpIDArray.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Jika elemen array memiliki nilai ID_SEPARATOR, pemisah dibuat di posisi toolbar yang sesuai. Fungsi ini juga mengatur gaya setiap tombol ke TBBS_BUTTON dan gaya setiap pemisah ke TBBS_SEPARATOR, dan menetapkan indeks gambar ke setiap tombol. Indeks gambar menentukan posisi gambar tombol dalam bitmap.

Anda tidak perlu memperhitungkan pemisah dalam bitmap karena fungsi ini tidak menetapkan indeks gambar untuk pemisah. Jika toolbar Anda memiliki tombol pada posisi 0, 1, dan 3 dan pemisah pada posisi 2, gambar pada posisi 0, 1, dan 2 di bitmap Anda masing-masing ditetapkan ke tombol pada posisi 0, 1, dan 3.

Jika lpIDArray NULL, fungsi ini mengalokasikan ruang untuk jumlah item yang ditentukan oleh nIDCount. Gunakan SetButtonInfo untuk mengatur atribut setiap item.

CToolBar::SetButtonStyle

Panggil fungsi anggota ini untuk mengatur gaya tombol atau pemisah, atau ke tombol grup.

void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parameter

nIndex
Indeks tombol atau pemisah yang informasinya akan diatur.

nStyle
Gaya tombol. Gaya tombol berikut didukung:

• TBBS_BUTTON Tombol dorong standar (default)

• TBBS_SEPARATOR Pemisah

• TBBS_CHECKBOX Tombol kotak centang otomatis

• TBBS_GROUP Menandai awal sekelompok tombol

• TBBS_CHECKGROUP Menandai awal grup tombol kotak centang

• TBBS_DROPDOWN Membuat tombol daftar drop-down

• TBBS_AUTOSIZE Lebar tombol akan dihitung berdasarkan teks tombol, bukan pada ukuran gambar

• TBBS_NOPREFIX Teks tombol tidak akan memiliki awalan akselerator yang terkait dengannya

Keterangan

Gaya tombol menentukan bagaimana tombol muncul dan bagaimana tombol merespons input pengguna.

Sebelum memanggil SetButtonStyle, panggil GetButtonStyle fungsi anggota untuk mengambil tombol atau gaya pemisah.

CToolBar::SetButtonText

Panggil fungsi ini untuk mengatur teks pada tombol.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parameter

nIndex
Indeks tombol yang teksnya akan diatur.

lpszText
Arahkan ke teks yang akan diatur pada tombol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Contoh

Lihat contoh untuk CToolBar::GetToolBarCtrl.

CToolBar::SetHeight

Fungsi anggota ini mengatur tinggi toolbar ke nilai, dalam piksel, yang ditentukan dalam cyHeight.

void SetHeight(int cyHeight);

Parameter

cyHeight
Tinggi dalam piksel toolbar.

Keterangan

Setelah memanggil SetSizes, gunakan fungsi anggota ini untuk mengambil alih tinggi toolbar standar. Jika tinggi terlalu kecil, tombol akan dipotong di bagian bawah.

Jika fungsi ini tidak dipanggil, kerangka kerja menggunakan ukuran tombol untuk menentukan tinggi toolbar.

CToolBar::SetSizes

Panggil fungsi anggota ini untuk mengatur tombol toolbar ke ukuran, dalam piksel, yang ditentukan dalam sizeButton.

void SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parameter

sizeButton
Ukuran dalam piksel setiap tombol.

sizeImage
Ukuran dalam piksel setiap gambar.

Keterangan

Parameter sizeImage harus berisi ukuran, dalam piksel, gambar di bitmap toolbar. Dimensi di sizeButton harus cukup untuk menahan gambar ditambah lebar ekstra 7 piksel dan tinggi ekstra 6 piksel. Fungsi ini juga mengatur tinggi toolbar agar pas dengan tombol.

Panggil fungsi anggota ini hanya untuk toolbar yang tidak mengikuti Panduan Antarmuka Windows untuk rekomendasi Desain Perangkat Lunak untuk ukuran tombol dan gambar.

Contoh

// 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));

Lihat juga

Sampel MFC CTRLBARS
Sampel MFC DLGCBR32
Sampel MFC DOCKTOOL
CControlBar Kelas
Bagan Hierarki
CToolBarCtrl Kelas