Bagikan melalui

Kelas CMFCToolBarsCustomizeDialog

Kotak dialog tab modeless ( Kelas CPropertySheet) yang memungkinkan pengguna menyesuaikan toolbar, menu, pintasan keyboard, alat yang ditentukan pengguna, dan gaya visual dalam aplikasi. Biasanya, pengguna mengakses kotak dialog ini dengan memilih Kustomisasi dari menu Alat .

Kotak dialog Kustomisasi memiliki enam tab: Perintah, Toolbar, Alat, Keyboard, Menu, dan Opsi.

Sintaks

class CMFCToolBarsCustomizeDialog : public CPropertySheet

Anggota

Konstruktor Publik

Nama Deskripsi
CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog Membuat CMFCToolBarsCustomizeDialog objek.
CMFCToolBarsCustomizeDialog::~CMFCToolBarsCustomizeDialog Destruktor.

Metode Publik

Nama Deskripsi
CMFCToolBarsCustomizeDialog::AddButton Menyisipkan tombol toolbar ke dalam daftar perintah pada halaman Perintah
CMFCToolBarsCustomizeDialog::AddMenu Memuat menu dari sumber daya dan memanggil CMFCToolBarsCustomizeDialog::AddMenuCommands untuk menambahkan menu tersebut ke daftar perintah di halaman Perintah .
CMFCToolBarsCustomizeDialog::AddMenuCommands Memuat menu dari sumber daya dan memanggil CMFCToolBarsCustomizeDialog::AddMenuCommands untuk menambahkan menu tersebut ke daftar perintah di halaman Perintah .
CMFCToolBarsCustomizeDialog::AddToolBar Memuat toolbar dari sumber daya. Kemudian, untuk setiap perintah di menu memanggil metode CMFCToolBarsCustomizeDialog::AddButton untuk menyisipkan tombol dalam daftar perintah pada halaman Perintah di bawah kategori yang ditentukan.
CMFCToolBarsCustomizeDialog::Create Menampilkan kotak dialog Kustomisasi .
CMFCToolBarsCustomizeDialog::EnableTools Disiapkan untuk penggunaan masa mendatang.
CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars Mengaktifkan atau menonaktifkan pembuatan bilah alat baru dengan menggunakan kotak dialog Kustomisasi .
CMFCToolBarsCustomizeDialog::FillAllCommandsList Mengisi objek yang disediakan CListBox dengan perintah dalam kategori Semua Perintah .
CMFCToolBarsCustomizeDialog::FillCategoriesComboBox Mengisi objek yang disediakan CComboBox dengan nama setiap kategori perintah dalam kotak dialog Kustomisasi .
CMFCToolBarsCustomizeDialog::FillCategoriesListBox Mengisi objek yang disediakan CListBox dengan nama setiap kategori perintah dalam kotak dialog Kustomisasi .
CMFCToolBarsCustomizeDialog::GetCommandName Mengambil nama yang terkait dengan ID perintah yang diberikan.
CMFCToolBarsCustomizeDialog::GetCountInCategory Mengambil jumlah item dalam daftar yang disediakan yang memiliki label teks tertentu.
CMFCToolBarsCustomizeDialog::GetFlags Mengambil kumpulan bendera yang memengaruhi perilaku kotak dialog.
CMFCToolBarsCustomizeDialog::GetThisClass Digunakan oleh kerangka kerja untuk mendapatkan penunjuk ke objek CRuntimeClass yang terkait dengan jenis kelas ini.
CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage Memulai editor gambar sehingga pengguna dapat menyesuaikan tombol toolbar atau ikon item menu.
CMFCToolBarsCustomizeDialog::OnInitDialog Mengambil alih untuk menambah inisialisasi lembar properti. (Penimpaan CPropertySheet::OnInitDialog.)
CMFCToolBarsCustomizeDialog::P ostNcDestroy Dipanggil oleh kerangka kerja setelah jendela dihancurkan. (Mengambil alih CPropertySheet::PostNcDestroy.)
CMFCToolBarsCustomizeDialog::RemoveButton Menghapus tombol dengan ID perintah yang ditentukan dari kategori yang ditentukan, atau dari semua kategori.
CMFCToolBarsCustomizeDialog::RenameCategory Mengganti nama kategori dalam kotak daftar kategori pada tab Perintah .
CMFCToolBarsCustomizeDialog::ReplaceButton Mengganti tombol dalam daftar perintah pada tab Perintah dengan objek tombol toolbar baru.
CMFCToolBarsCustomizeDialog::SetUserCategory Menambahkan kategori ke daftar kategori yang akan ditampilkan pada tab Perintah .

Metode yang Dilindungi

Nama Deskripsi
CMFCToolBarsCustomizeDialog::CheckToolsValidity Dipanggil oleh kerangka kerja untuk menentukan apakah daftar alat yang ditentukan pengguna valid.
CMFCToolBarsCustomizeDialog::OnAfterChangeTool Dipanggil oleh kerangka kerja saat properti alat yang ditentukan pengguna berubah.
CMFCToolBarsCustomizeDialog::OnAssignKey Menentukan apakah pintasan keyboard tertentu dapat ditetapkan ke tindakan.
CMFCToolBarsCustomizeDialog::OnBeforeChangeTool Menentukan apakah alat yang ditentukan pengguna dapat diubah.
CMFCToolBarsCustomizeDialog::OnInitToolsPage Dipanggil oleh kerangka kerja saat pengguna memilih tab Alat diminta.

Keterangan

Untuk menampilkan kotak dialog Kustomisasi , buat CMFCToolBarsCustomizeDialog objek dan panggil metode CMFCToolBarsCustomizeDialog::Create .

Saat kotak dialog Kustomisasi aktif, aplikasi berfungsi dalam mode khusus yang membatasi pengguna untuk tugas kustomisasi.

Contoh

Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCToolBarsCustomizeDialog kelas . Contoh memperlihatkan cara mengganti tombol toolbar di kotak daftar perintah pada halaman Perintah , mengaktifkan pembuatan toolbar baru dengan menggunakan kotak dialog Kustomisasi , dan menampilkan kotak dialog Kustomisasi . Cuplikan kode ini adalah bagian dari sampel Demo IE.

pDlgCust->ReplaceButton(ID_FAVORITS_DUMMY,
                        CMFCToolBarMenuButton((UINT)-1, menuFavorites, -1, strFavorites));
pDlgCust->EnableUserDefinedToolbars();
pDlgCust->Create();

Hierarki Warisan

CObject

CCmdTarget

CWnd

CPropertySheet

CMFCToolBarsCustomizeDialog

Persyaratan

Header: afxToolBarsCustomizeDialog.h

CMFCToolBarsCustomizeDialog::AddButton

Menyisipkan tombol bilah alat ke dalam daftar perintah pada halaman Perintah .

void AddButton(
    UINT uiCategoryId,
    const CMFCToolBarButton& button,
    int iInsertBefore=-1);

void AddButton(
    LPCTSTR lpszCategory,
    const CMFCToolBarButton& button,
    int iInsertBefore=-1);

Parameter

uiCategoryId
[di] Menentukan ID kategori untuk menyisipkan tombol.

kancing
[di] Menentukan tombol untuk disisipkan.

iInsertBefore
[di] Menentukan indeks berbasis nol tombol toolbar sebelum tombol disisipkan.

lpszCategory
[di] Menentukan string kategori untuk menyisipkan tombol.

Keterangan

Metode mengabaikan AddButton tombol yang memiliki ID perintah standar (seperti ID_FILE_MRU_FILE1), perintah yang tidak diizinkan (lihat CMFCToolBar::IsCommandPermitted) dan tombol dummy.

Metode ini membuat objek baru dengan jenis yang sama dengan button (biasanya CMFCToolBarButton Class) dengan menggunakan kelas runtime tombol. Kemudian memanggil CMFCToolBarButton::CopyFrom untuk menyalin anggota data tombol, dan menyisipkan salinan ke dalam kategori yang ditentukan.

Saat tombol baru disisipkan, tombol menerima OnAddToCustomizePage pemberitahuan.

Jika iInsertBefore adalah -1, tombol ditambahkan ke daftar kategori; jika tidak, tombol tersebut disisipkan sebelum item dengan indeks yang ditentukan.

Contoh

Contoh berikut menunjukkan cara menggunakan AddButton metode CMFCToolBarsCustomizeDialog kelas. Cuplikan kode ini adalah bagian dari sampel Slider.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scanning */);

CSliderButton btnSlider(ID_SLIDER);
btnSlider.SetRange(0, 100);

pDlgCust->AddButton(_T("Edit"), btnSlider);

CMFCToolBarsCustomizeDialog::AddMenu

Memuat menu dari sumber daya dan memanggil CMFCToolBarsCustomizeDialog::AddMenuCommands untuk menambahkan menu tersebut ke daftar perintah di halaman Perintah .

BOOL AddMenu(UINT uiMenuResId);

Parameter

uiMenuResId
[di] Menentukan ID sumber daya menu yang akan dimuat.

Tampilkan Nilai

TRUE jika menu berhasil ditambahkan; jika tidak FALSE.

Keterangan

Dalam panggilan ke AddMenuCommands, bPopup adalah FALSE. Akibatnya, metode tersebut tidak menambahkan item menu yang berisi submenu ke daftar perintah. Metode ini menambahkan item menu di submenu ke daftar perintah.

CMFCToolBarsCustomizeDialog::AddMenuCommands

Menambahkan item ke daftar perintah di halaman Perintah untuk mewakili semua item di menu yang ditentukan.

void AddMenuCommands(
    const CMenu* pMenu,
    BOOL bPopup,
    LPCTSTR lpszCategory=NULL,
    LPCTSTR lpszMenuPath=NULL);

Parameter

pMenu
[di] Penunjuk ke objek CMenu untuk ditambahkan.

bPopup
[di] Menentukan apakah akan menyisipkan item menu popup ke daftar perintah.

lpszCategory
[di] Nama kategori untuk menyisipkan menu.

lpszMenuPath
[di] Awalan yang ditambahkan ke nama saat perintah ditampilkan di daftar Semua Kategori .

Keterangan

Metode mengulangi AddMenuCommands semua item menu pMenu. Untuk setiap item menu yang tidak berisi submenu, metode ini membuat objek KELAS CMFCToolBarButton dan memanggil metode CMFCToolBarsCustomizeDialog::AddButton untuk menambahkan item menu sebagai tombol toolbar ke daftar perintah pada halaman Perintah. Pemisah diabaikan dalam proses ini.

Jika bPopup TRUE, untuk setiap item menu yang berisi submenu metode ini membuat objek Kelas CMFCToolBarMenuButton dan menyisipkannya ke dalam daftar perintah dengan memanggil AddButton. Jika tidak, item menu yang berisi submenu tidak ditampilkan dalam daftar perintah. Dalam kedua kasus, ketika AddMenuCommands menemukan item menu dengan submenu yang disebutnya sendiri secara rekursif, meneruskan penunjuk ke submenu sebagai parameter pMenu dan menambahkan label submenu ke lpszMenuPath.

CMFCToolBarsCustomizeDialog::AddToolBar

Memuat toolbar dari sumber daya. Kemudian, untuk setiap perintah di menu memanggil metode CMFCToolBarsCustomizeDialog::AddButton untuk menyisipkan tombol dalam daftar perintah pada halaman Perintah di bawah kategori yang ditentukan.

BOOL AddToolBar(
    UINT uiCategoryId,
    UINT uiToolbarResId);

BOOL AddToolBar(
    LPCTSTR lpszCategory,
    UINT uiToolbarResId);

Parameter

uiCategoryId
[di] Menentukan ID sumber daya kategori untuk menambahkan bilah alat.

uiToolbarResId
[di] Menentukan ID sumber daya toolbar yang perintahnya disisipkan ke dalam daftar perintah.

lpszCategory
[di] Menentukan nama kategori untuk menambahkan bilah alat.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

Contoh

Contoh berikut menunjukkan cara menggunakan AddToolBar metode di CMFCToolBarsCustomizeDialog kelas . Cuplikan kode ini adalah bagian dari sampel Word Pad.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scanning */,
                                                                        AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS |
                                                                            AFX_CUSTOMIZE_MENU_ANIMATIONS);

pDlgCust->AddToolBar(_T("Format"), IDR_FORMATBAR);

Keterangan

Kontrol yang digunakan untuk mewakili setiap perintah adalah objek Kelas CMFCToolBarButton. Setelah menambahkan toolbar, Anda dapat mengganti tombol dengan kontrol jenis turunan dengan memanggil CMFCToolBarsCustomizeDialog::ReplaceButton.

CMFCToolBarsCustomizeDialog::CheckToolsValidity

Memverifikasi validitas daftar alat pengguna.

virtual BOOL CheckToolsValidity(const CObList& lstTools);

Parameter

lstTools
[di] Daftar alat yang ditentukan pengguna untuk diperiksa.

Tampilkan Nilai

Mengembalikan TRUE jika daftar alat yang ditentukan pengguna valid; jika tidak FALSE. Implementasi default selalu mengembalikan TRUE.

Keterangan

Kerangka kerja memanggil metode ini untuk memverifikasi validitas objek yang mewakili alat yang ditentukan pengguna yang dikembalikan oleh CMFCToolBarsCustomizeDialog::CheckToolsValidity.

Ambil alih CheckToolsValidity metode di kelas yang berasal dari CMFCToolBarsCustomizeDialog jika Anda ingin memvalidasi alat pengguna sebelum pengguna menutup kotak dialog. Jika metode ini mengembalikan FALSE saat pengguna mengklik tombol Tutup di sudut kanan atas kotak dialog atau tombol berlabel Tutup di sudut kanan bawah kotak dialog, kotak dialog menampilkan tab Alat alih-alih menutup. Jika metode ini mengembalikan FALSE saat pengguna mengklik tab untuk menavigasi menjauh dari tab Alat , navigasi tidak terjadi. Anda harus menampilkan kotak pesan yang sesuai untuk memberi tahu pengguna tentang masalah yang menyebabkan validasi gagal.

CMFCToolBarsCustomizeDialog::CMFCToolBarsCustomizeDialog

Membuat CMFCToolBarsCustomizeDialog objek.

CMFCToolBarsCustomizeDialog(
    CFrameWnd* pWndParentFrame,
    BOOL bAutoSetFromMenus = FALSE,
    UINT uiFlags = (AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | AFX_CUSTOMIZE_MENU_ANIMATIONS | AFX_CUSTOMIZE_NOHELP),
    CList <CRuntimeClass*, CRuntimeClass*>* p listCustomPages = NULL);

Parameter

pWndParentFrame
[di] Penunjuk ke bingkai induk. Parameter ini tidak boleh NULL.

bAutoSetFromMenus
[di] Nilai Boolean yang menentukan apakah akan menambahkan perintah menu dari semua menu ke daftar perintah di halaman Perintah . Jika parameter ini TRUE, perintah menu ditambahkan. Jika tidak, perintah menu tidak ditambahkan.

uiFlags
[di] Kombinasi bendera yang memengaruhi perilaku kotak dialog. Parameter ini bisa berupa satu atau beberapa nilai berikut:

  • AFX_CUSTOMIZE_MENU_SHADOWS

  • AFX_CUSTOMIZE_TEXT_LABELS

  • AFX_CUSTOMIZE_MENU_ANIMATIONS

  • AFX_CUSTOMIZE_NOHELP

  • AFX_CUSTOMIZE_CONTEXT_HELP

  • AFX_CUSTOMIZE_NOTOOLS

  • AFX_CUSTOMIZE_MENUAMPERS

  • AFX_CUSTOMIZE_NO_LARGE_ICONS

plistCustomPages
[di] Penunjuk ke daftar CRuntimeClass objek yang menentukan halaman kustom tambahan.

Keterangan

Parameter plistCustomPages mengacu pada daftar CRuntimeClass objek yang menentukan halaman kustom tambahan. Konstruktor menambahkan lebih banyak halaman ke kotak dialog dengan menggunakan metode CRuntimeClass::CreateObject . Lihat sampel CustomPages untuk contoh yang menambahkan lebih banyak halaman ke kotak dialog Kustomisasi .

Untuk informasi selengkapnya tentang nilai yang dapat Anda berikan di parameter uiFlags , lihat CMFCToolBarsCustomizeDialog::GetFlags.

Contoh

Contoh berikut menunjukkan cara membuat objek CMFCToolBarsCustomizeDialog kelas. Cuplikan kode ini adalah bagian dari sampel Halaman Kustom.

CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this,
                                                                        TRUE /* Automatic menus scanning */,
                                                                        AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS |
                                                                            AFX_CUSTOMIZE_MENU_ANIMATIONS, // default parameters
                                                                        &lstCustomPages);                  // pointer to the list of runtime classes of the custom property pages

CMFCToolBarsCustomizeDialog::Create

Menampilkan kotak dialog Kustomisasi .

virtual BOOL Create();

Tampilkan Nilai

TRUE jika lembar properti kustomisasi berhasil dibuat; jika tidak FALSE.

Keterangan

Create Panggil metode hanya setelah Anda menginisialisasi kelas sepenuhnya.

CMFCToolBarsCustomizeDialog::EnableUserDefinedToolbars

Mengaktifkan atau menonaktifkan pembuatan bilah alat baru dengan menggunakan kotak dialog Kustomisasi .

void EnableUserDefinedToolbars(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan toolbar yang ditentukan pengguna; FALSE untuk menonaktifkan bilah alat.

Keterangan

Jika bEnable TRUE, tombol Baru, Ganti Nama, dan Hapus ditampilkan di halaman Toolbar.

Secara default, atau jika bEnable FALSE, tombol ini tidak ditampilkan dan pengguna tidak dapat menentukan toolbar baru.

CMFCToolBarsCustomizeDialog::FillAllCommandsList

Mengisi objek yang disediakan CListBox dengan perintah dalam kategori Semua Perintah .

virtual void FillAllCommandsList(CListBox& wndListOfCommands) const;

Parameter

wndListOfCommands
[out] Referensi ke CListBox objek untuk diisi.

Keterangan

Kategori Semua Perintah berisi perintah semua kategori. Metode CMFCToolBarsCustomizeDialog::AddButton menambahkan perintah yang terkait dengan tombol yang disediakan ke kategori Semua Perintah untuk Anda.

Metode ini menghapus konten objek yang disediakan CListBox sebelum mengisinya dengan perintah dalam kategori Semua Perintah .

Kelas CMFCMousePropertyPage menggunakan metode ini untuk mengisi kotak daftar peristiwa klik ganda.

CMFCToolBarsCustomizeDialog::FillCategoriesComboBox

Mengisi objek yang disediakan CComboBox dengan nama setiap kategori perintah dalam kotak dialog Kustomisasi .

void FillCategoriesComboBox(
    CComboBox& wndCategory,
    BOOL bAddEmpty = TRUE) const;

Parameter

wndCategory
[out] Referensi ke CComboBox objek untuk diisi.

bAddEmpty
[di] Nilai Boolean yang menentukan apakah akan menambahkan kategori ke kotak kombo yang tidak memiliki perintah. Jika parameter ini TRUE, kategori kosong ditambahkan ke kotak kombo. Jika tidak, kategori kosong tidak ditambahkan.

Keterangan

Metode ini seperti metode CMFCToolBarsCustomizeDialog::FillCategoriesListBox kecuali metode ini berfungsi dengan CComboBox objek.

Metode ini tidak menghapus isi CComboBox objek sebelum mengisinya. Ini menjamin bahwa kategori Semua Perintah adalah item akhir dalam kotak kombo.

Anda dapat menambahkan kategori perintah baru dengan menggunakan metode CMFCToolBarsCustomizeDialog::AddButton . Anda dapat mengubah nama kategori yang ada dengan menggunakan metode CMFCToolBarsCustomizeDialog::RenameCategory .

Kelas CMFCToolBarsKeyboardPropertyPage dan CMFCKeyMapDialog menggunakan metode ini untuk mengategorikan pemetaan keyboard.

CMFCToolBarsCustomizeDialog::FillCategoriesListBox

Mengisi objek yang disediakan CListBox dengan nama setiap kategori perintah dalam kotak dialog Kustomisasi .

void FillCategoriesListBox(
    CListBox& wndCategory,
    BOOL bAddEmpty = TRUE) const;

Parameter

wndCategory
[out] Referensi ke CListBox objek untuk diisi.

bAddEmpty
[di] Nilai Boolean yang menentukan apakah akan menambahkan kategori ke kotak daftar yang tidak memiliki perintah. Jika parameter ini TRUE, kategori kosong ditambahkan ke kotak daftar. Jika tidak, kategori kosong tidak ditambahkan.

Keterangan

Metode ini seperti metode CMFCToolBarsCustomizeDialog::FillCategoriesComboBox kecuali metode ini berfungsi dengan CListBox objek.

Metode ini tidak menghapus isi CListBox objek sebelum mengisinya. Ini menjamin bahwa kategori Semua Perintah adalah item akhir dalam kotak daftar.

Anda dapat menambahkan kategori perintah baru dengan menggunakan metode CMFCToolBarsCustomizeDialog::AddButton . Anda dapat mengubah nama kategori yang ada dengan menggunakan metode CMFCToolBarsCustomizeDialog::RenameCategory .

Kelas CMFCToolBarsCommandsPropertyPage menggunakan metode ini untuk menampilkan daftar perintah yang terkait dengan setiap kategori perintah.

CMFCToolBarsCustomizeDialog::GetCommandName

Mengambil nama yang terkait dengan ID perintah yang diberikan.

LPCTSTR GetCommandName(UINT uiCmd) const;

Parameter

uiCmd
[di] ID perintah yang akan diambil.

Tampilkan Nilai

Nama yang terkait dengan ID perintah yang diberikan, atau NULL jika perintah tidak ada.

CMFCToolBarsCustomizeDialog::GetCountInCategory

Mengambil jumlah item dalam daftar yang disediakan yang memiliki label teks tertentu.

int GetCountInCategory(
    LPCTSTR lpszItemName,
    const CObList& lstCommands) const;

Parameter

lpszItemName
[di] Label teks yang cocok.

lstCommands
[di] Referensi ke daftar yang berisi CMFCToolBarButton objek.

Tampilkan Nilai

Jumlah item dalam daftar yang disediakan yang label teksnya sama dengan lpszItemName.

Keterangan

Setiap elemen dalam daftar objek yang disediakan harus berjenis CMFCToolBarButton. Metode ini membandingkan lpszItemName dengan anggota data CMFCToolBarButton::m_strText .

CMFCToolBarsCustomizeDialog::GetFlags

Mengambil kumpulan bendera yang memengaruhi perilaku kotak dialog.

UINT GetFlags() const;

Tampilkan Nilai

Kumpulan bendera yang memengaruhi perilaku kotak dialog.

Keterangan

Metode ini mengambil nilai parameter uiFlags yang diteruskan ke konstruktor. Nilai yang dikembalikan bisa berupa satu atau beberapa nilai berikut:

Nama Deskripsi
AFX_CUSTOMIZE_MENU_SHADOWS Memungkinkan pengguna menentukan tampilan bayangan menu.
AFX_CUSTOMIZE_TEXT_LABELS Memungkinkan pengguna menentukan apakah label teks ditampilkan di bawah gambar tombol toolbar.
AFX_CUSTOMIZE_MENU_ANIMATIONS Memungkinkan pengguna menentukan gaya animasi menu.
AFX_CUSTOMIZE_NOHELP Menghapus tombol bantuan dari kotak dialog kustomisasi.
AFX_CUSTOMIZE_CONTEXT_HELP Mengaktifkan gaya visual WS_EX_CONTEXTHELP.
AFX_CUSTOMIZE_NOTOOLS Menghapus halaman Alat dari kotak dialog kustomisasi. Bendera ini valid jika aplikasi Anda menggunakan CUserToolsManager kelas .
AFX_CUSTOMIZE_MENUAMPERS Memungkinkan keterangan tombol berisi karakter ampersand ( &) .
AFX_CUSTOMIZE_NO_LARGE_ICONS Menghapus opsi Ikon Besar dari kotak dialog kustomisasi.

Untuk informasi selengkapnya tentang gaya visual WS_EX_CONTEXTHELP, lihat Gaya Jendela yang Diperluas.

CMFCToolBarsCustomizeDialog::OnAfterChangeTool

Menanggapi perubahan alat pengguna segera setelah terjadi.

virtual void OnAfterChangeTool(CUserTool* pSelTool);

Parameter

pSelTool
[masuk, keluar] Penunjuk ke objek alat pengguna yang telah diubah.

Keterangan

Metode ini dipanggil oleh kerangka kerja ketika pengguna mengubah properti alat yang ditentukan pengguna. Implementasi default tidak melakukan apa pun. Ambil alih metode ini di kelas yang berasal dari CMFCToolBarsCustomizeDialog untuk melakukan pemrosesan setelah perubahan pada alat pengguna terjadi.

CMFCToolBarsCustomizeDialog::OnAssignKey

Memvalidasi pintasan keyboard saat pengguna mendefinisikannya.

virtual BOOL OnAssignKey(ACCEL* pAccel);

Parameter

pAccel
[masuk, keluar] Penunjuk ke penugasan keyboard yang diusulkan yang dinyatakan sebagai struktur ACCEL .

Tampilkan Nilai

TRUE jika kunci dapat ditetapkan, atau FALSE jika kunci tidak dapat ditetapkan. Implementasi default selalu mengembalikan TRUE.

Keterangan

Ambil alih metode ini di kelas turunan untuk melakukan pemrosesan ekstra saat pengguna menetapkan pintasan keyboard baru, atau untuk memvalidasi pintasan keyboard saat pengguna mendefinisikannya. Untuk mencegah pintasan ditetapkan, kembalikan FALSE. Anda juga harus menampilkan kotak pesan atau memberi tahu pengguna alasan mengapa pintasan keyboard ditolak.

CMFCToolBarsCustomizeDialog::OnBeforeChangeTool

Melakukan pemrosesan kustom saat perubahan pada alat pengguna saat pengguna akan menerapkan perubahan.

virtual void OnBeforeChangeTool(CUserTool* pSelTool);

Parameter

pSelTool
[masuk, keluar] Penunjuk ke objek alat pengguna yang akan diganti.

Keterangan

Metode ini dipanggil oleh kerangka kerja ketika properti alat yang ditentukan pengguna akan berubah. Implementasi default tidak melakukan apa pun. Ambil alih OnBeforeChangeTool metode di kelas yang berasal dari CMFCToolBarsCustomizeDialog jika Anda ingin melakukan pemrosesan sebelum perubahan pada alat pengguna terjadi, seperti merilis sumber daya yang digunakan pSelTool .

CMFCToolBarsCustomizeDialog::OnEditToolbarMenuImage

Memulai editor gambar sehingga pengguna dapat menyesuaikan tombol toolbar atau ikon item menu.

virtual BOOL OnEditToolbarMenuImage(
    CWnd* pWndParent,
    CBitmap& bitmap,
    int nBitsPerPixel);

Parameter

pWndParent
[di] Penunjuk ke jendela induk.

Bitmap
[di] Referensi ke objek bitmap yang akan diedit.

nBitsPerPixel
[di] Resolusi warna bitmap, dalam bit per piksel.

Tampilkan Nilai

TRUE jika perubahan sedang dilakukan; jika tidak FALSE. Implementasi default menampilkan kotak dialog dan mengembalikan TRUE jika pengguna mengklik OK, atau FALSE jika pengguna mengklik Batal atau tombol Tutup .

Keterangan

Metode ini dipanggil oleh kerangka kerja ketika pengguna menjalankan editor gambar. Implementasi default menampilkan kotak dialog Kelas CMFCImageEditorDialog. Ambil alih OnEditToolbarMenuImage di kelas turunan untuk menggunakan editor gambar kustom.

CMFCToolBarsCustomizeDialog::OnInitDialog

Mengambil alih untuk menambah inisialisasi lembar properti.

virtual BOOL OnInitDialog();

Tampilkan Nilai

Hasil dari memanggil metode CPropertySheet::OnInitDialog .

Keterangan

Metode ini memperluas implementasi kelas dasar, CPropertySheet::OnInitDialog, dengan menampilkan tombol Tutup , dengan memastikan bahwa kotak dialog sesuai dengan ukuran layar saat ini, dan dengan memindahkan tombol Bantuan ke sudut kiri bawah kotak dialog.

CMFCToolBarsCustomizeDialog::OnInitToolsPage

Menangani pemberitahuan dari kerangka kerja bahwa halaman Alat akan diinisialisasi.

virtual void OnInitToolsPage();

Keterangan

Implementasi default tidak melakukan apa pun. Ambil alih metode ini dalam kelas turunan untuk memproses pemberitahuan ini.

CMFCToolBarsCustomizeDialog::P ostNcDestroy

Dipanggil oleh kerangka kerja setelah jendela dihancurkan.

virtual void PostNcDestroy();

Keterangan

Metode ini memperluas implementasi kelas dasar, CPropertySheet::PostNcDestroy, dengan memulihkan aplikasi ke mode sebelumnya.

Metode CMFCToolBarsCustomizeDialog::Create menempatkan aplikasi dalam mode khusus yang membatasi pengguna untuk tugas kustomisasi.

CMFCToolBarsCustomizeDialog::RemoveButton

Menghapus tombol dengan ID perintah yang ditentukan dari kategori yang ditentukan, atau dari semua kategori.

int RemoveButton(
    UINT uiCategoryId,
    UINT uiCmdId);

int RemoveButton(
    LPCTSTR lpszCategory,
    UINT uiCmdId);

Parameter

uiCategoryId
[di] Menentukan ID kategori untuk menghapus tombol.

uiCmdId
[di] Menentukan ID perintah tombol.

lpszCategory
[di] Menentukan nama kategori untuk menghapus tombol.

Tampilkan Nilai

Indeks berbasis nol dari tombol yang dihapus, atau -1 jika ID perintah yang ditentukan tidak ditemukan dalam kategori yang ditentukan. Jika uiCategoryId adalah -1, nilai yang dikembalikan adalah 0.

Keterangan

Untuk menghapus tombol dari semua kategori, panggil kelebihan beban pertama metode ini dan atur uiCategoryId ke -1.

CMFCToolBarsCustomizeDialog::RenameCategory

Mengganti nama kategori dalam kotak daftar kategori di halaman Perintah .

BOOL RenameCategory(
    LPCTSTR lpszCategoryOld,
    LPCTSTR lpszCategoryNew);

Parameter

lpszCategoryOld
[di] Nama kategori yang akan diubah.

lpszCategoryNew
[di] Nama kategori baru.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

Keterangan

Nama kategori harus unik.

CMFCToolBarsCustomizeDialog::ReplaceButton

Mengganti tombol toolbar di kotak daftar perintah pada halaman Perintah .

void ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button);

Parameter

uiCmd
[di] Menentukan perintah tombol yang akan diganti.

kancing
[di] Referensi const ke objek tombol toolbar yang menggantikan tombol lama.

Keterangan

Ketika CMFCToolBarsCustomizeDialog::AddMenu, CMFCToolBarsCustomizeDialog::AddMenuCommands, atau CMFCToolBarsCustomizeDialog::AddToolBar menambahkan perintah ke halaman Perintah, perintah tersebut dalam bentuk objek KELAS CMFCToolBarButton (atau objek Kelas CMFCToolBarMenuButton untuk item menu yang berisi submenu yang ditambahkan oleh AddMenuCommands). Kerangka kerja ini juga memanggil ketiga metode ini untuk menambahkan perintah secara otomatis. Jika Anda ingin perintah diwakili oleh jenis turunan sebagai gantinya, panggil ReplaceButton dan teruskan tombol dari jenis turunan.

Contoh

Contoh berikut menunjukkan cara menggunakan ReplaceButton metode di CMFCToolBarsCustomizeDialog kelas . Cuplikan kode ini adalah bagian dari sampel Demo Visual Studio.

// CMFCToolBarsCustomizeDialog* pDlgCust
     // CMFCToolBarComboBoxButton comboButtonConfig
     pDlgCust->ReplaceButton(ID_DUMMY_SELECT_ACTIVE_CONFIGURATION, comboButtonConfig);

CMFCToolBarsCustomizeDialog::SetUserCategory

Menentukan kategori mana dalam daftar kategori pada halaman Perintah adalah kategori pengguna. Anda harus memanggil fungsi ini sebelum memanggil CMFCToolBarsCustomizeDialog::Create.

BOOL SetUserCategory(LPCTSTR lpszCategory);

Parameter

lpszCategory
[di] Nama kategori.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

Keterangan

Pengaturan kategori pengguna saat ini tidak digunakan oleh kerangka kerja.

Lihat juga

Bagan Hierarki
Kelas
Kelas CPropertySheet

  • Last updated on