Bagikan melalui


CMFCToolBar Kelas

Kelas ini CMFCToolBar menyerupan CToolBar Kelas, tetapi menyediakan dukungan tambahan untuk fitur antarmuka pengguna. Ini termasuk toolbar datar, toolbar dengan gambar panas, ikon besar, tombol pager, toolbar terkunci, kontrol rebar, teks di bawah gambar, gambar latar belakang, dan toolbar bertab. Kelas ini CMFCToolBar juga berisi dukungan bawaan untuk penyesuaian toolbar dan menu pengguna, seret dan letakkan antara toolbar dan menu, tombol kotak kombo, tombol kotak edit, pemilih warna, dan tombol roll-up.

Untuk detail selengkapnya, lihat kode sumber yang terletak di penginstalan Visual Studio Anda, misalnya, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Sintaks

class CMFCToolBar : public CMFCBaseToolBar

Anggota

Konstruktor Publik

Nama Deskripsi
CMFCToolBar::CMFCToolBar Konstruktor default.
CMFCToolBar::~CMFCToolBar Destruktor.

Metode Publik

Nama Deskripsi
CMFCToolBar::AddBasicCommand Menambahkan perintah menu ke daftar perintah yang selalu ditampilkan saat pengguna membuka menu.
CMFCToolBar::AddCommandUsage Kenaikan satu penghitung yang terkait dengan perintah yang diberikan.
CMFCToolBar::AddToolBarForImageCollection Menambahkan gambar dari sumber daya antarmuka pengguna ke kumpulan gambar dalam aplikasi.
CMFCToolBar::AdjustLayout Menghitung ulang ukuran dan posisi toolbar. (Ambil alih CBasePane::AdjustLayout).
CMFCToolBar::AdjustSize Menghitung ulang ukuran toolbar.
CMFCToolBar::AllowChangeTextLabels Menentukan apakah label teks dapat ditampilkan di bawah gambar pada tombol toolbar.
CMFCToolBar::AreTextLabels Menentukan apakah label teks di bawah gambar saat ini ditampilkan pada tombol toolbar.
CMFCToolBar::AutoGrayInactiveImages Mengaktifkan atau menonaktifkan pembuatan otomatis gambar tombol tidak aktif.
CMFCToolBar::ButtonToIndex Mengembalikan indeks objek Kelas tertentu CMFCToolBarButton di toolbar ini.
CMFCToolBar::CalcFixedLayout Menghitung ukuran horizontal toolbar. (Mengambil alih CBasePane::CalcFixedLayout.)
CMFCToolBar::CalcSize Dipanggil oleh kerangka kerja sebagai bagian dari proses perhitungan tata letak. (Mengambil alih CPane::CalcSize.)
CMFCToolBar::CanHandleSiblings Menentukan apakah toolbar dan saudara kandungnya diposisikan pada panel yang sama.
CMFCToolBar::CleanUpImages Membebaskan sumber daya sistem yang dialokasikan untuk gambar bilah alat.
CMFCToolBar::CleanUpLockedImages Membebaskan sumber daya sistem yang dialokasikan untuk gambar toolbar terkunci.
CMFCToolBar::CanBeClosed Menentukan apakah pengguna dapat menutup bilah alat. (Mengambil alih CBasePane::CanBeClosed.)
CMFCToolBar::CanBeRestored Menentukan apakah sistem dapat memulihkan bilah alat ke status aslinya setelah penyesuaian.
CMFCToolBar::CanFocus Menentukan apakah panel dapat menerima fokus. (Mengambil alih CBasePane::CanFocus.)
CMFCToolBar::CanHandleSiblings Menentukan apakah toolbar dan saudara kandungnya diposisikan pada panel yang sama.
CMFCToolBar::CommandToIndex Mengembalikan indeks tombol di toolbar dengan ID perintah tertentu.
CMFCToolBar::Create CMFCToolBar Membuat objek.
CMFCToolBar::CreateEx CMFCToolBar Membuat objek yang menggunakan opsi gaya tambahan, seperti ikon besar.
CMFCToolBar::Deactivate Menonaktifkan bilah alat.
CMFCToolBar::EnableCustomizeButton Mengaktifkan atau menonaktifkan tombol Tambahkan atau Hapus Tombol yang muncul di akhir toolbar.
CMFCToolBar::EnableDocking Memungkinkan docking panel ke bingkai utama. (Mengambil alih CBasePane::EnableDocking.)
CMFCToolBar::EnableLargeIcons Mengaktifkan atau menonaktifkan ikon besar pada tombol bilah alat.
CMFCToolBar::EnableQuickCustomization Mengaktifkan atau menonaktifkan penyesuaian cepat toolbar sehingga pengguna dapat menekan tombol Alt dan menyeret tombol ke lokasi baru.
CMFCToolBar::EnableReflections Mengaktifkan atau menonaktifkan refleksi perintah.
CMFCToolBar::EnableTextLabels Mengaktifkan atau menonaktifkan label teks di bawah gambar tombol toolbar.
CMFCToolBar::FromHandlePermanent Mengambil penunjuk ke CMFCToolBar objek yang berisi handel jendela yang diberikan.
CMFCToolBar::GetAllButtons Mengembalikan daftar tombol baca-saja di toolbar.
CMFCToolBar::GetAllToolbars Mengembalikan daftar baca-saja dari semua toolbar dalam aplikasi.
CMFCToolBar::GetBasicCommands Mengembalikan daftar baca-saja dari perintah dasar yang ditentukan dalam aplikasi.
CMFCToolBar::GetButton Mengembalikan penunjuk ke CMFCToolBarButton objek yang memiliki indeks tombol toolbar tertentu.
CMFCToolBar::GetButtonInfo Mengembalikan ID perintah, gaya, dan indeks gambar tombol pada indeks tertentu.
CMFCToolBar::GetButtonSize Mengembalikan dimensi setiap tombol pada toolbar.
CMFCToolBar::GetButtonStyle Mengembalikan gaya tombol toolbar saat ini yang terletak di indeks yang ditentukan.
CMFCToolBar::GetButtonText Mengembalikan label teks tombol yang memiliki indeks tertentu.
CMFCToolBar::GetColdImages Mengembalikan penunjuk ke kumpulan gambar tombol toolbar dingin dalam aplikasi.
CMFCToolBar::GetColumnWidth Mengembalikan lebar tombol toolbar.
CMFCToolBar::GetCommandButtons Mengembalikan daftar tombol yang memiliki ID perintah tertentu dari semua toolbar dalam aplikasi.
CMFCToolBar::GetCount Mengembalikan jumlah tombol dan pemisah pada toolbar.
CMFCToolBar::GetCustomizeButton Mengambil penunjuk ke CMFCCustomizeButton objek yang terkait dengan bilah alat.
CMFCToolBar::GetDefaultImage Mengembalikan indeks gambar default untuk tombol toolbar dengan ID perintah tertentu.
CMFCToolBar::GetDisabledImages Mengembalikan penunjuk ke kumpulan gambar yang digunakan untuk tombol toolbar yang dinonaktifkan dalam aplikasi.
CMFCToolBar::GetDisabledMenuImages Mengembalikan penunjuk ke kumpulan gambar yang digunakan untuk tombol menu yang dinonaktifkan dalam aplikasi.
CMFCToolBar::GetDroppedDownMenu Mengambil penunjuk ke objek tombol menu yang saat ini menampilkan sub-menunya.
CMFCToolBar::GetGrayDisabledButtons Menentukan apakah gambar tombol yang dinonaktifkan adalah versi redup dari gambar tombol biasa, atau diambil dari kumpulan gambar tombol yang dinonaktifkan.
CMFCToolBar::GetHighlightedButton Mengembalikan penunjuk ke tombol toolbar yang saat ini disorot.
CMFCToolBar::GetHotBorder Menentukan apakah tombol toolbar dilacak dengan panas.
CMFCToolBar::GetHotTextColor Mengembalikan warna teks dari tombol toolbar yang disorot.
CMFCToolBar::GetHwndLastFocus Mengembalikan handel ke jendela yang memiliki fokus input tepat sebelum toolbar melakukannya.
CMFCToolBar::GetIgnoreSetText Menentukan apakah panggilan untuk mengatur label tombol diabaikan.
CMFCToolBar::GetImageSize Mengembalikan ukuran gambar tombol toolbar saat ini.
CMFCToolBar::GetImages Mengembalikan penunjuk ke kumpulan gambar tombol default dalam aplikasi.
CMFCToolBar::GetImagesOffset Mengembalikan offset indeks yang digunakan untuk menemukan gambar tombol toolbar untuk toolbar ini dalam daftar global gambar tombol toolbar.
CMFCToolBar::GetInvalidateItemRect Mengambil wilayah area klien yang harus digambar ulang untuk tombol pada indeks yang diberikan.
CMFCToolBar::GetItemID Mengembalikan ID perintah tombol toolbar pada indeks tertentu.
CMFCToolBar::GetItemRect Mengembalikan persegi panjang pembatas tombol pada indeks tertentu.
CMFCToolBar::GetLargeColdImages Mengembalikan penunjuk ke kumpulan gambar tombol toolbar dingin besar dalam aplikasi.
CMFCToolBar::GetLargeDisabledImages Mengembalikan penunjuk ke kumpulan gambar tombol toolbar besar yang dinonaktifkan dalam aplikasi.
CMFCToolBar::GetLargeImages Mengembalikan penunjuk ke kumpulan gambar tombol toolbar besar dalam aplikasi.
CMFCToolBar::GetLockedColdImages Mengembalikan penunjuk ke kumpulan gambar dingin terkunci di toolbar.
CMFCToolBar::GetLockedDisabledImages Mengembalikan penunjuk ke kumpulan gambar yang dinonaktifkan terkunci di toolbar.
CMFCToolBar::GetLockedImages Mengembalikan penunjuk ke kumpulan gambar tombol terkunci di toolbar.
CMFCToolBar::GetLockedImageSize Mengembalikan ukuran default gambar toolbar terkunci.
CMFCToolBar::GetLockedMenuImages Mengembalikan penunjuk ke kumpulan gambar menu toolbar terkunci di toolbar.
CMFCToolBar::GetMenuButtonSize Mengembalikan ukuran tombol menu dalam aplikasi.
CMFCToolBar::GetMenuImageSize Mengembalikan ukuran gambar tombol menu dalam aplikasi.
CMFCToolBar::GetMenuImages Mengembalikan penunjuk ke kumpulan gambar tombol menu dalam aplikasi.
CMFCToolBar::GetOrigButtons Mengambil kumpulan tombol bilah alat yang tidak disesuaikan.
CMFCToolBar::GetOrigResetButtons Mengambil kumpulan tombol reset yang tidak disesuaikan dari toolbar.
CMFCToolBar::GetResourceID Mengambil ID sumber daya toolbar.
CMFCToolBar::GetRouteCommandsViaFrame Menentukan objek mana, bingkai induk atau pemilik, mengirim perintah ke toolbar.
CMFCToolBar::GetRowHeight Mengembalikan tinggi tombol toolbar.
CMFCToolBar::GetShowTooltips Menentukan apakah tips alat ditampilkan untuk tombol toolbar.
CMFCToolBar::GetSiblingToolBar Mengambil saudara dari bilah alat.
CMFCToolBar::GetUserImages Mengembalikan penunjuk ke kumpulan gambar tombol toolbar yang ditentukan pengguna dalam aplikasi.
CMFCToolBar::HitTest Mengembalikan indeks tombol toolbar yang terletak pada posisi yang ditentukan.
CMFCToolBar::InsertButton Sisipkan tombol ke bilah alat.
CMFCToolBar::InsertSeparator Sisipkan pemisah ke bilah alat.
CMFCToolBar::InvalidateButton Membatalkan area klien dari tombol toolbar yang ada di indeks yang disediakan.
CMFCToolBar::IsAddRemoveQuickCustomize Menentukan apakah pengguna dapat menambahkan atau menghapus tombol bilah alat dengan menggunakan opsi menu Kustomisasi .
CMFCToolBar::IsAltCustomizeMode Menentukan apakah kustomisasi cepat sedang digunakan untuk menyeret tombol.
CMFCToolBar::IsAutoGrayInactiveImages Menentukan apakah pembuatan otomatis gambar tombol tidak aktif (tidak disorot) diaktifkan.
CMFCToolBar::IsBasicCommand Menentukan apakah perintah ada dalam daftar perintah dasar.
CMFCToolBar::IsButtonExtraSizeAvailable Menentukan apakah bilah alat dapat menampilkan tombol yang memiliki batas yang diperluas.
CMFCToolBar::IsButtonHighlighted Menentukan apakah tombol pada bilah alat disorot.
CMFCToolBar::IsCommandPermitted Menentukan apakah perintah diizinkan.
CMFCToolBar::IsCommandRarelyUsed Menentukan apakah perintah jarang digunakan (lihat CMFCToolBar::SetCommandUsageOptions).
CMFCToolBar::IsCustomizeMode Menentukan apakah kerangka kerja toolbar berada dalam mode kustomisasi.
CMFCToolBar::IsDragButton Menentukan apakah tombol toolbar sedang diseret.
CMFCToolBar::IsExistCustomizeButton Menentukan apakah bilah alat berisi tombol Kustomisasi .
CMFCToolBar::IsFloating Menentukan apakah bilah alat mengambang.
CMFCToolBar::IsLargeIcons Menentukan apakah bilah alat dalam aplikasi saat ini menampilkan ikon besar.
CMFCToolBar::IsLastCommandFromButton Menentukan apakah perintah yang terakhir dijalankan dikirim dari tombol toolbar yang ditentukan.
CMFCToolBar::IsLocked Menentukan apakah bilah alat terkunci.
CMFCToolBar::IsOneRowWithSibling Menentukan apakah toolbar dan toolbar saudaranya diposisikan pada baris yang sama.
CMFCToolBar::IsUserDefined Menentukan apakah bilah alat ditentukan pengguna.
CMFCToolBar::LoadBitmap Memuat gambar toolbar dari sumber daya aplikasi.
CMFCToolBar::LoadBitmapEx Memuat gambar toolbar dari sumber daya aplikasi. Termasuk gambar besar.
CMFCToolBar::LoadParameters Memuat opsi toolbar global dari registri Windows.
CMFCToolBar::LoadState Memuat informasi status bilah alat dari registri Windows. (Mengambil alih CPane::LoadState.)
CMFCToolBar::LoadToolBar Memuat toolbar dari sumber daya aplikasi.
CMFCToolBar::LoadToolBarEx Memuat toolbar dari sumber daya aplikasi dengan menggunakan kelas pembantu CMFCToolBarInfo untuk memungkinkan aplikasi menggunakan gambar besar.
CMFCToolBar::OnChangeHot Dipanggil oleh kerangka kerja saat pengguna memilih tombol pada toolbar.
CMFCToolBar::OnFillBackground Dipanggil oleh kerangka kerja dari CBasePane::DoPaint untuk mengisi latar belakang toolbar.
CMFCToolBar::OnReset Memulihkan bilah alat ke status aslinya.
CMFCToolBar::OnSetAccData (Mengambil alih CBasePane::OnSetAccData.)
CMFCToolBar::OnSetDefaultButtonText Memulihkan teks tombol bilah alat ke status defaultnya.
CMFCToolBar::OnUpdateCmdUI Digunakan secara internal.
CMFCToolBar::RemoveAllButtons Menghapus semua tombol dari bilah alat.
CMFCToolBar::RemoveButton Menghapus tombol dengan indeks yang ditentukan dari bilah alat.
CMFCToolBar::RemoveStateFromRegistry Menghapus informasi status untuk bilah alat dari registri Windows.
CMFCToolBar::ReplaceButton Mengganti tombol bilah alat dengan tombol bilah alat lain.
CMFCToolBar::ResetAll Memulihkan semua bilah alat ke status aslinya.
CMFCToolBar::ResetAllImages Menghapus semua koleksi gambar toolbar dalam aplikasi.
CMFCToolBar::RestoreOriginalState Memulihkan status asli bilah alat.
CMFCToolBar::SaveState Menyimpan informasi status untuk bilah alat di registri Windows. (Mengambil alih CPane::SaveState.)
CMFCToolBar::Serialize (Mengambil alih CBasePane::Serialize.)
CMFCToolBar::SetBasicCommands Mengatur daftar perintah yang selalu ditampilkan saat pengguna membuka menu.
CMFCToolBar::SetButtonInfo Mengatur ID perintah, gaya, dan ID gambar tombol toolbar.
CMFCToolBar::SetButtonStyle Mengatur gaya tombol toolbar pada indeks yang diberikan.
CMFCToolBar::SetButtonText Mengatur label teks tombol toolbar.
CMFCToolBar::SetButtons Mengatur tombol untuk bilah alat.
CMFCToolBar::SetCommandUsageOptions Menentukan kapan perintah yang jarang digunakan tidak muncul di menu aplikasi.
CMFCToolBar::SetCustomizeMode Mengaktifkan atau menonaktifkan mode kustomisasi untuk semua toolbar dalam aplikasi.
CMFCToolBar::SetGrayDisabledButtons Menentukan apakah tombol yang dinonaktifkan pada toolbar diredupkan atau jika gambar yang dinonaktifkan digunakan untuk tombol yang dinonaktifkan.
CMFCToolBar::SetHeight Mengatur tinggi bilah alat.
CMFCToolBar::SetHotBorder Menentukan apakah tombol bilah alat dilacak dengan panas.
CMFCToolBar::SetHotTextColor Mengatur warna teks untuk tombol bilah alat panas.
CMFCToolBar::SetLargeIcons Menentukan apakah tombol bilah alat menampilkan ikon besar.
CMFCToolBar::SetLockedSizes Mengatur ukuran tombol terkunci dan gambar terkunci pada toolbar.
CMFCToolBar::SetMenuSizes Mengatur ukuran tombol menu toolbar dan gambarnya.
CMFCToolBar::SetNonPermittedCommands Mengatur daftar perintah yang tidak dapat dijalankan oleh pengguna.
CMFCToolBar::SetOneRowWithSibling Memposisikan toolbar dan saudara kandungnya pada baris yang sama.
CMFCToolBar::SetPermament Menentukan apakah pengguna dapat menutup bilah alat.
CMFCToolBar::SetRouteCommandsViaFrame Menentukan apakah bingkai induk atau pemilik mengirim perintah ke bilah alat.
CMFCToolBar::SetShowTooltips Menentukan apakah kerangka kerja menampilkan tips alat.
CMFCToolBar::SetSiblingToolBar Menentukan saudara dari bilah alat.
CMFCToolBar::SetSizes Menentukan ukuran tombol dan gambar pada semua bilah alat.
CMFCToolBar::SetToolBarBtnText Menentukan properti tombol pada bilah alat.
CMFCToolBar::SetTwoRowsWithSibling Memposisikan toolbar dan saudara kandungnya pada baris terpisah.
CMFCToolBar::SetUserImages Mengatur kumpulan gambar yang ditentukan pengguna dalam aplikasi.
CMFCToolBar::StretchPane Membentangkan toolbar secara vertikal atau horizontal. (Mengambil alih CBasePane::StretchPane.)
CMFCToolBar::TranslateChar Menjalankan perintah tombol jika kode kunci yang ditentukan sesuai dengan pintasan keyboard yang valid.
CMFCToolBar::UpdateButton Memperbarui status tombol yang ditentukan.
CMFCToolBar::WrapToolBar Memposisikan ulang tombol toolbar dalam dimensi tertentu.

Metode yang Dilindungi

Nama Deskripsi
CMFCToolBar::AllowShowOnList Menentukan apakah toolbar ditampilkan dalam daftar pada panel Bilah Alat dari kotak dialog Kustomisasi .
CMFCToolBar::CalcMaxButtonHeight Menghitung tinggi maksimum tombol di toolbar.
CMFCToolBar::DoPaint Mengecat ulang bilah alat.
CMFCToolBar::DrawButton Mengecat ulang tombol toolbar.
CMFCToolBar::DrawSeparator Mengecat ulang pemisah pada toolbar.
CMFCToolBar::OnUserToolTip Dipanggil oleh kerangka kerja ketika tipsalat untuk tombol akan ditampilkan.

Anggota Data

Nama Deskripsi
CMFCToolBar::m_bDontScaleImages Menentukan apakah akan menskalakan atau tidak gambar toolbar dalam mode DPI tinggi.
CMFCToolBar::m_dblLargeImageRatio Menentukan rasio antara dimensi (tinggi atau lebar) gambar besar dan dimensi gambar reguler.

Keterangan

Untuk menggabungkan CMFCToolBar objek ke dalam aplikasi Anda, ikuti langkah-langkah berikut:

  1. CMFCToolBar Tambahkan objek ke jendela bingkai utama.

  2. Saat Anda memproses pesan WM_CREATE untuk jendela bingkai utama, panggil atau CMFCToolBar::Create CMFCToolBar::CreateEx untuk membuat toolbar dan tentukan gayanya.

  3. Panggil CBasePane::EnableDocking untuk menentukan gaya docking.

Untuk menyisipkan tombol khusus, seperti kotak kombo atau toolbar drop-down, pesan tombol dummy di sumber daya induk, dan ganti tombol dummy saat runtime dengan menggunakan CMFCToolBar::ReplaceButton. Untuk informasi selengkapnya, lihat Panduan: Menempatkan Kontrol Pada Toolbar.

CMFCToolBaradalah kelas dasar untuk kelas Pustaka MFC Kelas,CMFCPopupMenuBar Kelas, dan CMFCDropDownToolBar Kelas.CMFCMenuBar

Contoh

Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCToolBar kelas . Contoh menunjukkan cara mengatur teks label jendela bilah alat, mengatur batas, mengatur gaya panel, dan mengaktifkan tombol Tambahkan atau Hapus Tombol yang muncul di akhir toolbar. Cuplikan kode ini adalah bagian dari sampel Demo IE.

CMFCToolBar m_wndToolBar;
m_wndToolBar.SetWindowText(_T("Standard"));
m_wndToolBar.SetBorders();

//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() &
                          ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

m_wndToolBar.EnableCustomizeButton(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));

Persyaratan

Header: afxtoolbar.h

Hierarki Warisan

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCToolBar::AddBasicCommand

Menambahkan perintah menu ke daftar perintah yang selalu ditampilkan saat pengguna membuka menu.

static void __stdcall AddBasicCommand(UINT uiCmd);

Parameter

uiCmd
[di] Menentukan perintah yang akan ditambahkan.

Keterangan

Perintah dasar selalu ditampilkan saat menu dibuka. Metode ini bermakna ketika pengguna memilih untuk melihat perintah yang baru digunakan.

CMFCToolBar::SetBasicCommands Gunakan metode untuk mengatur daftar perintah yang selalu ditampilkan saat pengguna membuka menu. CMFCToolBar::GetBasicCommands Gunakan metode untuk mengambil daftar perintah dasar yang digunakan oleh aplikasi Anda.

CMFCToolBar::AddCommandUsage

Kenaikan satu penghitung yang terkait dengan perintah yang diberikan.

static void __stdcall AddCommandUsage(UINT uiCommand);

Parameter

uiCommand
[di] Menentukan penghitung perintah untuk kenaikan.

Keterangan

Kerangka kerja memanggil metode ini ketika pengguna memilih item menu.

Kerangka kerja menggunakan penghitung perintah untuk menampilkan item menu yang baru digunakan.

Metode ini menaikkan penghitung perintah dengan menggunakan CMFCCmdUsageCount::AddCmd metode .

CMFCToolBar::AddToolBarForImageCollection

Menambahkan gambar dari sumber daya antarmuka pengguna ke kumpulan gambar dalam aplikasi.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parameter

uiResID
[di] ID sumber daya toolbar dengan gambar yang akan dimuat.

uiBmpResID
[di] ID sumber daya bitmap dengan gambar toolbar.

uiColdResID
[di] ID sumber daya bitmap dengan gambar toolbar "dingin".

uiMenuResID
[di] ID sumber daya bitmap dengan gambar menu.

uiDisabledResID
[di] ID sumber daya bitmap dengan gambar toolbar yang dinonaktifkan.

uiMenuDisabledResID
[di] ID sumber daya bitmap dengan gambar menu yang dinonaktifkan.

Tampilkan Nilai

TRUE jika metode berhasil; FALSE jika uiResID atau uiBmpResID tidak menentukan sumber daya yang valid, atau terjadi kesalahan lain.

Keterangan

Panggil metode ini untuk memuat bitmap dengan gambar toolbar dan menambahkannya ke kumpulan gambar toolbar. Metode ini membuat objek toolbar sementara dan panggilan CMFCToolBar::LoadToolBar.

CMFCToolBar::AdjustLayout

Menghitung ulang ukuran dan posisi toolbar.

virtual void AdjustLayout();

Keterangan

Panggil metode ini ketika toolbar telah dibuat untuk menghitung ulang ukuran dan posisinya.

Kerangka kerja memanggil metode ini setiap kali tata letak toolbar harus diubah. Misalnya, tata letak harus berubah ketika pengguna memindahkan bilah kontrol lain, mengubah ukuran jendela aplikasi, atau menyesuaikan toolbar.

Ambil alih metode ini untuk menyediakan tata letak dinamis Anda sendiri di kelas yang Anda dapatkan dari CMFCToolbar.

CMFCToolBar::AdjustSize

Menghitung ulang ukuran toolbar.

void AdjustSize();

Keterangan

Metode ini memastikan bahwa toolbar pas di batas bingkai induk. Metode ini tidak melakukan apa pun jika toolbar tidak memiliki bingkai induk.

Metode CMFCToolBar::AdjustLayout memanggil metode ini untuk menghitung ulang ukuran jika induk toolbar bukan objek CMFCReBar .

CMFCToolBar::AllowChangeTextLabels

Menentukan apakah label teks dapat ditampilkan di bawah gambar pada tombol toolbar.

virtual BOOL AllowChangeTextLabels() const;

Tampilkan Nilai

TRUE jika diizinkan untuk menampilkan label teks di bawah gambar; jika tidak FALSE.

Keterangan

Metode ini dipanggil oleh kotak dialog kustomisasi untuk menentukan apakah akan mengaktifkan kotak centang Perlihatkan label teks pada halaman Toolbar untuk toolbar yang dipilih.

Implementasi default mengembalikan TRUE.

Ambil alih metode ini dalam objek yang berasal dari CMFCToolBar dan kembali FALSE ketika Anda tidak ingin pengguna memutuskan apakah label teks ditampilkan pada tombol toolbar di bawah gambar.

CMFCToolBar::AllowShowOnList

Menentukan apakah toolbar ditampilkan dalam daftar bilah alat pada panel Bilah Alat dari kotak dialog Kustomisasi .

virtual BOOL AllowShowOnList() const;

Tampilkan Nilai

TRUE jika objek toolbar dapat ditampilkan dalam kotak daftar pada halaman kustomisasi toolbar; jika tidak FALSE.

Keterangan

Metode ini dipanggil oleh kerangka kerja untuk menentukan apakah daftar pada halaman kustomisasi toolbar harus menyertakan objek tertentu yang berasal dari CMFCToolBar.

Implementasi default selalu mengembalikan TRUE. Ambil alih metode ini ketika Anda tidak ingin bilah alat muncul di daftar bilah alat dalam kotak dialog kustomisasi.

CMFCToolBar::AreTextLabels

Menentukan apakah label teks di bawah gambar saat ini ditampilkan pada tombol toolbar.

BOOL AreTextLabels() const;

Tampilkan Nilai

TRUE jika tombol toolbar menampilkan label teks di bawah gambar; jika tidak FALSE.

Keterangan

Gunakan CMFCToolBar::EnableTextLabels untuk menentukan apakah teks ditampilkan. Nilai defaultnya adalah FALSE. Panggil CMFCToolBar::AllowChangeTextLabels untuk menentukan apakah pengguna dapat mengubah pengaturan ini dalam kotak dialog kustomisasi.

CMFCToolBar::AutoGrayInactiveImages

Mengaktifkan atau menonaktifkan pembuatan otomatis gambar tombol tidak aktif.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

Parameter

bEnable
[di] Nilai Boolean yang menentukan apakah akan meringankan gambar yang tidak aktif. Jika parameter ini adalah TRUE, gambar yang tidak aktif diredupkan. Jika tidak, gambar yang tidak aktif tidak redup.

nGrayImagePercentage
[di] Menentukan persentase luminance untuk gambar yang tidak aktif. Jika bEnable adalah FALSE, nilai ini diabaikan.

bRedrawAllToolbars
[di] Nilai Boolean yang menentukan apakah akan menggambar ulang semua toolbar dalam aplikasi. Jika parameter ini adalah TRUE, metode ini menguras ulang semua toolbar.

Keterangan

Jika bEnable adalah TRUE, kerangka kerja menggunakan nGrayImagePercentage untuk menghasilkan gambar yang tidak aktif dari gambar reguler. Jika tidak, Anda harus menyediakan sekumpulan gambar yang tidak aktif dengan menggunakan metode .CMFCToolBar::GetColdImages Secara default, opsi ini dinonaktifkan.

Untuk informasi selengkapnya tentang nGrayImagePercentage parameter , lihat CMFCToolBarImages::GrayImages.

CMFCToolBar::ButtonToIndex

Mengembalikan indeks objek Kelas tertentu CMFCToolBarButton di toolbar ini.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Parameter

pButton
[di] Penunjuk ke objek tombol toolbar.

Tampilkan Nilai

pButton Indeks dalam daftar internal tombol toolbar; atau -1 jika tombol yang ditentukan tidak ada di toolbar ini.

CMFCToolBar::CalcFixedLayout

Menghitung ukuran horizontal toolbar.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parameter

bStretch
[di] TRUE untuk meregangkan toolbar ke ukuran bingkai induk.

bHorz
[di] TRUE untuk mengorientasi toolbar secara horizontal; FALSE untuk mengorientasi toolbar secara vertikal.

Tampilkan Nilai

Objek CSize yang menentukan ukuran bilah alat.

Keterangan

Metode ini menghitung ukuran toolbar dengan menggunakan CMFCToolBar::CalcLayout metode . Ini meneruskan LM_STRETCH bendera untuk dwMode parameter jika bStretch adalah TRUE. Ini melewati LM_HORZ bendera jika bHorz adalah TRUE.

Lihat sampel VisualStudioDemo untuk contoh yang menggunakan metode ini.

CMFCToolBar::CalcMaxButtonHeight

Menghitung tinggi maksimum tombol di toolbar.

virtual int CalcMaxButtonHeight();

Tampilkan Nilai

Tinggi maksimum tombol.

Keterangan

Metode ini menghitung tinggi maksimum di antara semua tombol toolbar pada toolbar. Tinggi dapat bervariasi tergantung pada faktor-faktor seperti status docking toolbar saat ini.

Ambil alih metode ini dalam kelas yang berasal dari CMFCToolBar untuk memberikan perhitungan tinggi Anda sendiri.

CMFCToolBar::CalcSize

Dipanggil oleh kerangka kerja sebagai bagian dari proses perhitungan tata letak.

virtual CSize CalcSize(BOOL bVertDock);

Parameter

bVertDock
[di] TRUE untuk menentukan bahwa toolbar ditampung secara vertikal; FALSE untuk menentukan bahwa toolbar ditampung secara horizontal.

Tampilkan Nilai

Objek CSize yang menentukan ukuran keseluruhan tombol pada toolbar.

Keterangan

Metode ini mempertimbangkan atribut yang memengaruhi ukuran setiap tombol, seperti area label teks dan ukuran batas.

Jika toolbar tidak berisi tombol, metode ini mengembalikan ukuran yang dipesan dari satu tombol dengan menggunakan CMFCToolBar::GetButtonSize metode .

CMFCToolBar::CanBeClosed

Menentukan apakah pengguna dapat menutup bilah alat.

virtual BOOL CanBeClosed() const;

Tampilkan Nilai

TRUE jika toolbar dapat ditutup oleh pengguna; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan apakah pengguna dapat menutup toolbar. Jika metode mengembalikan TRUE, kerangka kerja mengaktifkan SC_CLOSE perintah di menu sistem toolbar dan pengguna dapat menutup toolbar dengan menggunakan kotak centang dalam daftar toolbar dalam kotak dialog kustomisasi.

Implementasi default mengembalikan TRUE. Ambil alih metode ini di kelas yang berasal dari CMFCToolBar untuk membuat objek toolbar yang tidak dapat ditutup oleh pengguna.

CMFCToolBar::CanBeRestored

Menentukan apakah sistem dapat memulihkan bilah alat ke status aslinya setelah penyesuaian.

virtual BOOL CanBeRestored() const;

Tampilkan Nilai

TRUE jika toolbar dapat dipulihkan dari sumber daya aplikasi; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini untuk menentukan apakah toolbar dapat dikembalikan ke status aslinya setelah penyesuaian. Status asli dimuat dari sumber daya aplikasi.

Jika CanBeRestored mengembalikan TRUE, halaman Toolbar dari kotak dialog kustomisasi mengaktifkan tombol Reset untuk toolbar yang dipilih.

Implementasi default mengembalikan TRUE jika ID sumber daya asli toolbar saat dimuat bukan nol. Biasanya, hanya bilah alat yang ditentukan pengguna yang tidak dapat dipulihkan.

Anda dapat mengambil CanBeRestored alih metode untuk menyesuaikan perilaku ini di kelas turunan.

CMFCToolBar::CanFocus

Menentukan apakah panel dapat menerima fokus.

virtual BOOL CanFocus() const;

Tampilkan Nilai

Metode ini mengembalikan FALSE.

Keterangan

Metode ini mengambil alih implementasi kelas dasar, CBasePane::CanFocus, karena objek toolbar tidak dapat menerima fokus.

CMFCToolBar::CanHandleSiblings

Menentukan apakah toolbar dan saudara kandungnya diposisikan pada panel yang sama.

BOOL CanHandleSiblings();

Tampilkan Nilai

TRUE jika toolbar memiliki saudara kandung dan toolbar dan saudara kandungnya diposisikan di panel yang sama; jika tidak FALSE.

Keterangan

Metode internal CMFCCustomizeButton::CreatePopupMenu memanggil metode ini untuk menentukan cara menampilkan menu pop-up Kustomisasi . Jika metode ini mengembalikan TRUE, kerangka kerja menampilkan tombol Perlihatkan Tombol pada Satu Baris atau Perlihatkan Tombol pada tombol Dua Baris .

Anda biasanya tidak perlu menggunakan metode ini. Untuk mengaktifkan tombol Kustomisasi yang muncul pada toolbar, panggil CMFCToolBar::EnableCustomizeButton metode . Untuk mengaktifkan Tombol Perlihatkan pada Satu Baris atau Perlihatkan Tombol pada tombol Dua Baris , panggil CMFCToolBar::SetSiblingToolBar.

CMFCToolBar::CleanUpImages

Membebaskan sumber daya sistem yang dialokasikan untuk gambar bilah alat.

static void CMFCToolBar::CleanUpImages();

Keterangan

Kerangka kerja memanggil metode ini ketika aplikasi dimatikan.

CMFCToolBar::CleanUpLockedImages

Membebaskan sumber daya sistem yang dialokasikan untuk gambar toolbar terkunci.

void CleanUpLockedImages();

Keterangan

Panggil metode ini saat gaya visual aplikasi Anda berubah. Lihat sampel VisualStudioDemo untuk contoh yang menggunakan metode ini.

CMFCToolBar::CommandToIndex

Mengembalikan indeks tombol di toolbar dengan ID perintah tertentu.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

Parameter

nIDFind
[di] Menentukan ID perintah.

iIndexFirst
[di] Menentukan indeks awal untuk memulai.

Tampilkan Nilai

Indeks berbasis nol tombol toolbar jika metode berhasil; -1 jika tidak ada tombol dengan ID yang ditentukan.

Keterangan

Objek CMFCToolBar mempertahankan daftar internal tombol pada toolbar. Panggil fungsi ini untuk mengambil indeks tombol dalam daftar yang diberikan ID perintah tombol.

Jika iIndex lebih besar dari 0, metode ini mengabaikan tombol apa pun pada toolbar yang memiliki indeks kurang dari iIndex.

CMFCToolBar::Create

CMFCToolBar Membuat objek.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

Parameter

pParentWnd
[di] Penunjuk ke jendela induk toolbar.

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

nID
[di] ID jendela anak dari bilah alat.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak FALSE.

Keterangan

Metode ini membuat bilah kontrol dan melampirkannya ke toolbar. Ini membuat bilah kontrol dengan gaya TBSTYLE_FLAT. Panggil CMFCToolBar::CreateEx jika Anda menginginkan gaya bilah kontrol yang berbeda.

CMFCToolBar::CreateEx

CMFCToolBar Membuat objek yang menggunakan opsi gaya tambahan, seperti ikon besar.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

Parameter

pParentWnd
[di] Penunjuk ke jendela induk toolbar.

dwCtrlStyle
[di] Gaya tambahan untuk membuat objek bilah kontrol yang disematkan.

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

rcBorders
[di] Objek CRect yang menentukan lebar batas jendela toolbar.

nID
[di] ID jendela anak dari bilah alat.

Tampilkan Nilai

Bukan nol jika metode ini berhasil; jika tidak, 0.

Keterangan

Metode ini membuat bilah kontrol dan melampirkannya ke toolbar.

Panggil metode ini alih-alih CMFCToolBar::Create ketika Anda ingin memberikan gaya tertentu. Misalnya, atur dwCtrlStyle ke TBSTYLE_FLAT | TBSTYLE_TRANSPARENT untuk membuat bilah alat yang menyerupai bilah alat yang digunakan oleh Internet Explorer 4.

Contoh

Contoh berikut menunjukkan cara menggunakan CreateEx metode CMFCToolBar kelas. Cuplikan kode ini adalah bagian dari sampel Demo IE.

CMFCToolBar m_wndToolBar;
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

CMFCToolBar::Deactivate

Menonaktifkan bilah alat.

virtual void Deactivate();

Keterangan

Metode ini menonaktifkan toolbar dengan menghapus fokus dari tombol toolbar yang disorot. Kerangka kerja memanggil metode ini ketika toolbar kehilangan fokus atau dihancurkan.

CMFCToolBar::DoPaint

Mengecat ulang bilah alat.

virtual void DoPaint(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Keterangan

Metode ini dipanggil oleh kerangka kerja ketika bagian toolbar harus dicat ulang.

Ambil alih metode ini untuk menyesuaikan tampilan objek yang berasal dari CMFCToolBar.

CMFCToolBar::DrawButton

Mengecat ulang tombol toolbar.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

pButton
[di] Penunjuk ke tombol untuk menggambar.

pImages
[di] Penunjuk ke gambar toolbar.

bHighlighted
[di] TRUE jika tombol disorot; jika tidak FALSE.

bDrawDisabledImages
[di] TRUE jika tombol yang dinonaktifkan diredupkan; jika tidak FALSE.

Tampilkan Nilai

TRUE jika tombol dicat ulang; FALSE jika tombol disembunyikan.

Keterangan

Metode CMFCToolBar::DrawButton memanggil metode ini ketika tombol toolbar harus dicat ulang.

Ambil alih metode ini jika Anda ingin menyesuaikan tampilan tombol pada toolbar Anda.

CMFCToolBar::DrawSeparator

Mengecat ulang pemisah pada toolbar.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

rect
[di] Persegi panjang pembatas lokasi tempat pemisah digambar, dalam piksel.

bHorz
[di] TRUE jika pemisah horizontal, FALSE jika pemisah vertikal.

Keterangan

CMFCToolBar::DoPaint memanggil metode ini untuk setiap CMFCToolBar::DrawSeparator objek yang memiliki TBBS_SEPARATOR gaya, alih-alih memanggil CMFCToolBar::DrawButton tombol tersebut.

Ambil alih metode ini dalam kelas yang berasal dari CMFCToolBar untuk menyesuaikan tampilan pemisah pada toolbar. Implementasi default memanggil CMFCVisualManager::OnDrawSeparator untuk menggambar pemisah yang penampilannya ditentukan oleh manajer visual saat ini.

CMFCToolBar::EnableCustomizeButton

Mengaktifkan atau menonaktifkan tombol Kustomisasi yang muncul pada bilah alat.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

Parameter

bEnable
[di] Mengaktifkan atau menonaktifkan tombol Kustomisasi.

iCustomizeCmd
[di] ID perintah tombol Kustomisasi.

strCustomizeText
[di] Label teks tombol Kustomisasi.

uiCustomizeTextResId
[di] ID string sumber daya dari label tombol Kustomisasi.

bQuickCustomize
[di] Mengaktifkan atau menonaktifkan opsi Tambahkan atau Hapus Tombol pada menu yang turun dari tombol.

Keterangan

Jika iCustomizeCmd -1, kerangka kerja menampilkan tombol Kustomisasi ketika beberapa tombol toolbar tidak pas di area toolbar. Tombol menampilkan panah dua arah kiri, atau chevron, yang menunjukkan bahwa ada lebih banyak tombol.

Jika iCustomizeCmd menentukan ID perintah yang valid, dan bEnable adalah TRUE, tombol Kustomisasi selalu ditampilkan. Tombol memiliki panah bawah kecil dan membuka menu yang berisi perintah. Perintah ini menggunakan label teks yang ditentukan oleh strCustomizeText. Jika bQuickCustomize juga TRUE, menu menampilkan opsi Tambahkan atau Hapus Tombol .

Kerangka kerja secara dinamis ditambahkan ke menu tombol apa pun yang tidak pas di area toolbar sebelum item yang ditentukan oleh iCustomizeCmd. Chevron ditampilkan di samping panah bawah.

CMFCToolBar::EnableDocking

Memungkinkan docking panel ke bingkai utama.

virtual void EnableDocking(DWORD dwAlignment);

Parameter

dwAlignment
[di] Menentukan perataan docking untuk diaktifkan.

Keterangan

Metode ini memperluas implementasi kelas dasar, CBasePane::EnableDocking, dengan mengatur CBasePane::m_dwControlBarStyle anggota data ke AFX_CBRS_FLOAT. Metode ini kemudian diteruskan dwAlignment ke implementasi kelas dasar.

CMFCToolBar::EnableLargeIcons

Mengaktifkan atau menonaktifkan ikon besar pada tombol bilah alat.

void EnableLargeIcons(BOOL bEnable);

Parameter

bEnable
[di] TRUE untuk mengaktifkan ikon besar, FALSE untuk menonaktifkan ikon besar.

Keterangan

Secara default, ikon besar diaktifkan.

CMFCToolBar::EnableQuickCustomization

Mengaktifkan atau menonaktifkan penyesuaian cepat toolbar sehingga pengguna dapat menekan tombol Alt dan menyeret tombol ke lokasi baru.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan kustomisasi cepat, FALSE untuk menonaktifkan kustomisasi cepat.

CMFCToolBar::EnableReflections

Mengaktifkan atau menonaktifkan refleksi perintah.

void EnableReflections(BOOL bEnable = TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan refleksi perintah; FALSE untuk menonaktifkan refleksi perintah.

Keterangan

Panggil metode ini untuk mengaktifkan pantulan perintah untuk tombol toolbar yang berisi kontrol tersemat, seperti kotak kombo.

Untuk informasi selengkapnya tentang refleksi perintah, lihat TN062: Refleksi Pesan untuk Kontrol Windows.

CMFCToolBar::EnableTextLabels

Mengaktifkan atau menonaktifkan label teks di bawah gambar tombol toolbar.

void EnableTextLabels(BOOL bEnable=TRUE);

Parameter

bEnable
TRUE jika label teks muncul di bawah gambar tombol toolbar; jika tidak FALSE.

Keterangan

Jika label teks diaktifkan, semua tombol pada toolbar diperbesar untuk menyediakan ruang bagi label yang akan ditampilkan di bawah gambar. Kotak dialog kustomisasi memiliki kotak centang Perlihatkan label teks di halaman Toolbar . Saat pengguna memilih toolbar dan memeriksa opsi ini, kerangka kerja memanggil EnableTextLabels toolbar yang dipilih. Anda dapat menonaktifkan kotak centang untuk objek yang berasal dari CMFCToolBar dengan mengembalikan FALSE dari CMFCToolBar::AllowChangeTextLabels .

CMFCToolBar::FromHandlePermanent

Mengambil penunjuk ke CMFCToolBar objek yang berisi handel jendela yang diberikan.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Parameter

hwnd
[di] Handel jendela untuk dicari.

Tampilkan Nilai

Penunjuk ke CMFCToolBar objek yang berisi handel jendela yang diberikan, atau NULL jika tidak ada objek yang CMFCToolBar sesuai.

Keterangan

Metode bersama ini memeriksa setiap toolbar dalam aplikasi untuk CMFCToolBar objek yang berisi handel jendela yang diberikan.

CMFCToolBar::GetAllButtons

Mengembalikan daftar tombol baca-saja di toolbar.

const CObList& GetAllButtons() const;

Tampilkan Nilai

Referensi konstan ke CObList objek Kelas , yang berisi kumpulan CMFCToolBarButton objek Kelas .

CMFCToolBar::GetAllToolbars

Mengembalikan daftar baca-saja dari semua toolbar dalam aplikasi.

static const CObList& GetAllToolbars();

Tampilkan Nilai

Referensi const ke CObList objek Kelas yang berisi kumpulan CMFCToolBar objek.

CMFCToolBar::GetBasicCommands

Mengembalikan daftar baca-saja dari perintah dasar yang ditentukan dalam aplikasi.

static const CList<UINT,UINT>& GetBasicCommands();

Tampilkan Nilai

Referensi const ke CList objek Kelas yang berisi kumpulan perintah dasar.

Keterangan

Tambahkan perintah dasar dengan memanggil CMFCToolBar::AddBasicCommand atau CMFCToolBar::SetBasicCommands.

CMFCToolBar::GetButton

Mengembalikan penunjuk ke CMFCToolBarButton objek Kelas pada indeks tertentu.

CMFCToolBarButton* GetButton(int iIndex) const;

Parameter

iIndex
[di] Menentukan indeks tombol yang akan dikembalikan.

Tampilkan Nilai

Penunjuk ke tombol toolbar jika ada; atau NULL jika tidak ada tombol seperti itu.

CMFCToolBar::GetButtonInfo

Mengembalikan ID perintah, gaya, dan indeks gambar tombol pada indeks tertentu.

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

Parameter

nIndex
[di] Menentukan indeks tombol dalam daftar tombol pada toolbar.

nID
[out] ID perintah tombol.

nStyle
[out] Gaya tombol.

iImage
[out] Indeks gambar untuk tombol .

Keterangan

Metode ini GetButtonInfo menemukan tombol toolbar pada indeks yang ditentukan dan mengambil ID perintah, gaya, dan indeks gambar tombol.

Jika tombol pada indeks yang ditentukan tidak ada, kerangka kerja diatur nID dan nStyle ke 0, dan iImage ke -1 saat metode kembali.

CMFCToolBar::GetButtonSize

Mengembalikan dimensi setiap tombol pada toolbar.

CSize GetButtonSize() const;

Tampilkan Nilai

CSize Objek Kelas yang menentukan dimensi setiap tombol pada toolbar.

Keterangan

Panggil CMFCToolBar::SetSizes atau CMFCToolBar::SetLockedSizes untuk mengatur dimensi setiap tombol pada toolbar.

CMFCToolBar::GetButtonStyle

Mengembalikan gaya tombol toolbar saat ini yang terletak di indeks yang ditentukan.

UINT GetButtonStyle(int nIndex) const;

Parameter

nIndex
[di] Menentukan indeks tombol bilah alat.

Tampilkan Nilai

Nilai yang menentukan gaya tombol toolbar. . Lihat Gaya Kontrol ToolBar untuk daftar kemungkinan gaya.

Keterangan

Panggilan CMFCToolBar::SetButtonStyle untuk mengatur gaya tombol toolbar

CMFCToolBar::GetButtonText

Mengembalikan label teks tombol yang memiliki indeks tertentu.

CString GetButtonText(int nIndex) const;

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

Parameter

nIndex
[di] Indeks tombol toolbar.

rString
[out] Teks label tombol toolbar.

Tampilkan Nilai

Teks label tombol toolbar.

Keterangan

Panggil CMFCToolBar::SetButtonText atau CMFCToolBar::SetToolBarBtnText untuk mengatur label teks.

CMFCToolBar::GetColdImages

Mengembalikan penunjuk ke kumpulan gambar tombol toolbar dingin dalam aplikasi.

static CMFCToolBarImages* GetColdImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar tombol toolbar dingin.

Keterangan

Gambar dingin adalah gambar yang digunakan ketika pengguna tidak berinteraksi dengan tombol toolbar. Panggil CMFCToolBar::LoadBitmapEx atau CMFCToolBar::LoadBitmap untuk memuat gambar dingin.

CMFCToolBar::GetColumnWidth

Mengembalikan lebar tombol toolbar.

virtual int GetColumnWidth() const;

Tampilkan Nilai

Nilai yang menentukan lebar tombol toolbar.

Keterangan

Kerangka kerja memanggil metode ini untuk menghitung tata letak toolbar. Ambil alih metode ini dalam kelas turunan untuk menentukan lebar kolom yang berbeda untuk toolbar Anda.

CMFCToolBar::GetCommandButtons

Mengembalikan daftar tombol yang memiliki ID perintah tertentu dari semua toolbar dalam aplikasi.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

Parameter

uiCmd
[di] ID perintah tombol.

listButtons
[out] Referensi ke CObList objek Kelas yang menerima daftar tombol toolbar.

Tampilkan Nilai

Jumlah tombol yang memiliki ID perintah yang ditentukan.

CMFCToolBar::GetCount

Mengembalikan jumlah tombol dan pemisah pada toolbar.

int GetCount() const;

Tampilkan Nilai

Jumlah tombol dan pemisah pada toolbar.

CMFCToolBar::GetCustomizeButton

Mengambil penunjuk ke CMFCCustomizeButton objek yang terkait dengan bilah alat.

CMFCCustomizeButton* GetCustomizeButton();

Tampilkan Nilai

Penunjuk ke CMFCCustomizeButton objek yang terkait dengan toolbar.

Keterangan

Metode ini mengambil tombol Kustomisasi yang muncul di akhir bilah alat. CMFCToolBar::EnableCustomizeButton Gunakan metode untuk menambahkan tombol Kustomisasi ke toolbar Anda.

Anda dapat memanggil CMFCToolBar::IsExistCustomizeButton metode untuk menentukan apakah bilah alat berisi objek yang valid CMFCCustomizeButton .

CMFCToolBar::GetDefaultImage

Mengembalikan indeks gambar default untuk tombol toolbar dengan ID perintah tertentu.

static int GetDefaultImage(UINT uiID);

Parameter

uiID
[di] Menentukan ID perintah tombol.

Tampilkan Nilai

Indeks gambar toolbar dalam daftar gambar bersama.

Keterangan

Gunakan metode bersama ini untuk mengambil indeks gambar default untuk tombol toolbar dengan ID perintah yang ditentukan. Nilai yang dikembalikan adalah indeks ke dalam kumpulan gambar tombol toolbar bersama untuk semua toolbar dalam aplikasi. CMFCToolBar::GetImages Panggil metode untuk mendapatkan penunjuk ke koleksi ini.

CMFCToolBar::GetDisabledImages

Mengembalikan penunjuk ke kumpulan gambar yang digunakan untuk tombol toolbar yang dinonaktifkan dalam aplikasi.

static CMFCToolBarImages* __stdcall GetDisabledImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar tombol toolbar yang dinonaktifkan.

Keterangan

Muat gambar tombol toolbar yang dinonaktifkan dengan menggunakan CMFCToolBarEditBoxButton Kelas dan CMFCToolBar::LoadBitmap metode.

CMFCToolBar::GetDisabledMenuImages

Mengembalikan penunjuk ke kumpulan gambar yang digunakan untuk tombol menu yang dinonaktifkan dalam aplikasi.

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar menu yang dinonaktifkan.

Keterangan

Muat gambar yang dinonaktifkan dengan menggunakan CMFCToolBarEditBoxButton metode Kelas .

CMFCToolBar::GetDroppedDownMenu

Mengambil penunjuk ke objek tombol menu yang saat ini menampilkan sub-menunya.

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

Parameter

pIndex
[out] Menerima indeks tombol dalam kumpulan tombol toolbar.

Tampilkan Nilai

Penunjuk ke objek tombol menu yang menampilkan sub-menunya atau NULL jika tidak ada menu yang menampilkan sub-menunya.

Keterangan

Jika metode ini mengembalikan nilai non-null dan pIndex bukan NULL, nilai yang ditujukan ke diatur pIndex ke indeks tombol menu dalam kumpulan tombol toolbar.

CMFCToolBar::GetGrayDisabledButtons

Menentukan apakah gambar tombol yang dinonaktifkan adalah versi redup dari gambar tombol biasa, atau diambil dari kumpulan gambar tombol yang dinonaktifkan.

BOOL GetGrayDisabledButtons() const;

Tampilkan Nilai

TRUE untuk meringkas gambar tombol yang dinonaktifkan; FALSE untuk mendapatkan gambar dari kumpulan gambar yang dinonaktifkan.

Keterangan

Gunakan CMFCToolBar::SetGrayDisabledButtons untuk beralih antara gambar redup dan gambar dari kumpulan gambar yang dinonaktifkan.

CMFCToolBar::GetHighlightedButton

Mengembalikan penunjuk ke tombol toolbar yang saat ini disorot.

CMFCToolBarButton* GetHighlightedButton() const;

Tampilkan Nilai

Penunjuk ke objek tombol toolbar; atau NULL jika tidak ada tombol yang disorot.

Keterangan

Tombol toolbar disorot jika memiliki fokus keyboard. Tombol toolbar juga disorot jika tombol toolbar dilacak panas dalam aplikasi ini (untuk informasi selengkapnya, lihat CMFCToolBar::GetHotBorder dan CMFCToolBar::SetHotBorder) dan mouse menunjuknya ketika tidak ada tombol toolbar atau item menu yang memiliki fokus keyboard.

CMFCToolBar::GetHotBorder

Menentukan apakah tombol toolbar dilacak dengan panas. Jika tombol dilacak panas, tombol akan disorot saat mouse bergerak melintasinya.

BOOL GetHotBorder() const;

Tampilkan Nilai

TRUE jika tombol toolbar dilacak dengan panas; jika tidak, FALSE.

Keterangan

Secara default, tombol toolbar dilacak dengan panas.

CMFCToolBar::GetHotTextColor

Mengembalikan warna teks dari tombol toolbar yang disorot.

static COLORREF GetHotTextColor();

Tampilkan Nilai

COLORREF Nilai yang mewakili warna teks yang disorot saat ini.

Keterangan

Panggil CMFCToolBar::SetHotTextColor untuk mengatur warna teks baru untuk tombol toolbar yang disorot.

CMFCToolBar::GetHwndLastFocus

Mengembalikan handel ke jendela yang memiliki fokus input tepat sebelum toolbar melakukannya.

HWND GetHwndLastFocus() const;

Tampilkan Nilai

Handel ke jendela yang tidak berasal dari CMFCBaseToolBar Kelas, yang sebelumnya memiliki fokus input; atau NULL jika tidak ada jendela tersebut.

Keterangan

CMFCToolBar Ketika kontrol menerima fokus input, kontrol menyimpan handel ke jendela yang kehilangan fokus sehingga dapat memulihkannya nanti.

CMFCToolBar::GetIgnoreSetText

Menentukan apakah panggilan untuk mengatur label tombol diabaikan.

BOOL GetIgnoreSetText() const;

Tampilkan Nilai

TRUE jika panggilan untuk mengatur label tombol diabaikan; jika tidak, FALSE.

Keterangan

CMFCToolBar::GetImages

Mengembalikan penunjuk ke kumpulan gambar tombol default dalam aplikasi.

static CMFCToolBarImages* GetImages();

Tampilkan Nilai

Penunjuk ke CMFCToolBarImages objek Kelas yang berisi kumpulan gambar default untuk semua toolbar dalam aplikasi.

Keterangan

Metode bersama ini menyediakan akses ke kumpulan semua gambar toolbar default untuk aplikasi. CMFCToolBar::LoadBitmap Panggil metode untuk menambahkan gambar ke koleksi.

CMFCToolBar::GetImageSize

Mengembalikan ukuran gambar tombol toolbar saat ini.

CSize GetImageSize() const;

Tampilkan Nilai

CSize Objek Kelas yang mewakili ukuran gambar tombol toolbar saat ini.

CMFCToolBar::GetImagesOffset

Mengembalikan offset indeks yang digunakan untuk menemukan gambar tombol toolbar untuk toolbar ini dalam daftar global gambar tombol toolbar.

int GetImagesOffset() const;

Tampilkan Nilai

Offset indeks gambar toolbar.

Keterangan

Semua gambar default toolbar disimpan dalam daftar Kelas globalCMFCToolBarImages. Gambar untuk setiap tombol di toolbar disimpan secara berturut-turut dalam daftar tersebut. Untuk menghitung indeks gambar, tambahkan indeks tombol di toolbar ke offset awal daftar gambar untuk tombol toolbar tersebut.

Panggil CMFCToolBar::ButtonToIndex untuk mendapatkan indeks tombol toolbar yang diberikan penunjuk ke tombol .

Panggil CMFCToolBar::GetImages untuk mendapatkan penunjuk ke kumpulan gambar toolbar.

CMFCToolBar::GetInvalidateItemRect

Mengambil wilayah area klien yang harus digambar ulang untuk tombol pada indeks yang diberikan.

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

Parameter

nIndex
[di] Indeks tombol untuk mengambil area klien.

lpRect
[out] Pointer ke RECT objek yang menerima wilayah area klien.

Keterangan

Parameter lpRect tidak boleh NULL. Jika tidak ada tombol pada indeks yang disediakan, lpRect menerima RECT objek yang diinisialisasi ke nol.

CMFCToolBar::GetItemID

Mengembalikan ID perintah tombol toolbar pada indeks tertentu.

UINT GetItemID(int nIndex) const;

Parameter

nIndex
[di] Menentukan indeks tombol bilah alat.

Tampilkan Nilai

ID perintah tombol toolbar; atau nol jika tombol dengan indeks yang ditentukan tidak ada.

CMFCToolBar::GetItemRect

Mengembalikan persegi panjang pembatas tombol pada indeks tertentu.

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

Parameter

nIndex
[di] Menentukan indeks tombol bilah alat.

lpRect
[out] Penunjuk ke CRect objek yang menerima koordinat persegi panjang pembatas gambar.

Keterangan

Objek CRect tempat lpRect titik diatur ke 0 jika tombol pada indeks yang ditentukan tidak ada.

Contoh

Contoh berikut menunjukkan cara menggunakan GetItemRect metode CMFCToolBar kelas. Cuplikan kode ini adalah bagian dari sampel Demo IE.

CMFCToolBar m_wndToolBar;
CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

CMFCToolBar::GetLargeColdImages

Mengembalikan penunjuk ke kumpulan gambar tombol toolbar dingin besar dalam aplikasi.

static CMFCToolBarImages* GetLargeColdImages();

Tampilkan Nilai

Penunjuk ke koleksi gambar dingin besar.

Keterangan

Gambar dingin adalah gambar yang digunakan ketika pengguna tidak berinteraksi dengan tombol toolbar. Panggil CMFCToolBar::LoadBitmapEx untuk memuat gambar dingin besar.

CMFCToolBar::GetLargeDisabledImages

Mengembalikan penunjuk ke kumpulan gambar tombol toolbar besar yang dinonaktifkan dalam aplikasi.

static CMFCToolBarImages* GetLargeDisabledImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar tombol toolbar besar yang dinonaktifkan.

Keterangan

Gambar besar adalah versi besar dari gambar tombol toolbar reguler. Panggil CMFCToolBar::LoadBitmapEx atau CMFCToolBar::LoadBitmap untuk memuat gambar besar.

CMFCToolBar::GetLargeImages

Mengembalikan penunjuk ke kumpulan gambar tombol toolbar besar dalam aplikasi.

static CMFCToolBarImages* GetLargeImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar tombol toolbar besar.

Keterangan

Gambar besar adalah versi besar dari gambar tombol toolbar reguler. Panggil CMFCToolBar::LoadBitmapEx untuk memuat gambar besar.

CMFCToolBar::GetLockedColdImages

Mengembalikan penunjuk ke kumpulan gambar dingin terkunci di toolbar.

CMFCToolBarImages* GetLockedColdImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar dingin terkunci, atau NULL jika toolbar tidak dikunci.

Keterangan

Gambar terkunci adalah versi gambar tombol toolbar reguler yang digunakan kerangka kerja saat pengguna tidak dapat menyesuaikan toolbar. Gambar dingin adalah gambar yang digunakan ketika pengguna tidak berinteraksi dengan tombol toolbar.

Metode ini mengembalikan NULL jika toolbar tidak dikunci. Metode ini juga menghasilkan kegagalan pernyataan di build Debug jika toolbar tidak dikunci. Untuk informasi selengkapnya tentang toolbar terkunci, lihat CMFCToolBar::IsLocked.

CMFCToolBar::LoadBitmapEx Panggil metode untuk memuat gambar dingin yang terkunci.

CMFCToolBar::GetLockedDisabledImages

Mengembalikan penunjuk ke kumpulan gambar yang dinonaktifkan terkunci di toolbar.

CMFCToolBarImages* GetLockedDisabledImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar yang dinonaktifkan terkunci, atau NULL jika toolbar tidak dikunci.

Keterangan

Gambar terkunci adalah versi gambar tombol toolbar reguler yang digunakan kerangka kerja saat pengguna tidak dapat menyesuaikan toolbar. Gambar yang dinonaktifkan adalah gambar yang digunakan kerangka kerja saat tombol memiliki TBBS_DISABLED gaya.

Metode ini mengembalikan NULL jika toolbar tidak dikunci. Metode ini juga menghasilkan kegagalan pernyataan di build Debug jika toolbar tidak dikunci. Untuk informasi selengkapnya tentang toolbar terkunci, lihat CMFCToolBar::IsLocked.

CMFCToolBar::LoadBitmapEx Panggil metode untuk memuat gambar yang dinonaktifkan terkunci.

CMFCToolBar::GetLockedImages

Mengembalikan penunjuk ke kumpulan gambar tombol terkunci di toolbar.

CMFCToolBarImages* GetLockedImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar tombol toolbar terkunci, atau NULL jika toolbar tidak dikunci.

Keterangan

Gambar terkunci adalah versi gambar tombol toolbar reguler yang digunakan kerangka kerja saat pengguna tidak dapat menyesuaikan toolbar.

Metode ini mengembalikan NULL jika toolbar tidak dikunci. Metode ini juga menghasilkan kegagalan pernyataan di build Debug jika toolbar tidak dikunci. Untuk informasi selengkapnya tentang toolbar terkunci, lihat CMFCToolBar::IsLocked.

CMFCToolBar::GetLockedImageSize

Mengembalikan ukuran default gambar toolbar terkunci.

CSize GetLockedImageSize() const;

Tampilkan Nilai

Struktur CSize yang menentukan ukuran gambar toolbar terkunci atau struktur kosong CSize jika toolbar tidak dikunci.

Keterangan

Gambar terkunci adalah versi gambar tombol toolbar reguler yang digunakan kerangka kerja saat pengguna tidak dapat menyesuaikan toolbar.

Metode ini mengembalikan CSize struktur dengan lebar nol dan tinggi nol jika toolbar tidak dikunci. Metode ini juga menghasilkan kegagalan pernyataan di build Debug jika toolbar tidak dikunci. Untuk informasi selengkapnya tentang toolbar terkunci, lihat CMFCToolBar::IsLocked.

CMFCToolBar::SetLockedSizes Panggil metode untuk menentukan ukuran gambar terkunci.

CMFCToolBar::GetLockedMenuImages

Mengembalikan penunjuk ke kumpulan gambar menu toolbar terkunci di toolbar.

CMFCToolBarImages* GetLockedMenuImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar menu toolbar terkunci, atau NULL jika toolbar tidak dikunci.

Keterangan

Gambar terkunci adalah versi gambar menu toolbar reguler yang digunakan kerangka kerja saat pengguna tidak dapat menyesuaikan toolbar.

Metode ini mengembalikan NULL jika toolbar tidak dikunci. Metode ini juga menghasilkan kegagalan pernyataan di build Debug jika toolbar tidak dikunci. Untuk informasi selengkapnya tentang toolbar terkunci, lihat CMFCToolBar::IsLocked.

CMFCToolBar::LoadBitmapEx Panggil metode untuk memuat gambar menu terkunci.

CMFCToolBar::GetMenuButtonSize

Mengembalikan ukuran tombol menu dalam aplikasi.

static CSize GetMenuButtonSize();

Tampilkan Nilai

Objek CSize yang mewakili ukuran tombol menu, dalam piksel.

Keterangan

Ukuran tombol menu pada toolbar dipertahankan sebagai variabel global dan dapat diambil dengan metode statis ini.

Panggil CMFCToolBar::SetMenuSizes untuk mengatur variabel global ini.

CMFCToolBar::GetMenuImages

Mengembalikan penunjuk ke kumpulan gambar tombol menu dalam aplikasi.

static CMFCToolBarImages* GetMenuImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar menu.

Keterangan

CMFCToolBar::LoadBitmapEx Panggil metode untuk memuat gambar menu.

CMFCToolBar::SetMenuSizes Panggil metode untuk mengatur ukuran tombol dan gambarnya.

CMFCToolBar::GetMenuImageSize

Mengembalikan ukuran gambar tombol menu dalam aplikasi.

static CSize GetMenuImageSize();

Tampilkan Nilai

Objek CSize yang mewakili ukuran gambar menu.

Keterangan

Metode ini mengembalikan ukuran gambar pada tombol menu toolbar yang dipertahankan sebagai variabel global. Panggil CMFCToolBar::SetMenuSizes untuk mengatur variabel global ini.

CMFCToolBar::GetOrigButtons

Mengambil kumpulan tombol bilah alat yang tidak disesuaikan.

const CObList& GetOrigButtons() const;

Tampilkan Nilai

Referensi ke daftar tombol toolbar yang tidak dikustomisasi.

Keterangan

Kerangka kerja membuat salinan tombol toolbar sebelum disesuaikan oleh pengguna. Metode ini CMFCToolBar::SetButtons menambahkan salinan setiap tombol dalam array yang disediakan ke daftar tombol asli. Metode memulihkan CMFCToolBar::RestoreOriginalState status asli toolbar dengan memuatnya dari file sumber daya.

Untuk mengatur daftar tombol asli untuk toolbar Anda, panggil CMFCToolBar::SetOrigButtons metode .

CMFCToolBar::GetOrigResetButtons

Mengambil kumpulan tombol reset yang tidak disesuaikan dari toolbar.

const CObList& GetOrigResetButtons() const;

Tampilkan Nilai

Referensi ke daftar tombol reset yang tidak disesuaikan dari toolbar.

Keterangan

Saat pengguna memilih tombol Reset selama mode kustomisasi, kerangka kerja menggunakan metode ini untuk memulihkan tombol yang dihapus dari toolbar.

Metode menambahkan CMFCToolBar::SetButtons salinan setiap tombol toolbar ke daftar tombol reset asli setelah memanggil CMFCToolBar::OnReset metode . Anda dapat mengambil alih CMFCToolBar::OnReset metode untuk menyesuaikan tampilan tombol setelah pengguna menekan tombol Reset .

CMFCToolBar::GetResourceID

Mengambil ID sumber daya toolbar.

UINT GetResourceID() const;

Tampilkan Nilai

ID sumber daya toolbar.

Keterangan

CMFCToolBar::LoadToolBarEx Panggil metode untuk mengatur ID sumber daya toolbar.

CMFCToolBar::GetRouteCommandsViaFrame

Menentukan objek mana, bingkai induk atau pemilik, mengirim perintah ke toolbar.

BOOL GetRouteCommandsViaFrame();

Tampilkan Nilai

Bukan nol jika bingkai induk mengirim perintah ke toolbar; 0 jika pemilik mengirim perintah ke toolbar.

Keterangan

Secara default, bingkai induk mengirim perintah ke toolbar. Panggil CMFCToolBar::SetRouteCommandsViaFrame untuk mengubah perilaku ini.

Jika metode ini mengembalikan nilai bukan nol, Anda dapat mengambil penunjuk ke objek bingkai induk dengan menggunakan CMFCToolBar::GetCommandTarget metode . Lihat sampel VisualStudioDemo untuk contoh yang menggunakan metode ini.

CMFCToolBar::GetRowHeight

Mengembalikan tinggi tombol toolbar.

virtual int GetRowHeight() const;

Tampilkan Nilai

Tinggi tombol toolbar, dalam piksel.

Keterangan

Kerangka kerja memanggil metode ini untuk menghitung tata letak toolbar. Ambil alih metode ini di kelas turunan untuk menentukan tinggi yang berbeda untuk toolbar Anda.

CMFCToolBar::GetShowTooltips

Menentukan apakah tips alat ditampilkan untuk tombol toolbar.

static BOOL GetShowTooltips();

Tampilkan Nilai

TRUE jika tips alat ditampilkan untuk tombol toolbar; jika tidak FALSE.

Keterangan

Secara default tips alat ditampilkan. Anda dapat mengubah bendera statis ini dengan memanggil CMFCToolBar::SetShowTooltips.

CMFCToolBar::GetSiblingToolBar

Mengambil saudara dari bilah alat.

CMFCToolBar* GetSiblingToolBar();

Tampilkan Nilai

Penunjuk ke toolbar saudara.

Keterangan

Untuk informasi selengkapnya tentang cara mengaktifkan tombol Perlihatkan pada Satu Baris dan Perlihatkan Tombol pada tombol Dua Baris , lihat CMFCToolBar::SetSiblingToolBar.

CMFCToolBar::GetUserImages

Mengembalikan penunjuk ke kumpulan gambar tombol toolbar yang ditentukan pengguna dalam aplikasi.

static CMFCToolBarImages* GetUserImages();

Tampilkan Nilai

Penunjuk ke kumpulan gambar tombol toolbar yang ditentukan pengguna untuk semua toolbar dalam aplikasi.

Keterangan

CMFCToolBar::SetUserImages Panggil metode untuk mengatur kumpulan gambar yang ditentukan pengguna dalam aplikasi.

CMFCToolBar::HitTest

Mengembalikan indeks tombol toolbar yang terletak pada posisi yang ditentukan.

virtual int HitTest(CPoint point);

Parameter

point
[di] Titik yang akan diuji, dalam koordinat klien.

Tampilkan Nilai

Indeks tombol yang terletak pada posisi yang ditentukan, atau -1 jika tidak ada tombol tersebut atau tombol adalah pemisah.

CMFCToolBar::InsertButton

Sisipkan tombol ke bilah alat.

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

Parameter

button
[di] Menentukan tombol untuk disisipkan.

iInsertAt
[di] Menentukan posisi berbasis nol untuk menyisipkan tombol.

Tampilkan Nilai

Posisi di mana tombol disisipkan atau -1 jika terjadi kesalahan.

Keterangan

Jika iInsertAt -1, metode ini menambahkan tombol ke akhir daftar tombol toolbar.

CMFCToolBar::InsertSeparator Panggil metode untuk menyisipkan pemisah ke toolbar.

CMFCToolBar::InsertSeparator

Sisipkan pemisah ke bilah alat.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Parameter

iInsertAt
[di] Menentukan posisi berbasis nol untuk menyisipkan pemisah. Parameter ini harus lebih besar dari 0.

Tampilkan Nilai

Posisi di mana pemisah dimasukkan atau -1 jika terjadi kesalahan.

Keterangan

Panggil metode ini untuk menyisipkan pemisah antara dua tombol yang ada. Jika iInsertAt -1, metode ini menambahkan pemisah ke akhir daftar tombol toolbar.

Anda tidak dapat menggunakan metode ini untuk menambahkan pemisah ke bilah alat kosong.

CMFCToolBar::InsertButton Panggil metode untuk menyisipkan tombol ke toolbar.

CMFCToolBar::InvalidateButton

Membatalkan area klien dari tombol toolbar yang ada di indeks yang disediakan.

CMFCToolBarButton* InvalidateButton(int nIndex);

Parameter

nIndex
[di] Indeks berbasis nol tombol di toolbar.

Tampilkan Nilai

Penunjuk ke CMFCToolBarButton objek yang ada di indeks yang disediakan atau NULL jika tidak ada objek tersebut.

Keterangan

Kerangka kerja memanggil metode ini ketika memperbarui area klien yang terkait dengan tombol toolbar. Ini memanggil CWnd::InvalidateRect metode dengan persegi panjang klien objek CMFCToolBarButton yang ada di indeks yang disediakan.

CMFCToolBar::IsAddRemoveQuickCustomize

Menentukan apakah pengguna dapat menambahkan atau menghapus tombol bilah alat dengan menggunakan opsi menu Kustomisasi .

BOOL IsAddRemoveQuickCustomize();

Tampilkan Nilai

TRUE jika pengguna dapat menggunakan opsi Sesuaikan menu untuk mengubah toolbar; jika tidak, FALSE.

Keterangan

CMFCToolBar::IsAltCustomizeMode

Menentukan apakah kustomisasi cepat sedang digunakan untuk menyeret tombol. Saat kustomisasi cepat diaktifkan, pengguna dapat menekan dan menahan tombol Alt dan menyeret tombol ke lokasi baru.

static BOOL __stdcall IsAltCustomizeMode();

Tampilkan Nilai

TRUE jika kustomisasi cepat digunakan untuk menyeret tombol; jika tidak, FALSE.

Keterangan

CMFCToolBar::IsAutoGrayInactiveImages

Menentukan apakah pembuatan otomatis gambar tombol tidak aktif (tidak disorot) diaktifkan.

static BOOL IsAutoGrayInactiveImages();

Tampilkan Nilai

TRUE jika opsi untuk menonaktifkan gambar yang tidak aktif secara otomatis diaktifkan; jika tidak FALSE.

Keterangan

Anda dapat mengaktifkan atau menonaktifkan perendaman otomatis gambar yang tidak aktif dengan memanggil CMFCToolBar::AutoGrayInactiveImages.

CMFCToolBar::IsBasicCommand

Menentukan apakah perintah ada dalam daftar perintah dasar.

static BOOL IsBasicCommand(UINT uiCmd);

Parameter

uiCmd
[di] Menentukan perintah yang akan diperiksa.

Tampilkan Nilai

TRUE jika perintah yang ditentukan termasuk dalam daftar perintah dasar; jika tidak FALSE.

Keterangan

Metode statis ini menentukan apakah perintah yang ditentukan oleh uiCmd milik daftar global perintah dasar. Anda dapat mengubah daftar perintah dasar dengan memanggil CMFCToolBar::AddBasicCommand atau CMFCToolBar::SetBasicCommands.

CMFCToolBar::IsButtonExtraSizeAvailable

Menentukan apakah bilah alat dapat menampilkan tombol yang memiliki batas yang diperluas.

virtual BOOL IsButtonExtraSizeAvailable() const;

Tampilkan Nilai

TRUE jika bilah dapat menampilkan tombol dengan ukuran batas tambahan; jika tidak FALSE.

Keterangan

Objek toolbar mengembalikan TRUE jika dapat menampilkan tombol yang memiliki batas yang diperluas. Tombol toolbar memanggil metode ini saat menangani CMFCToolBarButton::OnChangeParentWnd pemberitahuan dan akan mengatur bendera ukuran batas tambahan internalnya. Bendera internal ini dapat diambil nanti dengan memanggil CMFCToolBarButton::IsExtraSize.

Ambil alih metode ini dalam kelas yang berasal dari CMFCToolBar dan kembali TRUE jika bilah Anda dapat menampilkan tombol toolbar dengan ukuran batas tambahan dan mengembalikan FALSE sebaliknya. Implementasi default mengembalikan TRUE.

CMFCToolBar::IsButtonHighlighted

Menentukan apakah tombol yang ditentukan disorot.

BOOL IsButtonHighlighted(int iButton) const;

Parameter

iButton
[di] Menentukan indeks tombol bilah alat.

Tampilkan Nilai

TRUE jika tombol yang ditentukan disorot; jika tidak, FALSE.

Keterangan

CMFCToolBar::IsCommandPermitted

Menentukan apakah perintah diizinkan.

static BOOL IsCommandPermitted(UINT uiCmd);

Parameter

uiCmd
[di] Menentukan perintah yang akan diperiksa.

Tampilkan Nilai

TRUE jika perintah yang ditentukan diizinkan; jika tidak FALSE.

Keterangan

Metode statis ini menentukan apakah perintah yang ditentukan oleh uiCmd milik daftar global perintah yang tidak diizinkan.

Anda dapat mengubah daftar perintah yang tidak diizinkan dengan memanggil CMFCToolBar::SetNonPermittedCommands.

CMFCToolBar::IsCommandRarelyUsed

Menentukan apakah perintah jarang digunakan.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Parameter

uiCmd
[di] Menentukan perintah yang akan diperiksa.

Tampilkan Nilai

TRUE jika perintah yang ditentukan jarang digunakan; jika tidak FALSE.

Keterangan

Metode IsCommandRarelyUsed ini kembali FALSE ketika satu atau beberapa kondisi berikut terjadi:

  • Perintah yang ditentukan termasuk dalam daftar perintah dasar

  • Perintah yang ditentukan adalah salah satu perintah standar

  • Kerangka kerja dalam mode kustomisasi

  • Daftar perintah dasar kosong

  • Lebih dari 20% panggilan perintah adalah panggilan ke perintah yang ditentukan.

CMFCToolBar::IsCustomizeMode

Menentukan apakah kerangka kerja toolbar berada dalam mode kustomisasi.

static BOOL IsCustomizeMode();

Tampilkan Nilai

TRUE jika kerangka kerja dalam mode kustomisasi; jika tidak FALSE.

Keterangan

Anda dapat mengalihkan mode kustomisasi dengan memanggil CMFCToolBar::SetCustomizeMode.

Kerangka kerja mengubah mode saat pengguna memanggil kotak dialog kustomisasi ( CMFCToolBarsCustomizeDialog Kelas).

CMFCToolBar::IsDragButton

Menentukan apakah tombol toolbar sedang diseret.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Parameter

pButton
[di] Tombol penunjuk ke toolbar.

Tampilkan Nilai

TRUE jika tombol yang ditentukan sedang diseret; jika tidak, FALSE.

Keterangan

CMFCToolBar::IsExistCustomizeButton

Menentukan apakah bilah alat berisi tombol Kustomisasi .

BOOL IsExistCustomizeButton();

Tampilkan Nilai

TRUE jika toolbar berisi tombol Kustomisasi ; jika tidak FALSE.

Keterangan

Jika metode ini mengembalikan TRUE, CMFCToolBar::GetCustomizeButton metode mengembalikan penunjuk ke tombol Kustomisasi yang muncul di akhir toolbar.

CMFCToolBar::EnableCustomizeButton Gunakan metode untuk menambahkan tombol Kustomisasi ke toolbar Anda.

CMFCToolBar::IsFloating

Menentukan apakah bilah alat mengambang.

virtual BOOL IsFloating() const;

Tampilkan Nilai

TRUE jika toolbar mengambang; jika tidak, FALSE.

CMFCToolBar::IsLargeIcons

Menentukan apakah bilah alat dalam aplikasi saat ini menampilkan ikon besar.

static BOOL IsLargeIcons();

Tampilkan Nilai

TRUE jika aplikasi menggunakan ikon besar; jika tidak FALSE.

Keterangan

Panggil CMFCToolBar::SetLargeIcons untuk beralih antara ikon besar dan ikon reguler.

Kerangka kerja secara otomatis mengubah mode saat pengguna beralih ke kotak centang Ikon besar pada halaman Opsi kotak dialog Kustomisasi .

CMFCToolBar::IsLastCommandFromButton

Menentukan apakah perintah yang terakhir dijalankan dikirim dari tombol toolbar yang ditentukan.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Parameter

pButton
[di] Tombol Arahkan ke.

Tampilkan Nilai

TRUE jika perintah terakhir dikirim dari tombol yang pButton menentukan; jika tidak FALSE.

Keterangan

Metode ini mendapatkan penunjuk ke MSG Struktur dengan memanggil CWnd::GetCurrentMessage. Kemudian membandingkan HWND tombol dengan MSG::lParam anggota dan MSG::hwnd untuk menentukan apakah tombol adalah sumber perintah.

CMFCToolBar::IsLocked

Menentukan apakah bilah alat terkunci.

BOOL IsLocked() const;

Tampilkan Nilai

TRUE jika toolbar dikunci; jika tidak, FALSE.

Keterangan

Metode ini mengembalikan TRUE ketika pengguna tidak dapat melakukan tugas kustomisasi seperti memposisikan ulang tombol toolbar.

Toolbar terkunci menggunakan daftar gambar terpisah. Untuk informasi selengkapnya tentang daftar gambar ini, lihat CMFCToolBar::LoadBitmapEx.

CMFCToolBar::IsOneRowWithSibling

Menentukan apakah toolbar dan toolbar saudaranya diposisikan pada baris yang sama.

BOOL IsOneRowWithSibling();

Tampilkan Nilai

TRUE jika toolbar dan saudara kandungnya diposisikan pada baris yang sama; jika tidak FALSE.

Keterangan

Metode CMFCCustomizeButton::CreatePopupMenu memanggil metode ini untuk menentukan cara menampilkan menu pop-up Kustomisasi . Jika metode ini mengembalikan TRUE, kerangka kerja menampilkan tombol Perlihatkan Tombol pada Satu Baris . Jika tidak, kerangka kerja menampilkan tombol Perlihatkan Tombol pada Dua Baris .

Anda biasanya tidak perlu menggunakan metode ini. Untuk mengaktifkan Tombol Perlihatkan pada Satu Baris atau Perlihatkan Tombol pada tombol Dua Baris , panggil CMFCToolBar::SetSiblingToolBar.

CMFCToolBar::IsResourceChanged

virtual BOOL IsResourceChanged() const;

Tampilkan Nilai

Keterangan

CMFCToolBar::IsSibling

BOOL IsSibling();

Tampilkan Nilai

Keterangan

CMFCToolBar::IsUserDefined

Menentukan apakah bilah alat ditentukan pengguna.

BOOL IsUserDefined() const;

Tampilkan Nilai

TRUE jika toolbar dibuat oleh pengguna; jika tidak FALSE.

CMFCToolBar::LoadBitmap

Memuat gambar toolbar dari sumber daya aplikasi.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parameter

uiResID
[di] ID sumber daya bitmap yang mengacu pada gambar toolbar panas.

uiColdResID
[di] ID sumber daya bitmap yang mengacu pada gambar toolbar dingin.

uiMenuResID
[di] ID sumber daya bitmap yang mengacu pada gambar menu reguler.

bLocked
[di] TRUE untuk mengunci toolbar; jika tidak FALSE.

uiDisabledResID
[di] ID sumber daya bitmap yang mengacu pada gambar toolbar yang dinonaktifkan.

uiMenuDisabledResID
[di] ID sumber daya bitmap yang mengacu pada gambar menu yang dinonaktifkan.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0.

Keterangan

Metode CMFCToolBar::LoadToolBarEx ini memanggil metode ini untuk memuat gambar yang terkait dengan toolbar. Ambil alih metode ini untuk melakukan pemuatan kustom sumber daya gambar.

LoadBitmapEx Panggil metode untuk memuat gambar tambahan setelah Anda membuat toolbar.

CMFCToolBar::LoadBitmapEx

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

Parameter

[in] params
[in] bLocked\

Tampilkan Nilai

Keterangan

CMFCToolBar::LoadLargeIconsState

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Parameter

[in] lpszProfileName\

Tampilkan Nilai

Keterangan

CMFCToolBar::LoadParameters

Memuat opsi toolbar global dari registri Windows.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Parameter

lpszProfileName
[di] Menentukan jalur relatif kunci registri Windows.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0.

Keterangan

Metode ini memuat parameter global seperti jenis animasi menu, gaya bayangan menu, dan apakah akan menampilkan ikon besar dari registri Windows.

Metode CWinAppEx::LoadState ini memanggil metode ini sebagai bagian dari proses inisialisasi aplikasi.

CMFCToolBar::LoadState

Memuat informasi status bilah alat dari registri Windows.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameter

lpszProfileName
[di] Menentukan jalur relatif kunci registri Windows.

nIndex
[di] Menentukan ID kontrol bilah alat.

uiID
[di] Menentukan ID sumber daya bilah alat.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0.

Keterangan

Kerangka kerja memanggil metode ini sebagai bagian dari proses inisialisasi aplikasi. Untuk informasi selengkapnya, lihat CWinAppEx::LoadState .

CMFCToolBar::LoadToolBar

Memuat toolbar dari sumber daya aplikasi.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

Parameter

uiResID
[di] ID sumber daya toolbar.

uiColdResID
[di] ID sumber daya bitmap yang mengacu pada gambar toolbar dingin.

uiMenuResID
[di] ID sumber daya bitmap yang mengacu pada gambar menu reguler.

bLocked
[di] Nilai Boolean yang menentukan apakah toolbar terkunci atau tidak. Jika parameter ini adalah TRUE, toolbar dikunci. Jika tidak, toolbar tidak dikunci.

uiDisabledResID
[di] ID sumber daya bitmap yang mengacu pada gambar toolbar yang dinonaktifkan.

uiMenuDisabledResID
[di] ID sumber daya bitmap yang mengacu pada gambar menu yang dinonaktifkan.

uiHotResID
[di] ID sumber daya bitmap yang mengacu pada gambar toolbar panas.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0.

Keterangan

Kerangka kerja memanggil metode ini selama inisialisasi untuk memuat gambar yang terkait dengan toolbar.

Contoh

Contoh berikut menunjukkan cara menggunakan LoadToolBar metode di CMFCToolBar kelas . Cuplikan kode ini adalah bagian dari sampel Demo IE.

CMFCToolBar m_wndToolBar;
// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

CMFCToolBar::LoadToolBarEx

Memuat toolbar dari sumber daya aplikasi dengan menggunakan kelas pembantu CMFCToolBarInfo untuk memungkinkan aplikasi menggunakan gambar besar.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

Parameter

uiToolbarResID
[di] ID sumber daya toolbar.

params
[di] Referensi ke CMFCToolBarInfo objek yang berisi ID sumber daya untuk gambar toolbar.

bLocked
[di] Nilai Boolean yang menentukan apakah toolbar terkunci atau tidak. Jika parameter ini adalah TRUE, toolbar dikunci. Jika tidak, toolbar tidak dikunci.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0.

Keterangan

Panggil metode ini untuk memuat gambar toolbar dari sumber daya aplikasi.

CMFCToolBar::m_dblLargeImageRatio

Menentukan rasio antara dimensi (tinggi atau lebar) gambar besar dan dimensi gambar reguler.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Keterangan

Rasio defaultnya adalah 2. Anda dapat mengubah nilai ini untuk membuat gambar toolbar besar lebih besar atau lebih kecil.

Kerangka kerja menggunakan anggota data ini ketika Anda tidak menentukan sekumpulan gambar besar. Misalnya, jika Anda hanya menyediakan sekumpulan gambar kecil dengan ukuran 16x16 dan ingin gambar besar memiliki ukuran 24x24, atur anggota data ini ke 1,5.

CMFCToolBar::NextMenu

virtual BOOL NextMenu();

Tampilkan Nilai

Keterangan

CMFCToolBar::OnBeforeRemoveButton

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

Parameter

pButton
[in] Tidak terpakai.

dropEffect
[in] Tidak terpakai.

Tampilkan Nilai

Keterangan

CMFCToolBar::OnChangeHot

Dipanggil oleh kerangka kerja saat pengguna memilih tombol pada toolbar.

virtual void OnChangeHot(int iHot);

Parameter

iHot
[di] Menentukan indeks tombol toolbar yang dipilih; atau -1 jika tidak ada tombol bilah alat yang dipilih.

Keterangan

Ambil alih metode ini untuk memproses pemberitahuan bahwa pengguna memilih tombol pada toolbar.

CMFCToolBar::OnChangeVisualManager

virtual void OnChangeVisualManager();

Keterangan

CMFCToolBar::OnFillBackground

Dipanggil oleh kerangka kerja dari CBasePane::DoPaint untuk mengisi latar belakang toolbar.

virtual void OnFillBackground(CDC* pDC);

Parameter

pDC
[di] Penunjuk ke konteks perangkat.

Keterangan

CMFCToolBar::DoPaint memanggil metode ini ketika latar belakang bilah alat telah diisi. Implementasi default tidak melakukan apa pun.

Ambil alih metode ini untuk menggambar latar belakang kustom di kelas turunan.

CMFCToolBar::OnGlobalFontsChanged

virtual void OnGlobalFontsChanged();

Keterangan

CMFCToolBar::OnReset

Memulihkan bilah alat ke status aslinya.

virtual void OnReset();

Keterangan

Ambil alih metode ini untuk menangani pemberitahuan tentang reset toolbar.

Implementasi default tidak melakukan apa pun. Ambil alih OnReset di kelas yang berasal dari CMFCToolBar ketika toolbar memiliki tombol dummy yang harus diganti ketika toolbar kembali ke status aslinya.

CMFCToolBar::OnSetAccData

virtual BOOL OnSetAccData(long lVal);

Parameter

[in] lVal\

Tampilkan Nilai

Keterangan

CMFCToolBar::OnSetDefaultButtonText

Memulihkan teks tombol bilah alat ke status defaultnya.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parameter

pButton
[di] Menunjuk ke tombol, yang teksnya sedang diatur.

Tampilkan Nilai

TRUE jika teks berhasil dipulihkan; jika tidak FALSE.

Keterangan

Ambil alih metode ini untuk memproses pemberitahuan bahwa teks tombol toolbar sedang diubah ke defaultnya.

Implementasi default memuat teks tombol dari sumber daya aplikasi.

CMFCToolBar::OnUserToolTip

Dipanggil oleh kerangka kerja ketika tipsalat untuk tombol akan ditampilkan.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

Parameter

pButton
[di] Menunjuk ke tombol toolbar tempat tipsalat akan ditampilkan.

strTTText
[out] Referensi ke CString objek yang menerima teks tipsalat.

Tampilkan Nilai

TRUE jika strTTText diisi dengan teks tipsalat; jika tidak FALSE.

Keterangan

Kerangka kerja memanggil metode ini ketika tipsalat untuk tombol toolbar akan ditampilkan. Jika OnUserToolTip mengembalikan TRUE, kerangka kerja menampilkan tipsalat yang berisi teks yang dikembalikan oleh OnUserToolTip di strTTText. Jika tidak, tipsalat berisi teks tombol.

Ambil alih OnUserToolTip untuk menyesuaikan tips alat tombol toolbar. Implementasi default memanggil CMFCToolBar::OnUserToolTip untuk mendapatkan teks tipsalat.

CMFCToolBar::PrevMenu

virtual BOOL PrevMenu();

Tampilkan Nilai

Keterangan

CMFCToolBar::ProcessCommand

Memposting pesan WM_COMMAND ke jendela yang memiliki toolbar.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Parameter

pButton
[di] Penunjuk ke tombol pada toolbar.

Tampilkan Nilai

Metode ini harus selalu mengembalikan TRUE. MFC menggunakan FALSE nilai secara internal.

Keterangan

Metode ini memposting pesan ke jendela yang memiliki WM_COMMAND toolbar dengan memanggil CWnd::PostMessage dan meneruskan ID perintah tombol yang ditentukan sebagai wParam parameter.

ON_COMMAND Gunakan makro untuk memetakan WM_COMMAND pesan ke fungsi anggota.

CMFCToolBar::RemoveAllButtons

Menghapus semua tombol dan pemisah dari bilah alat.

virtual void RemoveAllButtons();

Keterangan

Kerangka kerja memanggil metode ini ketika membuat ulang atau menghancurkan toolbar.

CMFCToolBar::RemoveButton

Menghapus dari bilah alat tombol yang memiliki indeks yang ditentukan.

virtual BOOL RemoveButton(int iIndex);

Parameter

iIndex
[di] Menentukan indeks berbasis nol tombol yang akan dihapus.

Tampilkan Nilai

TRUE jika metode berhasil, atau FALSE jika indeks yang ditentukan tidak valid atau indeks mengacu pada tombol Kustomisasi .

Keterangan

Metode ini memperbarui atribut toolbar tambahan yang dipengaruhi oleh penghapusan tombol. Misalnya, metode ini menghapus pemisah tidak penting dari toolbar dan membangun kembali tabel kunci pintasan.

Untuk informasi selengkapnya tentang tombol Kustomisasi , lihat CMFCToolBar::EnableCustomizeButton.

CMFCToolBar::RemoveStateFromRegistry

Menghapus informasi status untuk bilah alat dari registri Windows.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameter

lpszProfileName
[di] Menentukan kunci registri tempat informasi status berada.

nIndex
[di] ID kontrol toolbar.

uiID
[di] ID sumber daya toolbar. Jika parameter ini adalah -1, metode ini menggunakan CWnd::GetDlgCtrlID metode untuk mengambil ID sumber daya.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0.

Keterangan

Kerangka kerja memanggil metode ini ketika menghapus toolbar yang ditentukan pengguna.

Ambil alih metode ini jika Anda menyimpan informasi status tambahan di registri Windows.

CMFCToolBar::ReplaceButton

Mengganti tombol bilah alat dengan tombol bilah alat lain.

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

Parameter

uiCmd
[di] ID perintah tombol untuk mengganti.

button
[di] Referensi ke untuk disisipkan CMFCToolBarButton .

bAll
[di] Nilai Boolean yang menentukan apakah akan mengganti semua tombol yang memiliki ID perintah yang ditentukan oleh uiCmd. Jika parameter ini adalah TRUE, semua tombol yang memiliki ID perintah yang ditentukan akan diganti. Jika tidak, tombol pertama diganti.

Tampilkan Nilai

Jumlah tombol yang diganti. Metode ini mengembalikan 0 jika tombol dengan ID perintah yang ditentukan tidak ada pada toolbar.

Keterangan

Panggil metode ini ketika Anda ingin menambahkan tombol bilah alat yang tidak dapat dimuat dari sumber daya. Anda dapat membuat tombol tempat penampung pada waktu desain dan mengganti tombol tersebut dengan tombol kustom saat Anda menginisialisasi toolbar. Lihat sampel VisualStudioDemo untuk contoh yang menggunakan metode ini.

Contoh

Contoh berikut menunjukkan cara menggunakan ReplaceButton metode di CMFCToolBar kelas . Cuplikan kode ini adalah bagian dari sampel Demo IE.

CMFCToolBar m_wndToolBar;
// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

CMFCToolBar::ResetAll

Memulihkan semua bilah alat ke status aslinya.

static void __stdcall ResetAll();

Keterangan

Metode ini memanggil CMFCToolBar::RestoreOriginalState metode pada setiap toolbar dalam aplikasi yang dapat dipulihkan. Ini menggunakan CMFCToolBar::CanBeRestored metode untuk menentukan apakah toolbar dapat dipulihkan.

CMFCToolBar::ResetAllImages

Menghapus semua koleksi gambar toolbar dalam aplikasi.

static void __stdcall ResetAllImages();

Keterangan

Metode ini menghapus koleksi gambar yang diinisialisasi CMFCToolBar::LoadToolBar oleh metode dan CMFCToolBar::LoadBitmap .

CMFCToolBar::ResetImages

virtual void ResetImages();

Keterangan

CMFCToolBar::RestoreFocus

virtual void RestoreFocus();

Keterangan

CMFCToolBar::RestoreOriginalState

Memulihkan status asli bilah alat.

virtual BOOL RestoreOriginalState();

Tampilkan Nilai

TRUE jika metode berhasil, atau FALSE jika metode gagal atau toolbar ditentukan pengguna.

Keterangan

Metode ini memuat toolbar dari file sumber daya dengan menggunakan CMFCToolBar::LoadToolBar metode .

Kerangka kerja memanggil metode ini saat pengguna memilih tombol Reset Semua pada halaman Toolbar kotak dialog kustomisasi.

CMFCToolBar::SaveParameters

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Parameter

[in] lpszProfileName\

Tampilkan Nilai

Keterangan

CMFCToolBar::SaveState

Menyimpan informasi status untuk bilah alat di registri Windows.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parameter

lpszProfileName
[di] Menentukan jalur relatif kunci registri Windows.

nIndex
[di] ID kontrol toolbar.

uiID
[di] ID sumber daya toolbar.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0.

Keterangan

Kerangka kerja memanggil metode ini ketika menyimpan status aplikasi ke registri. Untuk informasi selengkapnya, lihat CWinAppEx::SaveState .

CMFCToolBar::SetBasicCommands

Mengatur daftar perintah yang selalu ditampilkan saat pengguna membuka menu.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

Parameter

lstCommands
[di] Referensi ke CList objek yang berisi kumpulan perintah.

Keterangan

Perintah dasar selalu ditampilkan saat menu dibuka. Metode ini bermakna ketika pengguna memilih untuk melihat perintah yang baru digunakan.

CMFCToolBar::AddBasicCommand Gunakan metode untuk menambahkan perintah ke daftar perintah dasar. CMFCToolBar::GetBasicCommands Gunakan metode untuk mengambil daftar perintah dasar yang digunakan oleh aplikasi Anda.

Lihat sampel Explorer untuk contoh yang menggunakan metode ini.

CMFCToolBar::SetButtonInfo

Mengatur ID perintah, gaya, dan ID gambar tombol toolbar.

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

Parameter

nIndex
[di] Indeks berbasis nol tombol yang propertinya diatur.

nID
[di] ID perintah tombol.

nStyle
[di] Gaya tombol. Lihat Gaya Kontrol Bilah Alat untuk daftar gaya tombol toolbar yang tersedia.

iImage
[di] Indeks gambar berbasis nol tombol (yaitu, indeks dalam kumpulan gambar toolbar).

Keterangan

Panggil metode ini untuk mengatur properti tombol bilah alat.

Dalam build Debug, metode ini menghasilkan kegagalan pernyataan jika indeks yang ditentukan oleh nIndex tidak valid.

CMFCToolBar::SetButtonStyle Panggil metode untuk mengatur hanya gaya tombol.

CMFCToolBar::SetButtons

Mengatur tombol untuk bilah alat.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

Parameter

lpIDArray
[di] Penunjuk ke array ID perintah tombol untuk disisipkan.

nIDCount
[in] Jumlah item dalam lpIDArray.

bRemapImages
[di] Nilai Boolean yang menentukan apakah akan mengaitkan gambar tombol yang ada dengan tombol yang disisipkan. Jika parameter ini adalah TRUE, gambar akan dipetakan ulang.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0.

Keterangan

Panggil metode ini untuk menghapus tombol yang ada dari toolbar dan menyisipkan kumpulan tombol baru.

Metode ini menambahkan tombol Kustomisasi ke bilah alat dan mengirim AFX_WM_RESETTOOLBAR pesan ke jendela induk toolbar. Untuk informasi selengkapnya tentang tombol Kustomisasi , lihat CMFCToolBar::EnableCustomizeButton.

CMFCToolBar::SetButtonStyle

Mengatur gaya tombol toolbar pada indeks yang diberikan.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parameter

nIndex
[di] Indeks berbasis nol tombol toolbar yang gayanya akan diatur.

nStyle
[di] Gaya tombol. Lihat Gaya Kontrol Bilah Alat untuk daftar gaya tombol toolbar yang tersedia.

Keterangan

Metode ini menghapus TBBS_PRESSED gaya jika nStyle karena TBBS_DISABLED pengguna tidak dapat memilih tombol yang dinonaktifkan.

CMFCToolBar::SetButtonText

Mengatur label teks tombol toolbar.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parameter

nIndex
[di] Indeks tombol toolbar.

lpszText
[di] Label teks tombol toolbar. Batasan tidak boleh null.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

Keterangan

Metode ini mengembalikan FALSE jika indeks yang disediakan tidak merujuk ke tombol toolbar yang valid.

CMFCToolBar::SetCommandUsageOptions

Menentukan kapan perintah yang jarang digunakan tidak muncul di menu aplikasi.

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

Parameter

nStartCount
[di] Menentukan berapa kali perintah harus dijalankan sebelum kerangka kerja hanya menampilkan perintah dasar dan yang baru digunakan.

nMinUsagePercentage
[di] Persentase waktu perintah harus dijalankan untuk dianggap sebagai perintah yang baru-baru ini digunakan.

Tampilkan Nilai

FALSE jika nMinUsagePercentage sama dengan atau lebih besar dari 100; jika tidak TRUE.

Keterangan

Panggil metode ini untuk menyesuaikan algoritma yang digunakan kerangka kerja untuk menentukan bagaimana item menu dasar dan yang baru digunakan muncul. Untuk informasi selengkapnya tentang perintah dasar, lihat CMFCToolBar::AddBasicCommand.

Kelas ini menggunakan CMFCCmdUsageCount kelas untuk melacak jumlah penggunaan perintah. Untuk informasi selengkapnya tentang kelas ini, lihat CMFCCmdUsageCount Kelas.

CMFCToolBar::SetCustomizeMode

Mengaktifkan atau menonaktifkan mode kustomisasi untuk semua toolbar dalam aplikasi.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Parameter

bSet
[di] Nilai Boolean yang menentukan apakah akan mengaktifkan atau menonaktifkan mode kustomisasi. Atur parameter ini ke TRUE untuk mengaktifkan mode kustomisasi atau FALSE untuk menonaktifkannya.

Tampilkan Nilai

TRUE jika memanggil metode ini mengubah mode kustomisasi; jika tidak FALSE.

Keterangan

Metode ini menyesuaikan tata letak dan menggambar ulang setiap toolbar dalam aplikasi. CMFCToolBar::IsCustomizeMode Panggil metode untuk menentukan apakah aplikasi berada dalam mode kustomisasi,

CMFCToolBar::SetGrayDisabledButtons

Menentukan apakah tombol yang tidak tersedia pada toolbar diredupkan, atau apakah gambar yang tidak tersedia tombol digunakan.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Parameter

bGrayDisabledButtons
[di] Nilai Boolean yang menentukan cara menampilkan tombol yang tidak tersedia. Jika parameter ini adalah TRUE, kerangka kerja akan meringkas tombol. Jika tidak, kerangka kerja menggunakan kumpulan gambar yang tidak tersedia tombol.

Keterangan

Secara default, tombol yang tidak tersedia diredupkan.

CMFCToolBar::SetHeight

Mengatur tinggi bilah alat.

void SetHeight(int cyHeight);

Parameter

cyHeight
[di] Tinggi toolbar, dalam piksel.

Keterangan

Metode ini menggambar ulang toolbar setelah mengatur tinggi.

CMFCToolBar::SetHelpMode

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Parameter

[in] bOn\

Keterangan

CMFCToolBar::SetHot

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Parameter

[in] pMenuButton\

Tampilkan Nilai

Keterangan

CMFCToolBar::SetHotBorder

Menentukan apakah tombol bilah alat dilacak dengan panas.

void SetHotBorder(BOOL bShowHotBorder);

Parameter

bShowHotBorder
[di] Nilai Boolean yang menentukan apakah akan melacak tombol toolbar hot-track. Jika parameter ini adalah TRUE, toolbar akan melacak tombolnya. Jika tidak, toolbar tidak melacak tombolnya.

Keterangan

Jika tombol dilacak panas, kerangka kerja menyoroti tombol saat mouse bergerak melintasinya. Secara default, setiap toolbar melacak tombolnya.

CMFCToolBar::GetHotBorder Panggil metode untuk menentukan apakah bilah alat melacak tombolnya.

CMFCToolBar::SetHotTextColor

Mengatur warna teks untuk tombol bilah alat panas.

static void SetHotTextColor(COLORREF clrText);

Parameter

clrText
[di] Menentukan warna teks untuk tombol bilah alat yang dilacak panas.

Keterangan

Untuk informasi selengkapnya tentang tombol toolbar yang dilacak panas, lihat CMFCToolBar::GetHotBorder dan CMFCToolBar::SetHotBorder.

CMFCToolBar::SetIgnoreSetText

void SetIgnoreSetText(BOOL bValue);

Parameter

[in] bValue\

Keterangan

CMFCToolBar::SetLargeIcons

Menentukan apakah tombol bilah alat menampilkan ikon besar.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Parameter

bLargeIcons
[di] Nilai Boolean yang menentukan ikon mana yang akan digunakan. Jika parameter ini adalah TRUE, kerangka kerja menampilkan ikon besar. Jika tidak, kerangka kerja menampilkan ikon reguler.

Keterangan

Kerangka kerja memanggil metode ini ketika pengguna mengubah status kotak centang Ikon Besar di tab Opsi dari kotak dialog Kustomisasi . Metode ini mengubah ukuran semua bilah alat dalam aplikasi.

Secara default, kerangka kerja menampilkan ikon reguler.

Untuk informasi selengkapnya tentang kotak dialog Kustomisasi , lihat CMFCToolBarsCustomizeDialog Kelas.

CMFCToolBar::SetLockedSizes

Mengatur ukuran tombol terkunci dan gambar terkunci pada toolbar.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

Parameter

sizeButton
[di] Menentukan ukuran tombol bilah alat terkunci.

sizeImage
[di] Menentukan ukuran gambar bilah alat terkunci.

bDontScale
Menentukan apakah akan menskalakan atau tidak mengunci gambar toolbar dalam mode DPI tinggi.

Keterangan

Ukuran default tombol terkunci adalah 23x22 piksel. Ukuran default gambar terkunci adalah 16x15 piksel.

CMFCToolBar::GetLockedImageSize Panggil metode untuk mengambil ukuran gambar terkunci. CMFCToolBar::GetButtonSize Panggil metode untuk mengambil ukuran tombol toolbar terkunci.

CMFCToolBar::SetMaskMode

void SetMaskMode(BOOL bMasked);

Parameter

[in] bMasked\

Keterangan

CMFCToolBar::SetMenuSizes

Mengatur ukuran tombol menu toolbar dan gambarnya.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parameter

sizeButton
[di] Menentukan ukuran tombol toolbar, dalam piksel.

sizeImage
[di] Menentukan ukuran gambar toolbar, dalam piksel.

Keterangan

Secara default, tombol menu dan gambarnya memiliki ukuran yang tidak ditentukan.

CMFCToolBar::GetMenuButtonSize Panggil metode untuk menentukan ukuran tombol menu dan CMFCToolBar::GetMenuImageSize metode untuk menentukan ukuran gambar tombol menu.

Lihat sampel IEDemo dan MSMoneyDemo untuk contoh yang menggunakan metode ini.

CMFCToolBar::SetNonPermittedCommands

Mengatur daftar perintah yang tidak dapat dijalankan oleh pengguna.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

Parameter

lstCommands
[di] Referensi ke CList objek yang berisi perintah yang tidak dapat dijalankan oleh pengguna.

Keterangan

Panggil metode ini untuk mencegah pengguna memilih perintah tertentu. Misalnya, Anda mungkin ingin mencegah pengguna memilih perintah tertentu karena alasan keamanan. Lihat sampel MDITabsDemo dan MenuSubSet untuk contoh yang menggunakan metode ini.

Metode ini menghapus daftar perintah yang tidak diizinkan sebelumnya. Secara default, daftar perintah yang tidak diizinkan kosong.

CMFCToolBar::SetOneRowWithSibling

Memposisikan toolbar dan saudara kandungnya pada baris yang sama.

void SetOneRowWithSibling();

Keterangan

Kerangka kerja memanggil metode ini saat pengguna memilih tombol Perlihatkan Tombol pada Satu Baris .

CMFCToolBar::SetSiblingToolBar Panggil metode untuk mengaktifkan tombol Perlihatkan Tombol pada Satu Baris atau Perlihatkan Tombol pada Dua Baris. Jika Anda memanggil CMFCToolBar::SetSiblingToolBar bilah alat ini, bilah alat saudara dipindahkan ke baris bilah alat ini. Jika tidak, toolbar ini dipindahkan ke baris saudara kandung.

Kerangka kerja memanggil CMFCToolBar::SetTwoRowsWithSibling metode saat pengguna memilih tombol Perlihatkan Tombol pada Dua Baris .

CMFCToolBar::SetOrigButtons

void SetOrigButtons(const CObList& lstOrigButtons);

Parameter

[in] lstOrigButtons\

Keterangan

CMFCToolBar::SetPermament

Menentukan apakah pengguna dapat menutup bilah alat.

void SetPermament(BOOL bPermament=TRUE);

Parameter

bPermament
[di] Nilai Boolean yang menentukan apakah pengguna dapat menutup toolbar. Jika parameter ini adalah TRUE, pengguna tidak dapat menutup toolbar. Jika tidak, pengguna dapat menutup toolbar.

Keterangan

Secara default, pengguna dapat menutup setiap toolbar.

CMFCToolBar::CanBeClosed Panggil metode untuk menentukan apakah pengguna dapat menutup toolbar.

CMFCToolBar::SetRouteCommandsViaFrame

Menentukan apakah bingkai induk atau pemilik mengirim perintah ke bilah alat.

void SetRouteCommandsViaFrame(BOOL bValue);

Parameter

bValue
[di] Jika parameter ini adalah TRUE, bingkai induk mengirimkan perintah ke toolbar. Jika tidak, pemilik mengirim perintah ke toolbar.

Keterangan

Secara default, bingkai induk mengirim perintah ke toolbar. CMFCToolBar::GetRouteCommandsViaFrame Panggil metode untuk menentukan apakah bingkai induk atau pemilik mengirim perintah ke toolbar.

CMFCToolBar::SetShowTooltips

Menentukan apakah kerangka kerja menampilkan tips alat.

static void SetShowTooltips(BOOL bValue);

Parameter

bValue
[di] Jika parameter ini adalah TRUE, kerangka kerja menunjukkan tips alat. Jika tidak, kerangka kerja menyembunyikan tips alat.

Keterangan

Secara default, kerangka kerja menunjukkan tips alat.

CMFCToolBar::GetShowTooltips Panggil metode untuk menentukan apakah kerangka kerja menunjukkan tips alat.

CMFCToolBar::SetSiblingToolBar

Menentukan saudara dari bilah alat.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Parameter

pBrotherToolbar
[di] Penunjuk ke toolbar saudara.

Keterangan

Metode ini memungkinkan tombol Perlihatkan Tombol pada Satu Baris atau Perlihatkan Tombol pada Dua Baris yang ditampilkan saat pengguna menampilkan menu pop-up Kustomisasi . Panggil metode ini saat Anda ingin mengaktifkan pengguna untuk menentukan apakah toolbar terkait muncul pada baris yang sama atau pada baris yang berbeda.

Panggil metode ini setelah Anda mengaktifkan tombol Kustomisasi yang muncul pada toolbar. Untuk mengaktifkan tombol Kustomisasi , panggil CMFCToolBar::EnableCustomizeButton metode .

Untuk mengambil saudara dari toolbar, panggil CMFCToolBar::GetSiblingToolBar.

CMFCToolBar::SetSizes

Menentukan ukuran tombol dan gambar pada semua bilah alat.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parameter

sizeButton
[di] Ukuran tombol toolbar, dalam piksel.

sizeImage
[di] Ukuran gambar tombol toolbar, dalam piksel.

Keterangan

Ukuran default tombol toolbar adalah 23x22 piksel. Ukuran default gambar tombol toolbar adalah 16x15 piksel.

CMFCToolBar::GetImageSize Panggil metode untuk mengambil ukuran gambar tombol toolbar. CMFCToolBar::GetButtonSize Panggil metode untuk mengambil ukuran tombol toolbar.

CMFCToolBar::SetToolBarBtnText

Menentukan properti tombol pada bilah alat.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

Parameter

nBtnIndex
[di] Indeks berbasis nol tombol toolbar dalam daftar tombol toolbar.

szText
[di] Menentukan label teks tombol bilah alat.

bShowText
[di] Jika parameter ini adalah TRUE, kerangka kerja menunjukkan label teks. Jika tidak, kerangka kerja menyembunyikan label teks.

bShowImage
[di] Jika parameter ini adalah TRUE, kerangka kerja menunjukkan gambar tombol toolbar. Jika tidak, kerangka kerja menyembunyikan gambar tombol toolbar.

Keterangan

Secara default, kerangka kerja menunjukkan gambar tombol toolbar tetapi tidak menampilkan label teks tombol toolbar.

Dalam build Debug, metode ini menghasilkan kegagalan pernyataan jika nBtnIndex tidak merujuk ke tombol toolbar yang valid atau tombol toolbar adalah pemisah.

CMFCToolBar::SetTwoRowsWithSibling

Memposisikan toolbar dan saudara kandungnya pada baris terpisah.

void SetTwoRowsWithSibling();

Keterangan

Kerangka kerja memanggil metode ini saat pengguna memilih tombol Perlihatkan Tombol pada Dua Baris .

CMFCToolBar::SetSiblingToolBar Panggil metode untuk mengaktifkan tombol Perlihatkan Tombol pada Satu Baris atau Perlihatkan Tombol pada Dua Baris. Jika Anda memanggil CMFCToolBar::SetSiblingToolBar toolbar ini, toolbar saudara dipindahkan ke baris terpisah. Jika tidak, toolbar ini dipindahkan ke baris terpisah.

Kerangka kerja memanggil CMFCToolBar::SetOneRowWithSibling metode saat pengguna memilih tombol Perlihatkan Tombol pada Satu Baris .

CMFCToolBar::SetUserImages

Mengatur kumpulan gambar yang ditentukan pengguna dalam aplikasi.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Parameter

pUserImages
[di] Penunjuk ke kumpulan gambar yang ditentukan pengguna.

Tampilkan Nilai

Bukan nol jika metode berhasil; jika tidak, 0 jika objek yang ditentukan CMFCToolBarImages tidak valid atau memiliki ukuran gambar yang berbeda dari ukuran gambar default toolbar.

Keterangan

Kerangka kerja menggunakan gambar yang ditentukan pengguna untuk menggambar tombol toolbar yang disesuaikan oleh pengguna. Daftar gambar yang ditentukan oleh pUserImages dibagikan di antara semua toolbar dalam aplikasi.

Metode ini menghasilkan kegagalan pernyataan dalam build Debug jika objek yang ditentukan CMFCToolBarImages tidak valid atau memiliki ukuran gambar yang berbeda dari ukuran gambar default toolbar.

Sampel OutlookDemo, ToolTipDemo, dan VisualStudioDemo menggunakan metode ini untuk mengatur kumpulan global gambar yang ditentukan pengguna. Mereka memuat file yang diberi nama UserImages.bmp, yang terletak di direktori kerja aplikasi.

Panggil metode 'CMFCToolBar::GetUserImages untuk mengambil kumpulan gambar yang ditentukan pengguna dalam aplikasi.

CMFCToolBar::StretchPane

Membentangkan toolbar secara vertikal atau horizontal, dan memposisikan ulang tombol jika perlu.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parameter

nLength
[di] Jumlah, dalam piksel, untuk membentangkan panel.

bVert
[di] Jika TRUE, membentangkan panel secara vertikal. Jika FALSE, membentangkan panel secara horizontal.

Tampilkan Nilai

Objek CSize yang menentukan ukuran area klien toolbar.

Keterangan

Metode ini memanggil CMFCToolBar::WrapToolBar untuk memposisikan ulang tombol dalam toolbar yang direntangkan.

Nilai yang dikembalikan ditentukan dengan memanggil CMFCToolBar::CalcSize.

CMFCToolBar::TranslateChar

Menjalankan perintah tombol jika kode kunci yang ditentukan sesuai dengan pintasan keyboard yang valid.

virtual BOOL TranslateChar(UINT nChar);

Parameter

nChar
[di] Menentukan kode kunci virtual. Untuk daftar kode kunci virtual standar, lihat Winuser.h

Tampilkan Nilai

FALSE jika kode kunci yang ditentukan tidak dapat dicetak atau tidak sesuai dengan pintasan keyboard yang valid; TRUE jika kode kunci yang ditentukan sesuai dengan opsi menu drop-down; jika tidak, nilai pengembalian dari CMFCToolBar::ProcessCommand.

Keterangan

Kerangka kerja memanggil metode ini ketika tombol ditekan bersama dengan tombol Alt .

CMFCToolBar::UpdateButton

Memperbarui status tombol yang ditentukan.

void UpdateButton(int nIndex);

Parameter

nIndex
[di] Menentukan indeks berbasis nol tombol untuk diperbarui.

Keterangan

CMFCToolBar::WrapToolBar

Memposisikan ulang tombol toolbar dalam dimensi tertentu.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

Parameter

nWidth
[di] Lebar maksimum bilah alat.

nHeight
[di] Tinggi maksimum bilah alat. Tidak digunakan jika bilah alat mengambang.

pDC
[di] Penunjuk ke konteks perangkat. Jika NULL, konteks perangkat untuk toolbar digunakan.

nColumnWidth
[di] Lebar tombol. Jika -1, lebar saat ini digunakan.

[di] m nRowHeight Tinggi tombol. Jika -1, tinggi saat ini digunakan.

Tampilkan Nilai

Jumlah baris tombol pada toolbar.

Keterangan

Metode ini memposisikan ulang tombol dalam toolbar, membungkus tombol ke baris tambahan jika perlu.

CMFCToolBar::m_bDontScaleImages

Menentukan apakah akan menskalakan gambar toolbar dalam mode DPI tinggi atau tidak. Atur ke TRUE untuk mencegah penskalakan gambar saat ukuran gambar tidak cocok dengan ukuran tombol.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Lihat juga

Bagan Hierarki
Kelas
CMFCMenuBar Kelas
CMFCPopupMenuBar Kelas
CMFCDropDownToolBar Kelas
Panduan: Menempatkan Kontrol Pada Toolbar