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:
CMFCToolBar
Tambahkan objek ke jendela bingkai utama.Saat Anda memproses pesan WM_CREATE untuk jendela bingkai utama, panggil atau
CMFCToolBar::Create
CMFCToolBar::CreateEx
untuk membuat toolbar dan tentukan gayanya.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.
CMFCToolBar
adalah 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
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