Bagikan melalui

CToolBarCtrl Kelas

  • Artikel

Menyediakan fungsionalitas kontrol umum bilah alat Windows.

Sintaks

class CToolBarCtrl : public CWnd

Anggota

Konstruktor Publik

Nama Deskripsi
CToolBarCtrl::CToolBarCtrl Membuat CToolBarCtrl objek.

Metode Publik

Nama Deskripsi
CToolBarCtrl::AddBitmap Menambahkan satu atau beberapa gambar tombol bitmap ke daftar gambar tombol yang tersedia untuk kontrol toolbar.
CToolBarCtrl::AddButtons Menambahkan satu atau beberapa tombol ke kontrol bilah alat.
CToolBarCtrl::AddString Menambahkan string baru, diteruskan sebagai ID sumber daya, ke daftar string internal toolbar.
CToolBarCtrl::AddStrings Menambahkan string atau string baru, yang diteruskan sebagai penunjuk ke buffer string yang dipisahkan NULL, ke daftar string internal toolbar.
CToolBarCtrl::AutoSize Mengubah ukuran kontrol bilah alat.
CToolBarCtrl::ChangeBitmap Mengubah bitmap untuk tombol di kontrol bilah alat saat ini.
CToolBarCtrl::CheckButton Memeriksa atau menghapus tombol yang diberikan dalam kontrol bilah alat.
CToolBarCtrl::CommandToIndex Mengambil indeks berbasis nol untuk tombol yang terkait dengan pengidentifikasi perintah yang ditentukan.
CToolBarCtrl::Create Membuat kontrol bilah alat dan melampirkannya ke CToolBarCtrl objek.
CToolBarCtrl::CreateEx Membuat kontrol bilah alat dengan gaya perluasan Windows yang ditentukan dan melampirkannya ke CToolBarCtrl objek.
CToolBarCtrl::Customize Menampilkan kotak dialog Kustomisasi Bilah Alat.
CToolBarCtrl::DeleteButton Menghapus tombol dari kontrol bilah alat.
CToolBarCtrl::EnableButton Mengaktifkan atau menonaktifkan tombol yang ditentukan dalam kontrol toolbar.
CToolBarCtrl::GetAnchorHighlight Mengambil pengaturan sorotan jangkar untuk bilah alat.
CToolBarCtrl::GetBitmap Mengambil indeks bitmap yang terkait dengan tombol di toolbar.
CToolBarCtrl::GetBitmapFlags Mendapatkan bendera yang terkait dengan bitmap toolbar.
CToolBarCtrl::GetButton Mengambil informasi tentang tombol yang ditentukan dalam kontrol bilah alat.
CToolBarCtrl::GetButtonCount Mengambil hitungan tombol yang saat ini ada di kontrol bilah alat.
CToolBarCtrl::GetButtonInfo Mengambil informasi untuk tombol di bilah alat.
CToolBarCtrl::GetButtonSize Mengambil lebar saat ini dan tinggi tombol bilah alat, dalam piksel.
CToolBarCtrl::GetColorScheme Mengambil skema warna kontrol bilah alat saat ini.
CToolBarCtrl::GetDisabledImageList Mengambil daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol yang dinonaktifkan.
CToolBarCtrl::GetDropTarget IDropTarget Mengambil antarmuka untuk kontrol bilah alat.
CToolBarCtrl::GetExtendedStyle Mengambil gaya yang diperluas untuk kontrol bilah alat.
CToolBarCtrl::GetHotImageList Mengambil daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol "panas". Tombol panas muncul disorot ketika penunjuk mouse berada di atasnya.
CToolBarCtrl::GetHotItem Mengambil indeks item panas di toolbar.
CToolBarCtrl::GetImageList Mengambil daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol dalam status defaultnya.
CToolBarCtrl::GetInsertMark Mengambil tanda penyisipan saat ini untuk bilah alat.
CToolBarCtrl::GetInsertMarkColor Mengambil warna yang digunakan untuk menggambar tanda penyisipan untuk bilah alat.
CToolBarCtrl::GetItemRect Mengambil persegi panjang pembatas tombol dalam kontrol toolbar.
CToolBarCtrl::GetMaxSize Mengambil ukuran total semua tombol dan pemisah yang terlihat di toolbar.
CToolBarCtrl::GetMaxTextRows Mengambil jumlah maksimum baris teks yang ditampilkan pada tombol toolbar.
CToolBarCtrl::GetMetrics Mengambil metrik kontrol toolbar.
CToolBarCtrl::GetPadding Mengambil padding horizontal dan vertikal kontrol bilah alat saat ini.
CToolBarCtrl::GetPressedImageList Mengambil daftar gambar yang digunakan kontrol bilah alat saat ini untuk mewakili tombol dalam status ditekan.
CToolBarCtrl::GetRect Mengambil persegi panjang pembatas untuk tombol toolbar tertentu.
CToolBarCtrl::GetRows Mengambil jumlah baris tombol yang saat ini ditampilkan di toolbar.
CToolBarCtrl::GetState Mengambil informasi tentang status tombol yang ditentukan dalam kontrol toolbar, seperti apakah tombol diaktifkan, ditekan, atau dicentang.
CToolBarCtrl::GetString Mengambil string toolbar.
CToolBarCtrl::GetStyle Mengambil gaya yang saat ini digunakan untuk kontrol bilah alat.
CToolBarCtrl::GetToolTips Mengambil handel kontrol tip alat, jika ada, yang terkait dengan kontrol toolbar.
CToolBarCtrl::HideButton Menyembunyikan atau memperlihatkan tombol yang ditentukan dalam kontrol bilah alat.
CToolBarCtrl::HitTest Menentukan di mana titik berada dalam kontrol toolbar.
CToolBarCtrl::Indeterminate Mengatur atau menghapus status yang tidak ditentukan (abu-abu) dari tombol yang ditentukan dalam kontrol toolbar.
CToolBarCtrl::InsertButton Sisipkan tombol dalam kontrol bilah alat.
CToolBarCtrl::InsertMarkHitTest Mengambil informasi tanda penyisipan untuk titik di toolbar.
CToolBarCtrl::IsButtonChecked Memberi tahu apakah tombol yang ditentukan dalam kontrol bilah alat dicentang.
CToolBarCtrl::IsButtonEnabled Memberi tahu apakah tombol yang ditentukan dalam kontrol bilah alat diaktifkan.
CToolBarCtrl::IsButtonHidden Memberi tahu apakah tombol yang ditentukan dalam kontrol bilah alat disembunyikan.
CToolBarCtrl::IsButtonHighlighted Memeriksa status sorotan tombol bilah alat.
CToolBarCtrl::IsButtonIndeterminate Memberi tahu apakah status tombol yang ditentukan dalam kontrol toolbar tidak ditentukan (abu-abu).
CToolBarCtrl::IsButtonPressed Memberi tahu apakah tombol yang ditentukan dalam kontrol bilah alat ditekan.
CToolBarCtrl::LoadImages Memuat bitmap ke dalam daftar gambar kontrol toolbar.
CToolBarCtrl::MapAccelerator Memetakan karakter akselerator ke tombol bilah alat.
CToolBarCtrl::MarkButton Mengatur status sorotan tombol yang diberikan dalam kontrol toolbar.
CToolBarCtrl::MoveButton Memindahkan tombol dari satu indeks ke indeks lainnya.
CToolBarCtrl::PressButton Menekan atau melepaskan tombol yang ditentukan dalam kontrol toolbar.
CToolBarCtrl::ReplaceBitmap Mengganti bitmap yang ada di kontrol bilah alat saat ini dengan bitmap baru.
CToolBarCtrl::RestoreState Memulihkan status kontrol bilah alat.
CToolBarCtrl::SaveState Menyimpan status kontrol bilah alat.
CToolBarCtrl::SetAnchorHighlight Mengatur pengaturan sorotan jangkar untuk bilah alat.
CToolBarCtrl::SetBitmapSize Mengatur ukuran gambar bitmapped yang akan ditambahkan ke kontrol toolbar.
CToolBarCtrl::SetButtonInfo Menyetel informasi untuk tombol yang ada di bilah alat.
CToolBarCtrl::SetButtonSize Mengatur ukuran tombol yang akan ditambahkan ke kontrol bilah alat.
CToolBarCtrl::SetButtonStructSize Menentukan ukuran TBBUTTON struktur.
CToolBarCtrl::SetButtonWidth Mengatur lebar tombol minimum dan maksimum dalam kontrol bilah alat.
CToolBarCtrl::SetCmdID Mengatur pengidentifikasi perintah yang akan dikirim ke jendela pemilik saat tombol yang ditentukan ditekan.
CToolBarCtrl::SetColorScheme Menyetel skema warna kontrol bilah alat saat ini.
CToolBarCtrl::SetDisabledImageList Mengatur daftar gambar yang akan digunakan kontrol bilah alat untuk menampilkan tombol yang dinonaktifkan.
CToolBarCtrl::SetDrawTextFlags Mengatur bendera dalam fungsi DrawTextWin32 , yang digunakan untuk menggambar teks dalam persegi panjang yang ditentukan, diformat sesuai dengan cara bendera diatur.
CToolBarCtrl::SetExtendedStyle Mengatur gaya yang diperluas untuk kontrol bilah alat.
CToolBarCtrl::SetHotImageList Mengatur daftar gambar yang akan digunakan kontrol toolbar untuk menampilkan tombol "panas".
CToolBarCtrl::SetHotItem Mengatur item panas di bilah alat.
CToolBarCtrl::SetImageList Mengatur daftar gambar yang akan digunakan bilah alat untuk menampilkan tombol yang berada dalam status defaultnya.
CToolBarCtrl::SetIndent Mengatur indentasi untuk tombol pertama dalam kontrol toolbar.
CToolBarCtrl::SetInsertMark Menyetel tanda penyisipan saat ini untuk bilah alat.
CToolBarCtrl::SetInsertMarkColor Mengatur warna yang digunakan untuk menggambar tanda penyisipan untuk bilah alat.
CToolBarCtrl::SetMaxTextRows Mengatur jumlah maksimum baris teks yang ditampilkan pada tombol toolbar.
CToolBarCtrl::SetMetrics Mengatur metrik kontrol toolbar.
CToolBarCtrl::SetOwner Mengatur jendela untuk menerima pesan pemberitahuan dari kontrol bilah alat.
CToolBarCtrl::SetPadding Mengatur padding horizontal dan vertikal kontrol bilah alat saat ini.
CToolBarCtrl::SetPressedImageList Mengatur daftar gambar yang digunakan kontrol bilah alat saat ini untuk mewakili tombol dalam status ditekan.
CToolBarCtrl::SetRows Mengatur jumlah baris tombol yang ditampilkan di toolbar.
CToolBarCtrl::SetState Mengatur status untuk tombol yang ditentukan dalam kontrol bilah alat.
CToolBarCtrl::SetStyle Mengatur gaya untuk kontrol bilah alat.
CToolBarCtrl::SetToolTips Mengaitkan kontrol tips alat dengan kontrol toolbar.
CToolBarCtrl::SetWindowTheme Mengatur gaya visual kontrol bilah alat.

Keterangan

Kontrol ini (dan oleh karena itu CToolBarCtrl kelas) hanya tersedia untuk program yang berjalan di bawah Windows 95/98 dan Windows NT versi 3.51 dan yang lebih baru.

Kontrol umum bilah alat Windows adalah jendela anak persegi panjang yang berisi satu atau beberapa tombol. Tombol-tombol ini dapat menampilkan gambar bitmap, string, atau keduanya. Saat pengguna memilih tombol, pengguna mengirim pesan perintah ke jendela pemilik toolbar. Biasanya, tombol di toolbar sesuai dengan item di menu aplikasi; mereka menyediakan cara yang lebih langsung bagi pengguna untuk mengakses perintah aplikasi.

CToolBarCtrl objek berisi beberapa struktur data internal penting: daftar bitmap gambar tombol atau daftar gambar, daftar string label tombol, dan daftar TBBUTTON struktur yang mengaitkan gambar dan/atau string dengan posisi, gaya, status, dan ID perintah tombol. Masing-masing elemen struktur data ini disebut oleh indeks berbasis nol. Sebelum dapat menggunakan CToolBarCtrl objek, Anda harus menyiapkan struktur data ini. Daftar string hanya dapat digunakan untuk label tombol; Anda tidak dapat mengambil string dari toolbar.

Untuk menggunakan CToolBarCtrl objek, Anda biasanya akan mengikuti langkah-langkah berikut:

  1. Buat CToolBarCtrl objek.

  2. Panggil Create untuk membuat kontrol umum bilah alat Windows dan melampirkannya ke CToolBarCtrl objek. Tunjukkan gaya toolbar dengan menggunakan gaya, seperti TBSTYLE_TRANSPARENT untuk toolbar transparan atau TBSTYLE_DROPDOWN untuk toolbar yang mendukung tombol gaya drop-down.

  3. Identifikasi bagaimana Anda ingin tombol pada toolbar ditampilkan:

    • Untuk menggunakan gambar bitmap untuk tombol, tambahkan bitmap tombol ke toolbar dengan memanggil AddBitmap.

    • Untuk menggunakan gambar yang ditampilkan dari daftar gambar untuk tombol, tentukan daftar gambar dengan memanggil SetImageList, , SetHotImageListatau SetDisabledImageList.

    • Untuk menggunakan label string untuk tombol, tambahkan string ke toolbar dengan memanggil AddString dan/atau AddStrings.

  4. Tambahkan struktur tombol ke toolbar dengan memanggil AddButtons.

  5. Jika Anda menginginkan tips alat untuk tombol toolbar di jendela pemilik yang bukan CFrameWnd, Anda perlu menangani TTN_NEEDTEXT pesan di jendela pemilik toolbar seperti yang dijelaskan dalam Menangani Pemberitahuan Tips Alat. Jika jendela induk toolbar berasal dari CFrameWnd, tips alat ditampilkan tanpa upaya tambahan dari Anda karena CFrameWnd menyediakan handler default.

  6. Jika Anda ingin pengguna Anda dapat menyesuaikan toolbar, tangani pesan pemberitahuan kustomisasi di jendela pemilik seperti yang dijelaskan dalam Menangani Pemberitahuan Kustomisasi.

Anda dapat menggunakan SaveState untuk menyimpan status kontrol toolbar saat ini di registri dan RestoreState memulihkan status berdasarkan informasi yang sebelumnya disimpan dalam registri. Selain menyimpan status toolbar antara penggunaan aplikasi, aplikasi biasanya menyimpan status sebelum pengguna mulai menyesuaikan toolbar jika pengguna nantinya ingin memulihkan toolbar ke status aslinya.

Dukungan untuk Internet Explorer Versi 4.0 dan yang lebih baru

Untuk mendukung fungsionalitas yang diperkenalkan di Internet Explorer, versi 4.0 dan yang lebih baru, MFC menyediakan dukungan daftar gambar dan gaya transparan dan datar untuk kontrol toolbar.

Toolbar transparan memungkinkan klien di bawah toolbar untuk ditampilkan. Untuk membuat toolbar transparan, gunakan gaya TBSTYLE_FLAT dan TBSTYLE_TRANSPARENT . Toolbar transparan menampilkan pelacakan panas; yaitu, ketika penunjuk mouse bergerak di atas tombol panas pada toolbar, tampilan tombol berubah. Toolbar yang dibuat hanya TBSTYLE_FLAT dengan gaya akan berisi tombol yang tidak transparan.

Dukungan daftar gambar memungkinkan fleksibilitas yang lebih besar untuk perilaku default, gambar panas, dan gambar yang dinonaktifkan. Gunakan GetImageList, GetHotImageList, dan GetDisabledImageList dengan toolbar transparan untuk memanipulasi gambar sesuai dengan statusnya:

Untuk informasi selengkapnya tentang menggunakan CToolBarCtrl, lihat Kontrol dan Menggunakan CToolBarCtrl.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CToolBarCtrl

Persyaratan

Header: afxcmn.h

CToolBarCtrl::AddBitmap

Menambahkan satu atau beberapa gambar tombol ke daftar gambar tombol yang disimpan dalam kontrol toolbar.

int AddBitmap(
    int nNumButtons,
    UINT nBitmapID);

int AddBitmap(
    int nNumButtons,
    CBitmap* pBitmap);

Parameter

nNumButtons
Jumlah gambar tombol dalam bitmap.

nBitmapID
Pengidentifikasi sumber daya bitmap yang berisi gambar atau gambar tombol untuk ditambahkan.

pBitmap
Arahkan ke CBitmap objek yang berisi gambar tombol atau gambar untuk ditambahkan.

Tampilkan Nilai

Indeks berbasis nol dari gambar baru pertama jika berhasil; jika tidak - 1.

Keterangan

Anda dapat menggunakan WINDOWS API CreateMappedBitmap untuk memetakan warna sebelum menambahkan bitmap ke toolbar. Jika Anda meneruskan penunjuk ke CBitMap objek, Anda harus memastikan bahwa bitmap tidak dihancurkan sampai setelah toolbar dihancurkan.

CToolBarCtrl::AddButtons

Menambahkan satu atau beberapa tombol ke kontrol bilah alat.

BOOL AddButtons(
    int nNumButtons,
    LPTBBUTTON lpButtons);

Parameter

nNumButtons
Jumlah tombol yang akan ditambahkan.

lpButtons
Alamat array TBBUTTON struktur yang berisi informasi tentang tombol yang akan ditambahkan. Harus ada jumlah elemen yang sama dalam array sebagai tombol yang ditentukan oleh nNumButtons.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Penunjuk lpButtons menunjuk ke array TBBUTTON struktur. Setiap TBBUTTON struktur mengaitkan tombol yang ditambahkan dengan gaya tombol, gambar dan/atau string, ID perintah, status, dan data yang ditentukan pengguna:

typedef struct _TBBUTTON {
    int iBitmap;    // zero-based index of button image
    int idCommand;  // command to be sent when button pressed
    BYTE fsState;   // button state--see below
    BYTE fsStyle;   // button style--see below
    DWORD dwData;   // application-defined value
    int iString;    // zero-based index of button label string
} TBBUTTON;

Anggotanya adalah sebagai berikut:

  • iBitmap

    Indeks gambar tombol berbasis nol, -1 jika tidak ada gambar untuk tombol ini.

  • idCommand

    Pengidentifikasi perintah yang terkait dengan tombol . Pengidentifikasi ini dikirim dalam pesan WM_COMMAND ketika tombol dipilih. fsStyle Jika anggota memiliki TBSTYLE_SEP nilai , anggota ini harus nol.

  • fsState

    Bendera status tombol. Ini bisa menjadi kombinasi dari nilai yang tercantum di bawah ini:

    • TBSTATE_CHECKED Tombol memiliki TBSTYLE_CHECKED gaya dan sedang ditekan.

    • TBSTATE_ENABLED Tombol menerima input pengguna. Tombol yang tidak memiliki status ini tidak menerima input pengguna dan berwarna abu-abu.

    • TBSTATE_HIDDEN Tombol tidak terlihat dan tidak dapat menerima input pengguna.

    • TBSTATE_INDETERMINATE Tombol berwarna abu-abu.

    • TBSTATE_PRESSED Tombol sedang ditekan.

    • TBSTATE_WRAP Pemisah baris mengikuti tombol . Tombol juga harus memiliki status TBSTATE_ENABLED .

  • fsStyle

    Gaya tombol. Ini bisa menjadi kombinasi dari nilai yang tercantum di bawah ini:

    • TBSTYLE_BUTTON Membuat tombol tekan standar.

    • TBSTYLE_CHECK Membuat tombol yang beralih antara status yang ditekan dan tidak tertekan setiap kali pengguna mengkliknya. Tombol memiliki warna latar belakang yang berbeda ketika berada dalam status ditekan.

    • TBSTYLE_CHECKGROUP Membuat tombol centang yang tetap ditekan hingga tombol lain dalam grup ditekan.

    • TBSTYLE_GROUP Membuat tombol yang tetap ditekan hingga tombol lain dalam grup ditekan.

    • TBSTYLE_SEP Membuat pemisah, memberikan celah kecil di antara grup tombol. Tombol yang memiliki gaya ini tidak menerima input pengguna.

  • dwData

    Data yang ditentukan pengguna.

  • iString

    Indeks berbasis nol dari string yang akan digunakan sebagai label tombol, -1 jika tidak ada string untuk tombol ini.

Gambar dan/atau string yang indeksnya Anda berikan sebelumnya harus ditambahkan ke daftar kontrol toolbar menggunakan AddBitmap, , AddStringdan/atau AddStrings.

CToolBarCtrl::AddString

Menambahkan string baru, diteruskan sebagai ID sumber daya, ke daftar string internal toolbar.

int AddString(UINT nStringID);

Parameter

nStringID
Pengidentifikasi sumber daya sumber daya string untuk ditambahkan ke daftar string kontrol toolbar.

Tampilkan Nilai

Indeks berbasis nol dari string baru pertama yang ditambahkan jika berhasil; jika tidak -1.

CToolBarCtrl::AddStrings

Menambahkan string atau string baru ke daftar string yang tersedia untuk kontrol toolbar.

int AddStrings(LPCTSTR lpszStrings);

Parameter

lpszStrings
Alamat buffer yang berisi satu atau beberapa NULLstring yang dihentikan untuk ditambahkan ke daftar string toolbar. String terakhir harus dihentikan dengan dua NULL karakter.

Tampilkan Nilai

Indeks berbasis nol dari string baru pertama yang ditambahkan jika berhasil; jika tidak -1.

Keterangan

String dalam buffer harus dipisahkan oleh NULL karakter. Anda harus memastikan bahwa string terakhir memiliki dua NULL terminator. Untuk memformat string konstanta dengan benar, Anda mungkin menulisnya sebagai:

// one null added automatically
lpszStrings = _T("Only one string to add\0");

atau:

// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");

Anda tidak boleh meneruskan CString objek ke fungsi ini karena tidak mungkin memiliki lebih dari satu NULL karakter dalam .CString

CToolBarCtrl::AutoSize

Mengubah ukuran seluruh kontrol toolbar.

void AutoSize();

Keterangan

Anda harus memanggil fungsi ini ketika ukuran jendela induk berubah atau ketika ukuran toolbar berubah (seperti ketika Anda mengatur tombol atau ukuran bitmap, atau menambahkan string).

CToolBarCtrl::ChangeBitmap

Mengubah bitmap untuk tombol di kontrol bilah alat saat ini.

BOOL ChangeBitmap(
    int idButton,
    int iBitmap);

Parameter

idButton
[di] Pengidentifikasi perintah tombol untuk menerima bitmap baru.

iBitmap
[di] Indeks gambar berbasis nol di daftar gambar kontrol toolbar saat ini.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Jika metode ini berhasil, sistem akan menampilkan gambar yang ditentukan di tombol yang ditentukan.

Metode ini mengirim TB_CHANGEBITMAP pesan, yang dijelaskan dalam Windows SDK.

Contoh

Contoh kode berikut mengubah bitmap untuk tombol Simpan File ke bitmap untuk tombol Tentang .

{
   // Change the bitmap for the File Save button, whose
   // command ID is ID_FILE_SAVE, to the bitmap for the
   // About button, whose index is 7.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ChangeBitmap(ID_FILE_SAVE, 7);
}

CToolBarCtrl::CheckButton

Memeriksa atau menghapus tombol yang diberikan dalam kontrol bilah alat.

BOOL CheckButton(
    int nID,
    BOOL bCheck = TRUE);

Parameter

nID
Pengidentifikasi perintah tombol untuk memeriksa atau menghapus.

bCheck
TRUE untuk memeriksa tombol, FALSE untuk menghapusnya.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Ketika tombol telah dicentang, tombol tampaknya telah ditekan. Jika Anda ingin mengubah lebih dari satu status tombol, pertimbangkan untuk memanggil SetState sebagai gantinya.

CToolBarCtrl::CommandToIndex

Mengambil indeks berbasis nol untuk tombol yang terkait dengan pengidentifikasi perintah yang ditentukan.

UINT CommandToIndex(UINT nID) const;

Parameter

nID
ID Perintah yang indeks tombolnya ingin Anda temukan.

Tampilkan Nilai

Indeks berbasis nol untuk tombol yang terkait dengan ID perintah.

Keterangan

CToolBarCtrl::Create

Membuat kontrol bilah alat dan melampirkannya ke CToolBarCtrl objek.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Menentukan gaya kontrol bilah alat. Bilah alat harus selalu memiliki WS_CHILD gaya. Selain itu, Anda dapat menentukan kombinasi gaya toolbar dan gaya jendela seperti yang dijelaskan di bawah Keterangan.

rect
Secara opsional menentukan ukuran dan posisi kontrol toolbar. Ini bisa berupa CRect objek atau RECT struktur.

pParentWnd
Menentukan jendela induk kontrol bilah alat. Ini tidak boleh NULL.

nID
Menentukan ID kontrol bilah alat.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Anda membangun CToolBarCtrl dalam dua langkah. Pertama, panggil konstruktor, lalu panggil Create, yang membuat kontrol toolbar dan melampirkannya ke CToolBarCtrl objek. Terapkan gaya jendela berikut ke kontrol bilah alat.

  • WS_CHILD Selalu

  • WS_VISIBLE Biasanya

  • WS_DISABLED Jarang

Lihat CreateWindow di Windows SDK untuk deskripsi gaya jendela.

Secara opsional, terapkan kombinasi gaya kontrol umum, seperti yang dijelaskan dalam Windows SDK.

Terapkan kombinasi gaya toolbar ke kontrol atau tombol itu sendiri. Gaya dijelaskan dalam topik Kontrol Toolbar dan Gaya Tombol di Windows SDK.

Untuk menggunakan gaya toolbar yang diperluas, panggil SetExtendedStyle setelah Anda memanggil Create. Untuk membuat toolbar dengan gaya jendela yang diperluas, panggil CToolBarCtrl::CreateEx alih-alih Create.

Kontrol toolbar secara otomatis mengatur ukuran dan posisi jendela toolbar. Tinggi didasarkan pada tinggi tombol di toolbar. Lebarnya sama dengan lebar area klien jendela induk. Gaya CCS_TOP dan CCS_BOTTOM menentukan apakah toolbar diposisikan di sepanjang bagian atas atau bawah area klien. Secara default, toolbar memiliki CCS_TOP gaya .

CToolBarCtrl::CreateEx

Membuat kontrol (jendela anak) dan mengaitkannya dengan CToolBarCtrl objek.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Menentukan gaya kontrol yang diperluas yang sedang dibuat. Untuk daftar gaya Windows yang diperluas, lihat dwExStyle parameter untuk CreateWindowEx di Windows SDK.

dwStyle
Menentukan gaya kontrol bilah alat. Bilah alat harus selalu memiliki WS_CHILD gaya. Selain itu, Anda dapat menentukan kombinasi gaya toolbar dan gaya jendela seperti yang dijelaskan di bagian Keterangan dari Create.

rect
Referensi ke struktur yang RECT menjelaskan ukuran dan posisi jendela yang akan dibuat, dalam koordinat klien .pParentWnd

pParentWnd
Penunjuk ke jendela yang merupakan induk kontrol.

nID
ID jendela anak kontrol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Gunakan CreateEx alih-alih Create untuk menerapkan gaya Windows yang diperluas, yang ditentukan oleh preface WS_EX_gaya windows yang diperluas . CreateEx membuat kontrol dengan gaya Windows yang diperluas yang ditentukan oleh dwExStyle. Atur gaya yang diperluas khusus untuk kontrol menggunakan SetExtendedStyle. Misalnya, gunakan CreateEx untuk mengatur gaya seperti WS_EX_CONTEXTHELP, tetapi gunakan SetExtendedStyle untuk mengatur gaya seperti TBSTYLE_EX_DRAWDDARROWS. Untuk informasi selengkapnya, lihat gaya yang dijelaskan di Toolbar Extended Styles di Windows SDK.

CToolBarCtrl::CToolBarCtrl

Membuat CToolBarCtrl objek.

CToolBarCtrl();

Keterangan

Anda harus memanggil Create untuk membuat bilah alat dapat digunakan.

CToolBarCtrl::Customize

Menampilkan kotak dialog Kustomisasi Bilah Alat.

void Customize();

Keterangan

Kotak dialog ini memungkinkan pengguna untuk mengkustomisasi bilah alat dengan menambahkan dan menghapus tombol. Untuk mendukung kustomisasi, jendela induk toolbar Anda harus menangani pesan pemberitahuan kustomisasi seperti yang dijelaskan dalam Menangani Pemberitahuan Kustomisasi. Toolbar Anda juga harus dibuat dengan gaya, seperti yang CCS_ADJUSTABLE dijelaskan dalam CToolBarCtrl::Create.

CToolBarCtrl::DeleteButton

Menghapus tombol dari kontrol bilah alat.

BOOL DeleteButton(int nIndex);

Parameter

nIndex
Indeks berbasis nol tombol untuk dihapus.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

CToolBarCtrl::EnableButton

Mengaktifkan atau menonaktifkan tombol yang ditentukan dalam kontrol toolbar.

BOOL EnableButton(
    int nID,
    BOOL bEnable = TRUE);

Parameter

nID
Pengidentifikasi perintah tombol untuk mengaktifkan atau menonaktifkan.

bEnable
TRUE untuk mengaktifkan tombol; FALSE untuk menonaktifkan tombol .

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Ketika tombol telah diaktifkan, tombol dapat ditekan dan dicentang. Jika Anda ingin mengubah lebih dari satu status tombol, pertimbangkan untuk memanggil SetState sebagai gantinya.

CToolBarCtrl::GetAnchorHighlight

Mengambil pengaturan sorotan jangkar untuk bilah alat.

BOOL GetAnchorHighlight() const;

Tampilkan Nilai

Jika bukan nol, penyorotan jangkar diaktifkan. Jika nol, penyorotan jangkar dinonaktifkan.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETANCHORHIGHLIGHTWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetBitmap

Mengambil indeks bitmap yang terkait dengan tombol di toolbar.

int GetBitmap(int nID) const;

Parameter

nID
Pengidentifikasi perintah tombol yang indeks bitmap-nya akan diambil.

Tampilkan Nilai

Mengembalikan indeks bitmap jika berhasil, atau nol sebaliknya.

Keterangan

Menerapkan fungsionalitas TB_GETBITMAP di Windows SDK.

CToolBarCtrl::GetBitmapFlags

Mengambil bendera bitmap dari bilah alat.

UINT GetBitmapFlags() const;

Tampilkan Nilai

UINT Yang memiliki TBBF_LARGE bendera yang diatur jika tampilan dapat mendukung bitmap toolbar besar, hapus sebaliknya.

Keterangan

Anda harus memanggilnya setelah membuat toolbar tetapi sebelum menambahkan bitmap ke toolbar. Nilai pengembalian menunjukkan apakah tampilan mendukung bitmap besar atau tidak. Jika tampilan mendukung bitmap besar dan jika Anda memilih untuk menggunakannya, panggil SetBitmapSize dan SetButtonSize sebelum menambahkan bitmap besar Anda menggunakan AddBitmap.

CToolBarCtrl::GetButton

Mengambil informasi tentang tombol yang ditentukan dalam kontrol bilah alat.

BOOL GetButton(
    int nIndex,
    LPTBBUTTON lpButton) const;

Parameter

nIndex
Indeks berbasis nol tombol untuk mengambil informasi.

lpButton
TBBUTTON Alamat struktur yang akan menerima salinan informasi tombol. Lihat CToolBarCtrl::AddButtons untuk informasi tentang TBBUTTON struktur.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

CToolBarCtrl::GetButtonCount

Mengambil hitungan tombol yang saat ini ada di kontrol bilah alat.

int GetButtonCount() const;

Tampilkan Nilai

Jumlah tombol.

CToolBarCtrl::GetButtonInfo

Mengambil informasi untuk tombol di bilah alat.

int GetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi) const;

Parameter

nID
Pengidentifikasi tombol.

ptbbi
Penunjuk ke TBBUTTONINFO struktur yang menerima informasi tombol.

Tampilkan Nilai

Indeks berbasis nol tombol, jika berhasil; jika tidak -1.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETBUTTONINFOWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetButtonSize

Mendapatkan ukuran tombol toolbar.

DWORD GetButtonSize() const;

Tampilkan Nilai

Nilai DWORD yang berisi nilai lebar dan tinggi dalam LOWORD dan HIWORD, masing-masing.

CToolBarCtrl::GetButtonText

Mengambil teks tampilan tombol yang ditentukan pada kontrol bilah alat saat ini.

CString GetButtonText(int idButton) const;

Parameter

idButton
[di] Pengidentifikasi untuk tombol yang teks tampilannya diambil.

Tampilkan Nilai

yang CString berisi teks tampilan tombol yang ditentukan.

Keterangan

Metode ini mengirim TB_GETBUTTONTEXT pesan, yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetColorScheme

Mengambil skema warna kontrol bilah alat saat ini.

BOOL GetColorScheme(COLORSCHEME* lpColorScheme) const;

Parameter

lpColorScheme
[out] Penunjuk COLORSCHEME ke struktur yang menerima informasi skema warna. Ketika metode ini kembali, struktur menjelaskan warna sorotan dan warna bayangan kontrol toolbar.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Metode ini mengirim TB_GETCOLORSCHEME pesan, yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetDisabledImageList

Mengambil daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol yang dinonaktifkan.

CImageList* GetDisabledImageList() const;

Tampilkan Nilai

Penunjuk ke CImageList objek, atau NULL jika tidak ada daftar gambar yang dinonaktifkan yang diatur.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETDISABLEDIMAGELISTWin32 , seperti yang dijelaskan dalam Windows SDK. Implementasi GetDisabledImageList MFC menggunakan objek yang CImageList berisi gambar tombol kontrol toolbar, bukan handel ke daftar gambar.

CToolBarCtrl::GetDropTarget

IDropTarget Mengambil antarmuka untuk kontrol bilah alat.

HRESULT GetDropTarget(IDropTarget** ppDropTarget) const;

Parameter

ppDropTarget
Penunjuk ke IDropTarget penunjuk antarmuka. Jika terjadi kesalahan, NULL penunjuk ditempatkan di alamat ini.

Tampilkan Nilai

Mengembalikan nilai yang HRESULT menunjukkan keberhasilan atau kegagalan operasi.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETOBJECTWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetExtendedStyle

Mengambil gaya yang diperluas untuk kontrol bilah alat.

DWORD GetExtendedStyle() const;

Tampilkan Nilai

DWORD yang mewakili gaya yang diperluas yang saat ini digunakan untuk kontrol toolbar. Untuk daftar gaya, lihat Toolbar Extended Styles, di Windows SDK.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETEXTENDEDSTYLEWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetHotImageList

Mengambil daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol "panas". Tombol panas muncul disorot ketika penunjuk mouse berada di atasnya.

CImageList* GetHotImageList() const;

Tampilkan Nilai

Penunjuk ke CImageList objek, atau NULL jika tidak ada daftar gambar yang dinonaktifkan yang diatur.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETHOTIMAGELISTWin32 , seperti yang dijelaskan dalam Windows SDK. Tombol panas muncul disorot ketika penunjuk mouse berada di atasnya.

CToolBarCtrl::GetHotItem

Mengambil indeks item panas di toolbar.

int GetHotItem() const;

Tampilkan Nilai

Indeks berbasis nol dari item panas di toolbar.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETHOTITEMWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetImageList

Mengambil daftar gambar yang digunakan kontrol toolbar untuk menampilkan tombol dalam status defaultnya.

CImageList* GetImageList() const;

Tampilkan Nilai

Penunjuk ke CImageList objek, atau NULL jika tidak ada daftar gambar yang diatur.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETIMAGELISTWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetInsertMark

Mengambil tanda penyisipan saat ini untuk bilah alat.

void GetInsertMark(TBINSERTMARK* ptbim) const;

Parameter

ptbim
Penunjuk ke TBINSERTMARK struktur yang menerima tanda penyisipan.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETINSERTMARKWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetInsertMarkColor

Mengambil warna yang digunakan untuk menggambar tanda penyisipan untuk bilah alat.

COLORREF GetInsertMarkColor() const;

Tampilkan Nilai

Nilai COLORREF yang berisi warna tanda penyisipan saat ini.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETINSERTMARKCOLORWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetItemRect

Mengambil persegi panjang pembatas tombol dalam kontrol toolbar.

BOOL GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parameter

nIndex
Indeks berbasis nol tombol untuk mengambil informasi.

lpRect
RECT Alamat struktur atau CRect objek yang menerima koordinat persegi panjang pembatas.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Fungsi ini tidak mengambil persegi panjang pembatas untuk tombol yang statusnya diatur ke TBSTATE_HIDDEN.

CToolBarCtrl::GetMaxSize

Mengambil ukuran total semua tombol dan pemisah yang terlihat di toolbar.

BOOL GetMaxSize(LPSIZE pSize) const;

Parameter

pSize
Penunjuk ke SIZE struktur yang menerima ukuran item.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETMAXSIZEWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetMaxTextRows

Mengambil jumlah maksimum baris teks yang ditampilkan pada tombol toolbar.

int GetMaxTextRows() const;

Tampilkan Nilai

Jumlah maksimum baris teks yang ditampilkan pada tombol toolbar.

CToolBarCtrl::GetMetrics

Mengambil metrik CToolBarCtrl objek.

void GetMetrics(LPTBMETRICS ptbm) const;

Parameter

ptbm
Penunjuk ke TBMETRICS struktur CToolBarCtrl objek.

Keterangan

Fungsi anggota ini menimulasi fungsionalitas TB_GETMETRICS pesan, seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetPadding

Mengambil padding horizontal dan vertikal kontrol bilah alat saat ini.

BOOL GetPadding(
    int* pnHorzPadding,
    int* pnVertPadding) const;

Parameter

pnHorzPadding
[out] Bilangan bulat yang menerima padding horizontal kontrol toolbar, dalam piksel.

pnVertPadding
[out] Bilangan bulat yang menerima padding vertikal kontrol toolbar, dalam piksel.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Metode ini mengirim TB_GETPADDING pesan, yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetPressedImageList

Mengambil daftar gambar yang digunakan kontrol bilah alat saat ini untuk mewakili tombol dalam status ditekan.

CImageList* GetPressedImageList();

Tampilkan Nilai

Penunjuk ke yang CImageList berisi daftar gambar untuk kontrol saat ini, atau NULL jika tidak ada daftar gambar tersebut yang diatur.

Keterangan

Metode ini mengirim TB_GETPRESSEDIMAGELIST pesan, yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetRect

Mengambil persegi panjang pembatas untuk tombol toolbar tertentu.

BOOL GetRect(
    int nID,
    LPRECT lpRect) const;

Parameter

nID
Pengidentifikasi tombol.

lpRect
Penunjuk ke RECT struktur untuk menerima informasi persegi panjang pembatas.

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETRECTWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetRows

Mengambil jumlah baris tombol yang saat ini ditampilkan oleh kontrol bilah alat.

int GetRows() const;

Tampilkan Nilai

Jumlah baris tombol yang saat ini ditampilkan pada bilah alat.

Keterangan

Perhatikan bahwa jumlah baris akan selalu menjadi satu kecuali toolbar dibuat dengan TBSTYLE_WRAPABLE gaya .

CToolBarCtrl::GetState

Mengambil informasi tentang status tombol yang ditentukan dalam kontrol toolbar, seperti apakah tombol diaktifkan, ditekan, atau dicentang.

int GetState(int nID) const;

Parameter

nID
Pengidentifikasi perintah tombol untuk mengambil informasi.

Tampilkan Nilai

Informasi status tombol jika berhasil atau -1 sebaliknya. Informasi status tombol dapat berupa kombinasi nilai yang tercantum dalam CToolBarCtrl::AddButtons.

Keterangan

Fungsi ini sangat berguna jika Anda ingin mengambil lebih dari salah satu status tombol. Untuk hanya mengambil satu status, gunakan salah satu fungsi anggota berikut: IsButtonEnabled, , IsButtonChecked, IsButtonPressedIsButtonHidden, atau IsButtonIndeterminate. Namun, GetState fungsi anggota adalah satu-satunya cara untuk mendeteksi status tombol TBSTATE_WRAP .

CToolBarCtrl::GetString

Mengambil string toolbar.

int GetString(
    int nString,
    LPTSTR lpstrString,
    int cchMaxLen) const;

int GetString(
    int nString,
    CString& str) const;

Parameter

nString
Indeks string.

lpstrString
Penunjuk ke buffer yang digunakan untuk mengembalikan string.

cchMaxLen
Panjang buffer dalam byte.

str
String.

Tampilkan Nilai

Panjang string jika berhasil, -1 jika tidak.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_GETSTRINGWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetStyle

Mendapatkan gaya yang saat ini diterapkan ke kontrol bilah alat.

DWORD GetStyle() const;

Tampilkan Nilai

Yang DWORD berisi kombinasi gaya kontrol toolbar, seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::GetToolTips

Mengambil handel kontrol tip alat, jika ada, yang terkait dengan kontrol toolbar.

CToolTipCtrl* GetToolTips() const;

Tampilkan Nilai

Penunjuk ke objek yang CToolTipCtrl terkait dengan toolbar ini atau NULL jika toolbar tidak memiliki kontrol tip alat terkait.

Keterangan

Karena kontrol toolbar biasanya membuat dan mempertahankan kontrol tip alatnya sendiri, sebagian besar program tidak perlu memanggil fungsi ini.

CToolBarCtrl::HitTest

Menentukan di mana titik berada dalam kontrol toolbar.

int HitTest(LPPOINT ppt) const;

Parameter

ppt
Pointer ke POINT struktur yang berisi koordinat x dari tes hit di x anggota dan koordinat y dari tes hit pada y anggota. Koordinat relatif terhadap area klien toolbar.

Tampilkan Nilai

Nilai bilangan bulat yang menunjukkan lokasi titik pada toolbar. Jika nilainya nol atau nilai positif, nilai pengembalian ini adalah indeks berbasis nol dari item nonseparator tempat titik berada.

Jika nilai yang dikembalikan negatif, titik tidak terletak di dalam tombol. Nilai absolut dari nilai pengembalian adalah indeks item pemisah atau item nonseparator terdekat.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_HITTESTWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::HideButton

Menyembunyikan atau memperlihatkan tombol yang ditentukan dalam kontrol bilah alat.

BOOL HideButton(
    int nID,
    BOOL bHide = TRUE);

Parameter

nID
Pengidentifikasi perintah tombol untuk menyembunyikan atau menampilkan.

bHide
TRUE untuk menyembunyikan tombol, FALSE untuk menampilkannya.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Jika Anda ingin mengubah lebih dari satu status tombol, pertimbangkan untuk memanggil SetState sebagai gantinya.

CToolBarCtrl::Indeterminate

Mengatur atau menghapus status tombol yang ditentukan dalam kontrol toolbar yang tidak ditentukan.

BOOL Indeterminate(
    int nID,
    BOOL bIndeterminate = TRUE);

Parameter

nID
Pengidentifikasi perintah tombol yang statusnya tidak ditentukan akan diatur atau dibersihkan.

bIndeterminate
TRUE untuk mengatur status yang tidak ditentukan untuk tombol yang ditentukan, FALSE untuk menghapusnya.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Tombol yang tidak ditentukan ditampilkan berwarna abu-abu, seperti cara tombol tebal pada toolbar prosesor kata akan terlihat ketika teks yang dipilih berisi karakter tebal dan reguler. Jika Anda ingin mengubah lebih dari satu status tombol, pertimbangkan untuk memanggil SetState sebagai gantinya.

CToolBarCtrl::InsertButton

Sisipkan tombol dalam kontrol bilah alat.

BOOL InsertButton(
    int nIndex,
    LPTBBUTTON lpButton);

Parameter

nIndex
Indeks berbasis nol tombol. Fungsi ini menyisipkan tombol baru di sebelah kiri tombol ini.

lpButton
Alamat struktur yang TBBUTTON berisi informasi tentang tombol untuk disisipkan. Lihat CToolBarCtrl::AddButtons untuk deskripsi TBBUTTON struktur.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Gambar dan/atau string yang indeksnya Anda berikan sebelumnya harus ditambahkan ke daftar kontrol toolbar menggunakan AddBitmap, , AddStringdan/atau AddStrings.

CToolBarCtrl::InsertMarkHitTest

Mengambil informasi tanda penyisipan untuk titik di toolbar.

BOOL InsertMarkHitTest(
    LPPOINT ppt,
    LPTBINSERTMARK ptbim) const;

Parameter

ppt
Penunjuk ke POINT struktur yang berisi koordinat pengujian hit, relatif terhadap area klien toolbar.

ptbim
Penunjuk ke TBINSERTMARK struktur yang menerima informasi tanda penyisipan.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_INSERTMARKHITTESTWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::IsButtonChecked

Menentukan apakah tombol yang ditentukan dalam kontrol bilah alat dicentang.

BOOL IsButtonChecked(int nID) const;

Parameter

nID
Pengidentifikasi perintah tombol di toolbar.

Tampilkan Nilai

Bukan nol jika tombol dicentang; jika tidak, nol.

Keterangan

Pertimbangkan untuk memanggil GetState jika Anda ingin mengambil lebih dari satu status tombol.

CToolBarCtrl::IsButtonEnabled

Menentukan apakah tombol yang ditentukan dalam kontrol toolbar diaktifkan.

BOOL IsButtonEnabled(int nID) const;

Parameter

nID
Pengidentifikasi perintah tombol di toolbar.

Tampilkan Nilai

Bukan nol jika tombol diaktifkan; jika tidak, nol.

Keterangan

Pertimbangkan untuk memanggil GetState jika Anda ingin mengambil lebih dari satu status tombol.

CToolBarCtrl::IsButtonHidden

Menentukan apakah tombol yang ditentukan dalam kontrol bilah alat disembunyikan.

BOOL IsButtonHidden(int nID) const;

Parameter

nID
Pengidentifikasi perintah tombol di toolbar.

Tampilkan Nilai

Bukan nol jika tombol disembunyikan; jika tidak, nol.

Keterangan

Pertimbangkan untuk memanggil GetState jika Anda ingin mengambil lebih dari satu status tombol.

CToolBarCtrl::IsButtonHighlighted

Memeriksa status sorotan tombol bilah alat.

BOOL IsButtonHighlighted(int nID) const;

Parameter

nID
[di] ID perintah untuk tombol toolbar.

Tampilkan Nilai

Bilangan bulat positif jika tombol disorot, 0 jika tombol tidak disorot, atau -1 jika terjadi kesalahan.

CToolBarCtrl::IsButtonIndeterminate

Menentukan apakah tombol yang ditentukan dalam kontrol toolbar tidak ditentukan.

BOOL IsButtonIndeterminate(int nID) const;

Parameter

nID
[di] Pengidentifikasi perintah tombol di toolbar.

Tampilkan Nilai

Bilangan bulat positif jika tombol tidak ditentukan, nol jika tombol tidak ditentukan, atau -1 jika terjadi kesalahan.

Keterangan

Tombol yang tidak ditentukan ditampilkan redup, seperti cara tombol tebal pada toolbar prosesor kata terlihat ketika teks yang dipilih berisi karakter tebal dan reguler. Pertimbangkan untuk memanggil GetState jika Anda ingin mengambil lebih dari satu status tombol.

CToolBarCtrl::IsButtonPressed

Menentukan apakah tombol yang ditentukan dalam kontrol bilah alat ditekan.

BOOL IsButtonPressed(int nID) const;

Parameter

nID
Pengidentifikasi perintah tombol di toolbar.

Tampilkan Nilai

Bukan nol jika tombol ditekan, jika tidak, nol.

Keterangan

Pertimbangkan untuk memanggil GetState jika Anda ingin mengambil lebih dari satu status tombol.

CToolBarCtrl::LoadImages

Memuat bitmap ke dalam daftar gambar kontrol toolbar.

void LoadImages(
    int iBitmapID,
    HINSTANCE hinst);

Parameter

iBitmapID
ID bitmap yang berisi gambar yang akan dimuat. Untuk menentukan sumber daya bitmap Anda sendiri, atur parameter ini ke ID sumber daya bitmap dan atur hInst ke NULL. Sumber daya bitmap Anda akan ditambahkan ke daftar gambar sebagai satu gambar. Anda dapat menambahkan bitmap standar yang ditentukan sistem dengan mengatur hinst ke HINST_COMMCTRL dan mengatur parameter ini ke salah satu ID berikut:

Bitmap ID Deskripsi
IDB_HIST_LARGE_COLOR Bitmap penjelajah dalam ukuran besar
IDB_HIST_SMALL_COLOR Bitmap penjelajah dalam ukuran kecil
IDB_STD_LARGE_COLOR Bitmap standar dalam ukuran besar
IDB_STD_SMALL_COLOR Bitmap standar dalam ukuran kecil
IDB_VIEW_LARGE_COLOR Lihat bitmap dalam ukuran besar
IDB_VIEW_SMALL_COLOR Lihat bitmap dalam ukuran kecil

hinst
Instans program menangani ke aplikasi panggilan. Parameter ini dapat HINST_COMMCTRL memuat daftar gambar standar.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_LOADIMAGESWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::MapAccelerator

Memetakan karakter akselerator ke tombol bilah alat.

BOOL MapAccelerator(
    TCHAR chAccel,
    UINT* pIDBtn);

Parameter

chAccel
Karakter akselerator yang akan dipetakan. Karakter ini adalah karakter yang sama yang digaris bawahi dalam teks tombol.

pIDBtn
Penunjuk ke UINT yang menerima pengidentifikasi perintah tombol yang sesuai dengan akselerator yang ditentukan dalam chAccel.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_MAPACCELERATORWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::MarkButton

Mengatur status sorotan tombol yang diberikan dalam kontrol toolbar.

BOOL MarkButton(
    int nID,
    BOOL fHighlight = TRUE);

Parameter

nID
Pengidentifikasi tombol.

fHighlight
Menentukan status sorotan yang akan ditetapkan. Secara default, TRUE. Jika diatur ke FALSE, tombol diatur ke status defaultnya.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_MARKBUTTONWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::MoveButton

Memindahkan tombol dari satu indeks ke indeks lainnya.

BOOL MoveButton(
    UINT nOldPos,
    UINT nNewPos);

Parameter

nOldPos
Indeks berbasis nol tombol yang akan dipindahkan.

nNewPos
Indeks berbasis nol tujuan tombol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_MOVEBUTTONWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::PressButton

Menekan atau melepaskan tombol yang ditentukan dalam kontrol toolbar.

BOOL PressButton(int nID, BOOL bPress = TRUE);

Parameter

nID
[di] Pengidentifikasi perintah tombol untuk menekan atau melepaskan.

bPress
[di] TRUE untuk menekan tombol yang ditentukan; FALSE untuk merilis tombol yang ditentukan. Nilai defaultnya adalah TRUE.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak, FALSE.

Keterangan

Jika Anda ingin mengubah lebih dari satu status tombol, pertimbangkan untuk memanggil SetState sebagai gantinya.

Metode ini mengirim TB_PRESSBUTTON pesan, yang dijelaskan dalam Windows SDK.

CToolBarCtrl::ReplaceBitmap

Mengganti bitmap yang ada di kontrol bilah alat saat ini dengan bitmap baru.

BOOL ReplaceBitmap(LPTBREPLACEBITMAP pReplaceBitmap);

Parameter

pReplaceBitmap
[di] Penunjuk ke TBREPLACEBITMAP struktur yang menjelaskan bitmap yang akan diganti dan bitmap baru.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Metode ini mengirim TB_REPLACEBITMAP pesan, yang dijelaskan dalam Windows SDK.

Contoh

Contoh kode berikut mengganti bitmap untuk toolbar standar dengan bitmap yang berbeda.

{
   // Replace one toolbar bitmap with another.
   TBREPLACEBITMAP tbrb;
   tbrb.hInstOld = ::AfxGetInstanceHandle();
   tbrb.nIDOld = IDR_MAINFRAME;
   tbrb.hInstNew = ::AfxGetInstanceHandle();
   tbrb.nIDNew = IDR_MAINFRAME1;
   tbrb.nButtons = 8;
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   BOOL bRet = m_toolBarCtrl.ReplaceBitmap(&tbrb);
}

CToolBarCtrl::RestoreState

Memulihkan status kontrol toolbar dari lokasi di registri yang ditentukan oleh parameter.

void RestoreState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parameter

hKeyRoot
Mengidentifikasi kunci yang saat ini terbuka di registri atau salah satu nilai handel cadangan yang telah ditentukan sebelumnya berikut:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Menunjuk ke NULLstring -terminated yang berisi nama subkunjuk yang nilainya dikaitkan. Parameter ini bisa atau NULL penunjuk ke string kosong. Jika parameter adalah NULL, nilai akan ditambahkan ke kunci yang diidentifikasi oleh hKeyRoot parameter .

lpszValueName
Arahkan ke string yang berisi nama nilai yang akan diambil. Jika nilai dengan nama ini belum ada di kunci, fungsi akan menambahkannya ke kunci.

CToolBarCtrl::SaveState

Menyimpan status kontrol toolbar di lokasi di registri yang ditentukan oleh parameter.

void SaveState(
    HKEY hKeyRoot,
    LPCTSTR lpszSubKey,
    LPCTSTR lpszValueName);

Parameter

hKeyRoot
Mengidentifikasi kunci yang saat ini terbuka di registri atau salah satu nilai handel cadangan yang telah ditentukan sebelumnya berikut:

  • HKEY_CLASSES_ROOT

  • HKEY_CURRENT_USER

  • HKEY_LOCAL_MACHINE

  • HKEY_USERS

lpszSubKey
Menunjuk ke NULLstring -terminated yang berisi nama subkunjuk yang nilainya dikaitkan. Parameter ini bisa atau NULL penunjuk ke string kosong. Jika parameter adalah NULL, nilai akan ditambahkan ke kunci yang diidentifikasi oleh hKeyRoot parameter .

lpszValueName
Menunjuk ke string yang berisi nama nilai yang akan diatur. Jika nilai dengan nama ini belum ada di kunci, fungsi akan menambahkannya ke kunci.

CToolBarCtrl::SetAnchorHighlight

Mengatur pengaturan sorotan jangkar untuk bilah alat.

BOOL SetAnchorHighlight(BOOL fAnchor = TRUE);

Parameter

fAnchor
[di] Menentukan apakah penyorotan jangkar diaktifkan atau dinonaktifkan. Jika nilai ini bukan nol, penyorotan jangkar akan diaktifkan. Jika nilai ini nol, penyorotan jangkar akan dinonaktifkan

Tampilkan Nilai

Pengaturan jangkar sebelumnya. Jika penyorotan diaktifkan, nilai ini bukan nol. Jika penyorotan tidak diaktifkan, nilai ini adalah nol.

Keterangan

Metode ini mengimplementasikan perilaku pesan TB_SETANCHORHIGHLIGHTWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetBitmapSize

Mengatur ukuran gambar bitmapped aktual yang akan ditambahkan ke kontrol toolbar.

BOOL SetBitmapSize(CSize size);

Parameter

size
Lebar dan tinggi, dalam piksel, dari gambar bitmapped.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Fungsi ini harus dipanggil hanya sebelum menambahkan bitmap apa pun ke toolbar. Jika aplikasi tidak secara eksplisit mengatur ukuran bitmap, aplikasi defaultnya menjadi 16 kali 15 piksel.

CToolBarCtrl::SetButtonInfo

Menyetel informasi untuk tombol yang ada di bilah alat.

BOOL SetButtonInfo(
    int nID,
    TBBUTTONINFO* ptbbi);

Parameter

nID
Pengidentifikasi tombol.

ptbbi
Penunjuk ke TBBUTTONINFO struktur yang menerima informasi tombol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Fungsi anggota mengimplementasikan perilaku pesan TB_SETBUTTONINFOWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetButtonSize

Mengatur ukuran tombol dalam kontrol bilah alat.

BOOL SetButtonSize(CSize size);

Parameter

size
Lebar dan tinggi, dalam piksel, dari tombol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Ukuran tombol harus selalu setidaknya sebesar ukuran bitmap yang diapitnya. Fungsi ini harus dipanggil hanya sebelum menambahkan bitmap apa pun ke toolbar. Jika aplikasi tidak secara eksplisit mengatur ukuran tombol, aplikasi secara default menjadi 24 kali 22 piksel.

Contoh

Lihat contoh untuk CToolBar::GetToolBarCtrl.

CToolBarCtrl::SetButtonStructSize

Menentukan ukuran TBBUTTON struktur.

void SetButtonStructSize(int nSize);

Parameter

nSize
Ukuran, dalam byte, dari TBBUTTON struktur.

Keterangan

Jika Anda ingin menyimpan data tambahan dalam TBBUTTON struktur, Anda dapat memperoleh struktur baru dari TBBUTTON, menambahkan anggota yang Anda butuhkan, atau membuat struktur baru yang berisi TBBUTTON struktur sebagai anggota pertamanya. Anda kemudian akan memanggil fungsi ini untuk memberi tahu toolbar mengontrol ukuran struktur baru.

Lihat CToolBarCtrl::AddButtons untuk informasi selengkapnya tentang TBBUTTON struktur.

CToolBarCtrl::SetButtonWidth

Mengatur lebar tombol minimum dan maksimum dalam kontrol bilah alat.

BOOL SetButtonWidth(
    int cxMin,
    int cxMax);

Parameter

cxMin
Lebar tombol minimum, dalam piksel. Tombol bilah alat tidak akan pernah lebih sempit dari nilai ini.

cxMax
Lebar tombol maksimum, dalam piksel. Jika teks tombol terlalu lebar, kontrol akan menampilkannya dengan titik elipsis.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETBUTTONWIDTHWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetCmdID

Mengatur pengidentifikasi perintah yang akan dikirim ke jendela pemilik ketika tombol yang ditentukan ditekan.

BOOL SetCmdID(
    int nIndex,
    UINT nID);

Parameter

nIndex
Indeks berbasis nol tombol yang ID perintahnya akan diatur.

nID
ID perintah untuk mengatur tombol yang dipilih.

Tampilkan Nilai

Mengembalikan bukan nol jika berhasil; jika tidak, nol.

CToolBarCtrl::SetColorScheme

Menyetel skema warna kontrol bilah alat saat ini.

void SetColorScheme(const COLORSCHEME* lpColorScheme);

Parameter

lpColorScheme
[di] Penunjuk COLORSCHEME ke struktur yang menjelaskan warna sorotan dan warna bayangan kontrol toolbar.

Keterangan

Metode ini tidak berpengaruh jika tema visual Windows Vista diatur.

Metode ini mengirim TB_SETCOLORSCHEME pesan, yang dijelaskan dalam Windows SDK.

Contoh

Contoh kode berikut mengatur skema warna untuk kontrol toolbar saat ini. Contoh kode membuat tepi kiri dan atas setiap tombol alat berwarna merah dan tepi kanan dan bawah berwarna biru. Saat pengguna menekan tombol, tepi merah tombol berubah menjadi biru dan tepi birunya berubah menjadi merah.

//Set color scheme for the current toolbar control.
//Make the left and top edges of the tool button red,
//and the right and bottom edges blue. The colors
//reverse when a button is pressed.
//This method has no effect if the Vista visual theme
//is set.
{
   COLORSCHEME cs;
   cs.dwSize = sizeof(COLORSCHEME);
   cs.clrBtnHighlight = RGB(255, 0, 0);
   cs.clrBtnShadow = RGB(0, 0, 255);
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetColorScheme(&cs);
}

CToolBarCtrl::SetDisabledImageList

Mengatur daftar gambar yang akan digunakan kontrol bilah alat untuk menampilkan tombol yang dinonaktifkan.

CImageList* SetDisabledImageList(CImageList* pImageList);

Parameter

pImageList
Penunjuk ke objek yang CImageList berisi gambar yang akan digunakan oleh kontrol toolbar untuk menampilkan gambar tombol yang dinonaktifkan.

Tampilkan Nilai

Penunjuk ke CImageList objek yang sebelumnya digunakan oleh kontrol toolbar untuk menampilkan gambar tombol yang dinonaktifkan.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETDISABLEDIMAGELISTWin32 , seperti yang dijelaskan dalam Windows SDK. Implementasi SetDisabledImageList MFC menggunakan objek yang CImageList berisi gambar tombol yang dinonaktifkan kontrol toolbar, bukan handel ke daftar gambar.

CToolBarCtrl::SetDrawTextFlags

Mengatur bendera dalam fungsi DrawTextWin32 , yang digunakan untuk menggambar teks dalam persegi panjang yang ditentukan, diformat sesuai dengan cara bendera diatur.

DWORD SetDrawTextFlags(
    DWORD dwMask,
    DWORD dwDTFlags);

Parameter

dwMask
Kombinasi satu atau beberapa DT_ bendera, ditentukan dalam fungsi DrawTextWin32 , yang menunjukkan bit mana dwDTFlags yang akan digunakan saat menggambar teks.

dwDTFlags
Kombinasi satu atau beberapa DT_ bendera, ditentukan dalam fungsi DrawTextWin32 , yang menunjukkan bagaimana teks tombol akan digambar. Nilai ini diteruskan ke DrawText saat teks tombol digambar.

Tampilkan Nilai

Yang DWORD berisi bendera gambar teks sebelumnya.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETDRAWTEXTFLAGSWin32 , seperti yang dijelaskan dalam Windows SDK. Fungsi anggota ini mengatur bendera dalam fungsi DrawTextWin32 , yang menggambar teks dalam persegi panjang yang ditentukan, diformat sesuai dengan bagaimana bendera diatur.

CToolBarCtrl::SetExtendedStyle

Mengatur gaya yang diperluas untuk kontrol bilah alat.

DWORD SetExtendedStyle(DWORD dwExStyle);

Parameter

dwExStyle
Nilai yang menentukan gaya baru yang diperluas. Parameter ini bisa menjadi kombinasi gaya toolbar yang diperluas.

Tampilkan Nilai

DWORD yang mewakili gaya yang diperluas sebelumnya. Untuk daftar gaya, lihat Toolbar Extended Styles, di Windows SDK.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETEXTENDEDSTYLEWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetHotImageList

Mengatur daftar gambar yang akan digunakan kontrol toolbar untuk menampilkan tombol "panas".

CImageList* SetHotImageList(CImageList* pImageList);

Parameter

pImageList
Penunjuk ke objek yang CImageList berisi gambar yang akan digunakan oleh kontrol toolbar untuk menampilkan gambar tombol panas.

Tampilkan Nilai

Penunjuk ke CImageList objek yang sebelumnya digunakan oleh kontrol toolbar untuk menampilkan gambar tombol panas.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETHOTIMAGELISTWin32 , seperti yang dijelaskan dalam Windows SDK.

Implementasi SetHotImageList MFC menggunakan objek yang CImageList berisi gambar tombol panas kontrol toolbar, bukan handel ke daftar gambar. Tombol panas muncul disorot saat penunjuk berada di atasnya.

CToolBarCtrl::SetHotItem

Mengatur item panas di bilah alat.

int SetHotItem(int nHot);

Parameter

nHot
Nomor indeks berbasis nol dari item yang akan dibuat panas. Jika nilai ini adalah -1, tidak ada item yang akan panas.

Tampilkan Nilai

Indeks item panas sebelumnya, atau -1 jika tidak ada item panas.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETHOTITEMWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetImageList

Mengatur daftar gambar yang akan digunakan bilah alat untuk menampilkan tombol yang berada dalam status defaultnya.

CImageList* SetImageList(CImageList* pImageList);

Parameter

pImageList
Penunjuk ke objek yang CImageList berisi gambar yang akan digunakan oleh kontrol toolbar untuk menampilkan gambar tombol dalam status defaultnya.

Tampilkan Nilai

Penunjuk ke CImageList objek yang sebelumnya digunakan oleh kontrol toolbar untuk menampilkan gambar tombol dalam status defaultnya.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETIMAGELISTWin32 , seperti yang dijelaskan dalam Windows SDK.

Implementasi SetImageList MFC menggunakan objek yang CImageList berisi gambar tombol kontrol toolbar, bukan handel ke daftar gambar.

CToolBarCtrl::SetIndent

Mengatur indentasi untuk tombol pertama dalam kontrol toolbar.

BOOL SetIndent(int iIndent);

Parameter

iIndent
Nilai yang menentukan indentasi, dalam piksel.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

CToolBarCtrl::SetInsertMark

Menyetel tanda penyisipan saat ini untuk bilah alat.

void SetInsertMark(TBINSERTMARK* ptbim);

Parameter

ptbim
Penunjuk ke TBINSERTMARK struktur yang berisi tanda penyisipan.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETINSERTMARKWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetInsertMarkColor

Mengatur warna yang digunakan untuk menggambar tanda penyisipan untuk bilah alat.

COLORREF SetInsertMarkColor(COLORREF clrNew);

Parameter

clrNew
Nilai COLORREF yang berisi warna tanda penyisipan baru.

Tampilkan Nilai

Nilai COLORREF yang berisi warna tanda penyisipan sebelumnya.

Keterangan

Fungsi anggota ini mengimplementasikan perilaku pesan TB_SETINSERTMARKCOLORWin32 , seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetMaxTextRows

Mengatur jumlah maksimum baris teks yang ditampilkan pada tombol toolbar.

BOOL SetMaxTextRows(int iMaxRows);

Parameter

iMaxRows
Jumlah maksimum baris yang akan diatur.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

CToolBarCtrl::SetMetrics

Mengatur metrik CToolBarCtrl objek.

void SetMetrics(LPTBMETRICS ptbm);

Parameter

ptbm
Penunjuk ke TBMETRICS struktur CToolBarCtrl objek.

Keterangan

Fungsi anggota ini menimulasi fungsionalitas TB_SETMETRICS pesan, seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetOwner

Mengatur jendela pemilik untuk kontrol bilah alat.

void SetOwner(CWnd* pWnd);

Parameter

pWnd
Arahkan ke CWnd objek atau CWnd-turunan yang akan menjadi jendela pemilik baru untuk kontrol toolbar.

Keterangan

Jendela pemilik adalah jendela yang menerima pemberitahuan dari toolbar.

CToolBarCtrl::SetPadding

Mengatur padding horizontal dan vertikal kontrol bilah alat saat ini.

DWORD SetPadding(
    int nHorzPadding,
    int nVertPadding);

Parameter

nHorzPadding
[di] Menentukan padding horizontal kontrol toolbar, dalam piksel.

nVertPadding
[di] Menentukan padding vertikal kontrol toolbar, dalam piksel.

Tampilkan Nilai

Kata DWORD rendahnya berisi nilai padding horizontal sebelumnya, dan kata tingginya berisi nilai padding vertikal sebelumnya. Nilai padding diukur dalam piksel.

Keterangan

Metode ini mengirim TB_SETPADDING pesan, yang dijelaskan dalam Windows SDK.

Contoh

Contoh kode berikut mengatur padding horizontal dan vertikal kontrol toolbar saat ini menjadi 20 piksel.

{
   // Set the horizontal and vertical padding of the current
   // toolbar control.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   m_toolBarCtrl.SetPadding(50, 50);
}

CToolBarCtrl::SetPressedImageList

Mengatur daftar gambar yang digunakan kontrol bilah alat saat ini untuk mewakili tombol dalam status ditekan.

CImagelist* SetPressedImageList(
    int iImageID,
    CImageList* pImageList);

Parameter

iImageID
[di] Indeks berbasis nol dari daftar gambar. Atur parameter ini ke nol jika Anda hanya menggunakan satu daftar gambar.

pImageList
[di] Penunjuk ke yang CImageList berisi daftar gambar baru.

Tampilkan Nilai

Penunjuk CImageList ke yang berisi daftar gambar sebelumnya untuk kontrol saat ini, atau NULL jika tidak ada daftar gambar yang diatur.

Keterangan

Metode ini mengirim TB_SETPRESSEDIMAGELIST pesan, yang dijelaskan dalam Windows SDK.

Contoh

Contoh kode berikut mengatur daftar gambar yang ditekan agar sama dengan daftar gambar default.

{
   // SetPressedImageList
   // Set the pressed image list to be the same as the
   // normal image list.
   CToolBarCtrl &m_toolBarCtrl = m_wndToolBar.GetToolBarCtrl();
   CImageList *pNormalCil = m_toolBarCtrl.GetImageList();
   CImageList *pPressedCil = m_toolBarCtrl.GetPressedImageList();
   m_toolBarCtrl.SetPressedImageList(0, pNormalCil);
}

CToolBarCtrl::SetRows

Meminta kontrol toolbar untuk mengubah ukuran dirinya ke jumlah baris yang diminta.

void SetRows(
    int nRows,
    BOOL bLarger,
    LPRECT lpRect);

Parameter

nRows
Jumlah baris yang diminta.

bLarger
Memberi tahu apakah akan menggunakan lebih banyak baris atau lebih sedikit baris jika toolbar tidak dapat diubah ukurannya menjadi jumlah baris yang diminta.

lpRect
Arahkan ke CRect objek atau RECT struktur yang akan menerima persegi panjang pembatas baru pada toolbar.

Keterangan

Jika toolbar tidak dapat mengubah ukuran dirinya menjadi angka atau baris yang diminta, toolbar akan mengubah ukurannya menjadi ukuran yang lebih besar atau berikutnya yang lebih kecil yang valid, tergantung pada nilai bLarger. Jika bLarger adalah TRUE, jumlah baris baru akan lebih besar dari jumlah yang diminta. Jika bLarger adalah FALSE, jumlah baris baru akan lebih kecil dari jumlah yang diminta.

Sejumlah baris tertentu valid untuk toolbar jika tombol dapat disusun sedemikian rumor sehingga semua baris memiliki jumlah tombol yang sama (kecuali mungkin baris terakhir). Misalnya, toolbar yang berisi empat tombol tidak dapat diukur menjadi tiga baris karena dua baris terakhir harus lebih pendek. Jika Anda mencoba mengukurnya menjadi tiga baris, Anda akan mendapatkan empat baris jika bLarger adalah TRUE dan dua baris jika bLarger adalah FALSE.

Jika ada pemisah di toolbar, aturan saat jumlah baris tertentu valid lebih rumit. Tata letak dihitung sed sehingga grup tombol (tombol dengan pemisah sebelum tombol pertama dan terakhir dalam grup) tidak pernah dipecah pada beberapa baris kecuali grup tidak dapat pas pada satu baris.

Jika grup tidak pas pada satu baris, grup berikutnya akan dimulai pada baris berikutnya meskipun akan pas pada baris tempat grup besar berakhir. Tujuan dari aturan ini adalah untuk membuat pemisahan antara kelompok besar lebih terlihat. Pemisah vertikal yang dihasilkan dihitung sebagai baris.

Perhatikan juga bahwa SetRows fungsi anggota akan selalu memilih tata letak yang menghasilkan ukuran toolbar terkecil. Membuat toolbar dengan TBSTYLE_WRAPABLE gaya lalu mengubah ukuran kontrol hanya akan menerapkan metode yang diuraikan di atas mengingat lebar kontrol.

Fungsi ini hanya dapat dipanggil untuk toolbar yang dibuat dengan TBSTYLE_WRAPABLE gaya .

CToolBarCtrl::SetState

Mengatur status untuk tombol yang ditentukan dalam kontrol bilah alat.

BOOL SetState(
    int nID,
    UINT nState);

Parameter

nID
Pengidentifikasi perintah tombol.

nState
Bendera status. Ini bisa menjadi kombinasi dari nilai yang tercantum untuk status tombol di CToolBarCtrl::AddButtons.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, nol.

Keterangan

Fungsi ini sangat berguna jika Anda ingin mengatur lebih dari salah satu status tombol. Untuk hanya mengatur satu status, gunakan salah satu fungsi anggota berikut: EnableButton, , CheckButton, HideButtonIndeterminate, atau PressButton.

CToolBarCtrl::SetStyle

Mengatur gaya untuk kontrol bilah alat.

void SetStyle(DWORD dwStyle);

Parameter

dwStyle
Yang DWORD berisi kombinasi gaya kontrol toolbar, seperti yang dijelaskan dalam Windows SDK.

CToolBarCtrl::SetToolTips

Mengaitkan kontrol tips alat dengan kontrol toolbar.

void SetToolTips(CToolTipCtrl* pTip);

Parameter

pTip
Penunjuk ke CToolTipCtrl objek.

CToolBarCtrl::SetWindowTheme

Mengatur gaya CToolBarCtrl visual objek.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parameter

pszSubAppName
Penunjuk ke string Unicode yang berisi gaya visual toolbar untuk diatur.

Tampilkan Nilai

Nilai yang dikembalikan tidak digunakan.

Keterangan

Fungsi anggota ini menimulasi fungsionalitas TB_SETWINDOWTHEME pesan, seperti yang dijelaskan dalam Windows SDK.

Lihat juga

Sampel MFC CMNCTRL1
Sampel MFC MFCIE
CWnd Kelas
Bagan Hierarki
CToolBar Kelas