Bagikan melalui


Kelas CMFCToolBarComboBoxButton

Tombol toolbar yang berisi kontrol kotak kombo ( Kelas CComboBox).

Sintaks

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

Anggota

Konstruktor Publik

Nama Deskripsi
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton Membangun sebuah CMFCToolBarComboBoxButton.

Metode Publik

Nama Deskripsi
CMFCToolBarComboBoxButton::AddItem Menambahkan item ke akhir daftar kotak kombo.
CMFCToolBarComboBoxButton::AddSortedItem Menambahkan item ke daftar kotak kombo. Urutan item dalam daftar ditentukan oleh Compare.
CMFCToolBarComboBoxButton::Compare Membandingkan dua item. Dipanggil untuk mengurutkan item yang AddSortedItems ditambahkan ke daftar kotak kombo.
CMFCToolBarComboBoxButton::CreateEdit Membuat kontrol edit baru untuk tombol kotak kombo.
CMFCToolBarComboBoxButton::D eleteItem Menghapus item dari daftar kotak kombo.
CMFCToolBarComboBoxButton::FindItem Mengembalikan indeks item yang berisi string tertentu.
CMFCToolBarComboBoxButton::GetByCmd Mengembalikan penunjuk ke tombol kotak kombo dengan ID perintah tertentu.
CMFCToolBarComboBoxButton::GetComboBox Mengembalikan penunjuk ke kontrol kotak kombo yang disematkan di tombol kotak kombo.
CMFCToolBarComboBoxButton::GetCount Mengembalikan jumlah item dalam daftar kotak kombo.
CMFCToolBarComboBoxButton::GetCountAll Menemukan tombol kotak kombo yang memiliki ID perintah tertentu. Mengembalikan jumlah item dalam daftar kotak kombo tombol tersebut.
CMFCToolBarComboBoxButton::GetcurSel Mengembalikan indeks item yang dipilih dalam daftar kotak kombo.
CMFCToolBarComboBoxButton::GetCurSelAll Menemukan tombol kotak kombo yang memiliki ID perintah tertentu, dan mengembalikan indeks item yang dipilih dalam daftar kotak kombo tombol tersebut.
CMFCToolBarComboBoxButton::GetEditctrl Mengembalikan penunjuk ke kontrol edit yang disematkan di tombol kotak kombo.
CMFCToolBarComboBoxButton::GetItem Mengembalikan string yang terkait dengan indeks tertentu dalam daftar kotak kombo.
CMFCToolBarComboBoxButton::GetItemAll Menemukan tombol kotak kombo yang memiliki ID perintah tertentu, dan mengembalikan string yang terkait dengan indeks dalam daftar kotak kombo tombol tersebut.
CMFCToolBarComboBoxButton::GetItemData Mengembalikan nilai 32-bit yang terkait dengan indeks tertentu dalam daftar kotak kombo.
CMFCToolBarComboBoxButton::GetItemDataAll Menemukan tombol kotak kombo yang memiliki ID perintah tertentu, dan mengembalikan nilai 32-bit yang terkait dengan indeks dalam daftar kotak kombo tombol tersebut.
CMFCToolBarComboBoxButton::GetItemDataPtrAll Menemukan tombol kotak kombo yang memiliki ID perintah tertentu. Mengambil nilai 32-bit yang terkait dengan indeks dalam daftar kotak kombo tombol tersebut, dan mengembalikan nilai 32-bit sebagai penunjuk.
CMFCToolBarComboBoxButton::GetText Mengembalikan teks dari kontrol edit kotak kombo.
CMFCToolBarComboBoxButton::GetTextAll Menemukan tombol kotak kombo yang memiliki ID perintah tertentu, dan mengembalikan teks dari kontrol edit tombol tersebut.
CMFCToolBarComboBoxButton::IsCenterVert Menentukan apakah tombol kotak kombo di aplikasi dipusatkan atau diselaraskan dengan bagian atas toolbar.
CMFCToolBarComboBoxButton::IsFlatMode Menentukan apakah tombol kotak kombo dalam aplikasi memiliki tampilan datar.
CMFCToolBarComboBoxButton::RemoveAllItems Menghapus semua item dari kotak daftar dan mengedit kontrol kotak kombo.
CMFCToolBarComboBoxButton::SelectItem Memilih item dalam kotak kombo sesuai dengan indeksnya, nilai 32-bit, atau string, dan memberi tahu kontrol kotak kombo tentang pilihan.
CMFCToolBarComboBoxButton::SelectItemAll Menemukan tombol kotak kombo yang memiliki ID perintah tertentu. SelectItem Panggilan untuk memilih item dalam kotak kombo tombol tersebut sesuai dengan nilai string, indeks, atau 32-bitnya.
CMFCToolBarComboBoxButton::SetCenterVert Menentukan apakah tombol kotak kombo dalam aplikasi dipusatkan secara vertikal atau diratakan dengan bagian atas toolbar.
CMFCToolBarComboBoxButton::SetDropDownHeight Mengatur tinggi kotak daftar drop-down.
CMFCToolBarComboBoxButton::SetFlatMode Menentukan apakah tombol kotak kombo dalam aplikasi memiliki tampilan datar.

Keterangan

Untuk menambahkan tombol kotak kombo ke toolbar, ikuti langkah-langkah berikut:

  1. Pesan ID sumber daya dummy untuk tombol di sumber daya toolbar induk.

  2. Membuat CMFCToolBarComboBoxButton objek.

  3. Di handler pesan yang memproses pesan AFX_WM_RESETTOOLBAR, ganti tombol dummy dengan tombol kotak kombo baru dengan menggunakan CMFCToolBar::ReplaceButton.

Untuk informasi selengkapnya, lihat Panduan: Menempatkan Kontrol Pada Toolbar. Untuk contoh tombol toolbar kotak kombo, lihat contoh proyek VisualStudioDemo.

Contoh

Contoh berikut menunjukkan cara menggunakan berbagai metode di CMFCToolBarComboBoxButton kelas . Contoh menunjukkan cara mengaktifkan kotak edit dan kombo, mengatur posisi vertikal tombol kotak kombo dalam aplikasi, mengatur tinggi kotak daftar saat dijatuhkan, mengatur tampilan gaya datar tombol kotak kombo di aplikasi, dan mengatur teks dalam kotak edit tombol kotak kombo. Cuplikan kode ini adalah bagian dari sampel Demo Visual Studio.

// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));
pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));

Hierarki Warisan

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

Persyaratan

Header: afxtoolbarcomboboxbutton.h

CMFCToolBarComboBoxButton::AddItem

Menambahkan item unik ke kotak daftar.

virtual INT_PTR AddItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parameter

lpszItem
[di] Teks item yang akan ditambahkan ke kotak daftar.

dwData
[di] Data yang terkait dengan item untuk ditambahkan ke kotak daftar.

Tampilkan Nilai

Indeks item terakhir dalam kotak daftar.

Keterangan

Jangan gunakan metode ini ketika gaya kotak daftar diurutkan.

Jika teks item sudah ada dalam kotak daftar, data baru disimpan dengan item yang sudah ada. Pencarian item peka huruf besar/kecil.

CMFCToolBarComboBoxButton::AddSortedItem

Menambahkan item ke kotak daftar dalam urutan yang ditentukan oleh metode Bandingkan .

virtual INT_PTR AddSortedItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parameter

lpszItem
[di] Teks item yang akan ditambahkan ke kotak daftar.

dwData
[di] Data yang terkait dengan item untuk ditambahkan ke kotak daftar.

Tampilkan Nilai

Indeks item yang ditambahkan ke kotak daftar.

Keterangan

Gunakan fungsi ini untuk menambahkan item ke kotak daftar dalam urutan tertentu.

CMFCToolBarComboBoxButton::CanBeStretched

Menunjukkan apakah ukuran tombol kotak kombo dapat berubah.

virtual BOOL CanBeStretched() const;

Tampilkan Nilai

Mengembalikan TRUE.

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Membuat objek CMFCToolBarComboBoxButton .

CMFCToolBarComboBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=CBS_DROPDOWNLIST,
    int iWidth=0);

Parameter

uiID
[di] ID perintah tombol baru.

iImage
[di] Indeks gambar gambar yang terkait dengan tombol baru.

dwStyle
[di] Gaya tombol baru.

iWidth
[di] Lebar, dalam piksel, dari tombol baru.

Keterangan

Lebar defaultnya adalah 150 piksel.

Untuk daftar gaya tombol toolbar, lihat Gaya Kontrol Bilah Alat

CMFCToolBarComboBoxButton::ClearData

Menghapus data yang ditentukan pengguna.

virtual void ClearData();

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini di kelas turunan jika Anda ingin menghapus data yang ditentukan pengguna.

CMFCToolBarComboBoxButton::Compare

Membandingkan dua string.

virtual int Compare(
    LPCTSTR lpszItem1,
    LPCTSTR lpszItem2);

Parameter

lpszItem1
[di] String pertama yang akan dibandingkan.

lpszItem2
[di] String kedua yang akan dibandingkan.

Tampilkan Nilai

Nilai yang menunjukkan hubungan leksikografis peka huruf besar/kecil antara string. Tabel berikut ini mencantumkan nilai yang mungkin:

Nilai Deskripsi
<0 String pertama kurang dari yang kedua.
0 String pertama sama dengan yang kedua.
>0 String pertama lebih besar dari yang kedua.

Keterangan

Ambil alih metode ini untuk mengubah cara item diurutkan dalam kotak daftar.

Perbandingan peka huruf besar/kecil.

Metode ini hanya dipanggil dari metode AddSortedItem .

CMFCToolBarComboBoxButton::CopyFrom

Menyalin status yang ditentukan CMFCToolBarComboBoxButton ke objek saat ini.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parameter

src
[di] Objek sumber CMFCToolBarComboBoxButton .

CMFCToolBarComboBoxButton::CreateCombo

Membuat kotak kombo baru untuk tombol kotak kombo.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    const CRect& rect);

Parameter

pWndParent
[di] Penunjuk ke jendela induk tombol.

rect
[di] Persegi panjang pembatas kotak kombo.

Tampilkan Nilai

Penunjuk ke kotak kombo baru jika metode berhasil; jika tidak, NULL.

CMFCToolBarComboBoxButton::CreateEdit

Membuat kotak edit baru untuk tombol kotak kombo.

virtual CMFCToolBarComboBoxEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect,
    DWORD dwEditStyle);

Parameter

pWndParent
[di] Penunjuk ke jendela induk tombol.

rect
[di] Persegi panjang pembatas kotak edit baru.

dwEditStyle
[di] Gaya kontrol kotak edit baru.

Tampilkan Nilai

Penunjuk ke kotak edit baru jika metode berhasil; jika tidak, NULL.

Keterangan

Kerangka kerja memanggil metode ini saat membuat kotak edit baru untuk tombol kotak kombo. Ambil alih metode ini untuk mengubah cara CMFCToolBarComboBoxEdit dibuat.

CMFCToolBarComboBoxButton::D eleteItem

Menghapus item tertentu dari kotak daftar.

BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);

Parameter

iIndex
[di] Indeks berbasis nol dari item yang akan dihapus.

dwData
[di] Data yang terkait dengan item yang akan dihapus.

lpszText
[di] Teks item yang akan dihapus. Jika ada beberapa item dengan teks yang sama, item pertama akan dihapus.

Tampilkan Nilai

TRUE jika item ditemukan dan berhasil dihapus; jika tidak, FALSE.

Keterangan

CMFCToolBarComboBoxButton::D uplicateData

Menduplikasi data yang ditentukan pengguna.

virtual void DuplicateData();

Keterangan

Secara default metode ini tidak melakukan apa pun. Ambil alih metode ini di kelas turunan jika Anda ingin menyalin data yang ditentukan pengguna.

CMFCToolBarComboBoxButton::EnableWindow

Mengaktifkan atau menonaktifkan kotak edit dan kombo.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan kotak edit dan kombo; FALSE untuk menonaktifkan kotak edit dan kombo.

Keterangan

Ketika dinonaktifkan, kontrol tidak dapat menjadi aktif dan tidak dapat menerima input pengguna.

CMFCToolBarComboBoxButton::ExportToMenuButton

Menyalin string dari tabel string aplikasi ke menu yang ditentukan menggunakan ID perintah tombol kotak kombo.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parameter

menuButton
[out] Referensi ke tombol menu.

Tampilkan Nilai

Selalu BENAR.

CMFCToolBarComboBoxButton::FindItem

Mengembalikan indeks item pertama dalam kotak daftar yang berisi string tertentu.

int FindItem(LPCTSTR lpszText) const;

Parameter

lpszText
[di] Teks yang akan dicari dalam kotak daftar.

Tampilkan Nilai

Indeks item; atau CB_ERR jika item tidak ditemukan.

Keterangan

CMFCToolBarComboBoxButton::GetByCmd

Mendapatkan penunjuk ke tombol kotak kombo yang memiliki ID perintah tertentu.

static CMFCToolBarComboBoxButton* GetByCmd(
    UINT uiCmd,
    BOOL bIsFocus=FALSE);

Parameter

uiCmd
[di] ID perintah tombol kotak kombo.

bIsFocus
[di] TRUE untuk mencari hanya tombol yang difokuskan; FALSE untuk mencari semua tombol.

Tampilkan Nilai

Penunjuk ke tombol kotak kombo; atau NULL jika tombol tidak ditemukan.

Keterangan

CMFCToolBarComboBoxButton::GetComboBox

Mengembalikan penunjuk ke kotak kombo di tombol kotak kombo.

CComboBox* GetComboBox() const;

Tampilkan Nilai

Penunjuk ke objek Kelas CComboBox jika metode berhasil; jika tidak, NULL.

Keterangan

CMFCToolBarComboBoxButton::GetContextMenuID

Mendapatkan ID sumber daya menu pintasan untuk tombol kotak kombo.

UINT GetContextMenuID();

Tampilkan Nilai

ID sumber daya menu pintasan.

CMFCToolBarComboBoxButton::GetCount

Mengembalikan jumlah item dalam kotak daftar.

INT_PTR GetCount() const;

Tampilkan Nilai

Jumlah item dalam kotak daftar.

Keterangan

CMFCToolBarComboBoxButton::GetCountAll

Mendapatkan jumlah item dalam kotak daftar tombol kotak kombo yang memiliki ID perintah tertentu.

static int GetCountAll(UINT uiCmd);

Parameter

uiCmd
[di] ID perintah tombol kotak kombo.

Tampilkan Nilai

Jumlah item dalam kotak daftar; jika tidak, CB_ERR jika tombol kotak kombo tidak ditemukan.

Keterangan

CMFCToolBarComboBoxButton::GetcurSel

Mendapatkan indeks item yang saat ini dipilih dalam kotak daftar.

int GetCurSel() const;

Tampilkan Nilai

Indeks item yang saat ini dipilih dalam kotak daftar; atau CB_ERR jika tidak ada item yang dipilih.

Keterangan

Indeks kotak daftar berbasis nol.

CMFCToolBarComboBoxButton::GetCurSelAll

Mengembalikan indeks item yang saat ini dipilih dalam kotak daftar tombol kotak kombo yang memiliki ID perintah tertentu.

static int GetCurSelAll(UINT uiCmd);

Parameter

uiCmd
[di] ID perintah tombol kotak kombo.

Tampilkan Nilai

Indeks item yang saat ini dipilih dalam kotak daftar; jika tidak, CB_ERR jika tidak ada item yang dipilih atau tombol kotak kombo tidak ditemukan.

Keterangan

Indeks kotak daftar berbasis nol.

CMFCToolBarComboBoxButton::GetEditctrl

Mengembalikan penunjuk ke kotak edit di tombol kotak kombo.

virtual CEdit* GetEditCtrl();

Tampilkan Nilai

Penunjuk ke kotak edit jika metode berhasil; jika tidak, NULL.

Keterangan

CMFCToolBarComboBoxButton::GetHwnd

Mengembalikan handel jendela untuk kotak kombo.

virtual HWND GetHwnd();

Tampilkan Nilai

Handel jendela, atau NULL jika kotak kombo tidak terkait dengan objek jendela.

CMFCToolBarComboBoxButton::GetItem

Mengembalikan string yang terkait dengan item pada indeks tertentu dalam kotak daftar.

LPCTSTR GetItem(int iIndex=-1) const;

Parameter

iIndex
[di] Indeks berbasis nol item dalam kotak daftar.

Tampilkan Nilai

Penunjuk ke string yang terkait dengan item; jika tidak, NULL jika parameter indeks tidak valid, atau jika parameter indeks adalah -1 dan tidak ada item yang dipilih dalam kotak kombo.

Keterangan

Parameter indeks -1 mengembalikan string item yang saat ini dipilih.

CMFCToolBarComboBoxButton::GetItemAll

Mengembalikan string yang terkait dengan item pada indeks tertentu dalam kotak daftar tombol kotak kombo yang memiliki ID perintah tertentu.

static LPCTSTR GetItemAll(
    UINT uiCmd,
    int iIndex=-1);

Parameter

uiCmd
[di] ID perintah tombol kotak kombo.

iIndex
[di] Indeks berbasis nol item dalam kotak daftar.

Tampilkan Nilai

Penunjuk ke string item jika metode berhasil; jika tidak, NULL jika indeks tidak valid, tombol kotak kombo tidak ditemukan, atau jika indeks -1 dan tidak ada item yang dipilih dalam kotak kombo.

Keterangan

Nilai indeks -1 mengembalikan string item yang saat ini dipilih.

CMFCToolBarComboBoxButton::GetItemData

Mengembalikan data yang terkait dengan item pada indeks tertentu dalam kotak daftar.

DWORD_PTR GetItemData(int iIndex=-1) const;

Parameter

iIndex
[di] Indeks berbasis nol item dalam kotak daftar.

Tampilkan Nilai

Data yang terkait dengan item; atau 0 jika item tidak ada.

Keterangan

Parameter indeks -1 mengembalikan data yang terkait dengan item yang saat ini dipilih.

CMFCToolBarComboBoxButton::GetItemDataAll

Mengembalikan data yang terkait dengan item pada indeks tertentu dalam kotak daftar tombol kotak kombo yang memiliki ID perintah tertentu.

static DWORD_PTR GetItemDataAll(
    UINT uiCmd,
    int iIndex=-1);

Parameter

uiCmd
[di] ID perintah tombol kotak kombo.

iIndex
[di] Indeks berbasis nol item dalam kotak daftar.

Tampilkan Nilai

Data yang terkait dengan item jika metode berhasil; jika tidak, 0 jika indeks yang ditentukan tidak valid, atau CB_ERR jika tombol kotak kombo tidak ditemukan.

Keterangan

Parameter indeks -1 mengembalikan data yang terkait dengan item yang saat ini dipilih.

CMFCToolBarComboBoxButton::GetItemDataPtrAll

Mengembalikan data yang terkait dengan item pada indeks tertentu dalam kotak daftar tombol kotak kombo yang memiliki ID perintah tertentu. Data ini dikembalikan sebagai penunjuk.

static void* GetItemDataPtrAll(
    UINT uiCmd,
    int iIndex=-1);

Parameter

uiCmd
[di] ID perintah tombol kotak kombo.

iIndex
[di] Indeks berbasis nol item dalam kotak daftar.

Tampilkan Nilai

Penunjuk yang terkait dengan item jika metode berhasil; jika tidak, -1 jika terjadi kesalahan, atau NULL jika tombol kotak kombo tidak ditemukan.

Keterangan

CMFCToolBarComboBoxButton::GetPrompt

Mengembalikan string perintah untuk tombol kotak kombo.

virtual CString GetPrompt() const;

Tampilkan Nilai

String perintah.

Keterangan

Metode ini saat ini tidak diimplementasikan.

CMFCToolBarComboBoxButton::GetText

Mendapatkan teks dalam kotak edit.

LPCTSTR GetText() const;

Tampilkan Nilai

Teks dalam kotak edit.

Keterangan

CMFCToolBarComboBoxButton::GetTextAll

Mendapatkan teks dalam kotak edit tombol kotak kombo yang memiliki ID perintah tertentu.

static LPCTSTR GetTextAll(UINT uiCmd);

Parameter

uiCmd
[di] ID perintah dari tombol kotak kombo tertentu.

Tampilkan Nilai

Teks dalam kotak edit jika metode berhasil; jika tidak, NULL.

Keterangan

CMFCToolBarComboBoxButton::HasFocus

Menunjukkan apakah kotak kombo saat ini memiliki fokus.

virtual BOOL HasFocus() const;

Tampilkan Nilai

TRUE jika kotak kombo saat ini memiliki fokus; jika tidak, FALSE.

Keterangan

Metode ini juga mengembalikan TRUE jika ada jendela anak dari kotak kombo yang saat ini memiliki fokus.

CMFCToolBarComboBoxButton::IsCenterVert

Mengembalikan posisi vertikal tombol kotak kombo dalam aplikasi.

static BOOL IsCenterVert();

Tampilkan Nilai

TRUE jika tombol di tengah; FALSE jika tombol diratakan di bagian atas.

Keterangan

CMFCToolBarComboBoxButton::IsFlatMode

Mengembalikan tampilan gaya datar tombol kotak kombo dalam aplikasi.

static BOOL IsFlatMode();

Tampilkan Nilai

TRUE jika tombol memiliki gaya datar; jika tidak, FALSE.

Keterangan

Gaya datar default untuk tombol kotak kombo adalah FALSE.

CMFCToolBarComboBoxButton::IsOwnerOf

Menunjukkan apakah handel yang ditentukan dikaitkan dengan tombol kotak kombo, atau salah satu anaknya.

virtual BOOL IsOwnerOf(HWND hwnd);

Parameter

hwnd
[di] Handel jendela.

Tampilkan Nilai

TRUE jika handel dialokasikan dengan tombol kotak kombo, atau salah satu anaknya; jika tidak, FALSE.

CMFCToolBarComboBoxButton::IsRibbonButton

Menunjukkan apakah tombol kotak kombo berada di panel pita.

BOOL IsRibbonButton() const;

Tampilkan Nilai

Selalu FALSE.

Keterangan

Secara default, metode ini selalu mengembalikan FALSE, yang berarti tombol kotak kombo tidak pernah ditampilkan pada panel pita.

CMFCToolBarComboBoxButton::IsWindowVisible

Mengembalikan status visibilitas tombol kotak kombo.

virtual BOOL IsWindowVisible();

Tampilkan Nilai

Status visibilitas tombol kotak kombo.

CMFCToolBarComboBoxButton::NotifyCommand

Menunjukkan apakah tombol kotak kombo memproses pesan.

virtual BOOL NotifyCommand(int iNotifyCode);

Parameter

iNotifyCode
[di] Pesan pemberitahuan yang terkait dengan perintah .

Tampilkan Nilai

Apakah tombol kotak kombo memproses pesan.

CMFCToolBarComboBoxButton::OnAddToCustomizePage

Dipanggil oleh kerangka kerja saat tombol ditambahkan ke kotak dialog Kustomisasi .

virtual void OnAddToCustomizePage();

CMFCToolBarComboBoxButton::OnCalculateSize

Dipanggil oleh kerangka kerja untuk menghitung ukuran tombol.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parameter

pDC
[di] Konteks perangkat yang menampilkan tombol kotak kombo.

sizeDefault
[di] Ukuran default tombol kotak kombo.

bHorz
[di] Status dok toolbar induk. TRUE ketika toolbar ditampar secara horizontal dan FALSE saat toolbar ditampar secara vertikal.

Tampilkan Nilai

Struktur SIZE yang berisi dimensi tombol kotak kombo, dalam piksel.

CMFCToolBarComboBoxButton::OnChangeParentWnd

Dipanggil oleh kerangka kerja saat tombol kotak kombo disisipkan ke toolbar baru.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parameter

pWndParent
[di] Arahkan ke toolbar induk baru.

CMFCToolBarComboBoxButton::OnClick

Dipanggil oleh kerangka kerja ketika pengguna mengklik tombol kotak kombo.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parameter

pWnd
[di] Penunjuk ke jendela induk tombol kotak kombo.

bDelay
[di] Dicadangkan untuk digunakan dalam kelas turunan.

Tampilkan Nilai

TRUE jika metode menangani peristiwa; jika tidak, FALSE.

CMFCToolBarComboBoxButton::OnCtlColor

Dipanggil oleh kerangka kerja saat pengguna mengubah warna toolbar induk untuk mengatur warna tombol kotak kombo.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parameter

pDC
[di] Konteks perangkat yang menampilkan tombol kotak kombo.

nCtlColor
[in] Tidak terpakai.

Tampilkan Nilai

Tangani ke kuas yang digunakan kerangka kerja untuk melukis latar belakang tombol kotak kombo.

Keterangan

Metode ini juga mengatur warna teks tombol kotak kombo.

CMFCToolBarComboBoxButton::OnDraw

Dipanggil oleh kerangka kerja untuk menggambar tombol kotak kombo dengan menggunakan gaya dan opsi yang ditentukan.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parameter

Pdc
[di] Konteks perangkat yang menampilkan tombol .

rect
[di] Persegi panjang pembatas tombol.

pImages
[di] Kumpulan gambar yang terkait dengan tombol .

bHorz
[di] Status dok toolbar induk. TRUE ketika toolbar ditampar secara horizontal dan FALSE saat toolbar ditampar secara vertikal.

bCustomizeMode
[di] Apakah aplikasi dalam mode kustomisasi.

bHighlight
[di] Apakah akan menggambar tombol kotak kombo disorot.

bDrawBorder
[di] Apakah akan menggambar tombol kotak kombo dengan batas.

bGrayDisabledButtons
[di] TRUE untuk menggambar tombol yang dinonaktifkan ber bayangan; FALSE untuk menggunakan kumpulan gambar yang dinonaktifkan.

CMFCToolBarComboBoxButton::OnDrawOnCustomizeList

Dipanggil oleh kerangka kerja untuk menggambar tombol kotak kombo di panel Perintah dari kotak dialog Kustomisasi.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parameter

pDC
[di] Konteks perangkat yang menampilkan tombol kotak kombo.

rect
[di] Persegi panjang pembatas tombol kotak kombo.

bPilih
[di] TRUE jika tombol kotak kombo dipilih; jika tidak, FALSE.

Tampilkan Nilai

Lebar, dalam piksel, dari tombol kotak kombo.

CMFCToolBarComboBoxButton::OnGlobalFontsChanged

Dipanggil oleh kerangka kerja untuk mengatur font tombol kotak kombo saat font aplikasi berubah.

virtual void OnGlobalFontsChanged();

CMFCToolBarComboBoxButton::OnMove

Dipanggil oleh kerangka kerja untuk mengubah lokasi tombol kotak kombo saat toolbar induk bergerak.

virtual void OnMove();

CMFCToolBarComboBoxButton::OnShow

Dipanggil oleh kerangka kerja saat tombol kotak kombo disembunyikan atau ditampilkan.

virtual void OnShow(BOOL bShow);

Parameter

bShow
[di] Apakah akan menyembunyikan atau menampilkan tombol kotak kombo.

CMFCToolBarComboBoxButton::OnSize

Dipanggil oleh kerangka kerja untuk mengubah ukuran tombol kotak kombo saat toolbar induk berubah ukuran.

virtual void OnSize(int iSize);

Parameter

iSize
[di] Lebar baru tombol kotak kombo.

CMFCToolBarComboBoxButton::OnUpdateToolTip

Dipanggil oleh kerangka kerja ketika pengguna mengubah tip alat untuk tombol kotak kombo.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parameter

pWndParent
[di] Penunjuk ke jendela induk untuk tombol kotak kombo.

iButtonIndex
[di] ID tombol kotak kombo.

wndToolTip
[di] Tips alat untuk mengaitkan dengan tombol kotak kombo.

Str
[di] Teks tip alat.

Tampilkan Nilai

TRUE jika metode menangani peristiwa; jika tidak, FALSE.

CMFCToolBarComboBoxButton::RemoveAllItems

Menghapus semua item dari daftar dan kotak edit.

void RemoveAllItems();

Keterangan

Menghapus semua item dari kotak daftar dan mengedit kontrol kotak kombo.

CMFCToolBarComboBoxButton::SelectItem

Memilih item dalam kotak daftar.

BOOL SelectItem(
    int iIndex,
    BOOL bNotify=TRUE);

BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);

Parameter

iIndex
[di] Indeks berbasis nol item dalam kotak daftar.

bNotify
[di] TRUE untuk memberi tahu tombol kotak kombo dari pilihan; jika tidak FALSE.

dwData
[di] Data yang terkait dengan item dalam kotak daftar.

lpszText
[di] Teks item dalam kotak daftar.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

Keterangan

CMFCToolBarComboBoxButton::SelectItemAll

Memilih item dalam kotak daftar tombol kotak kombo yang memiliki ID perintah tertentu.

static BOOL SelectItemAll(
    UINT uiCmd,
    int iIndex);

static BOOL SelectItemAll(
    UINT uiCmd,
    DWORD_PTR dwData);

static BOOL SelectItemAll(
    UINT uiCmd,
    LPCTSTR lpszText);

Parameter

uiCmd
[di] ID perintah tombol kotak kombo yang berisi kotak daftar.

iIndex
[di] Indeks berbasis nol item dalam kotak daftar. Nilai -1 menghapus pilihan saat ini dalam kotak daftar dan menghapus kotak edit.

dwData
[di] Data item dalam kotak daftar.

lpszText
[di] Teks item dalam kotak daftar.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

Keterangan

CMFCToolBarComboBoxButton::Serialize

Membaca objek ini dari arsip atau menulisnya ke arsip.

virtual void Serialize(CArchive& ar);

Parameter

Ar
[masuk, keluar] Objek CArchive yang akan diserialisasikan.

Keterangan

Pengaturan dalam CArchive objek menentukan apakah metode ini membaca atau menulis ke arsip.

CMFCToolBarComboBoxButton::SetACCData

Mengisi objek yang ditentukan CAccessibilityData dengan menggunakan data aksesibilitas dari tombol kotak kombo.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parameter

pParent
[di] Jendela induk tombol kotak kombo.

data
[out] Objek CAccessibilityData yang menerima data aksesibilitas dari tombol kotak kombo.

Tampilkan Nilai

TRUE jika metode berhasil; jika tidak FALSE.

CMFCToolBarComboBoxButton::SetCenterVert

Mengatur posisi vertikal tombol kotak kombo dalam aplikasi.

static void SetCenterVert(BOOL bCenterVert=TRUE);

Parameter

bCenterVert
[di] TRUE untuk memerah tombol kotak kombo di toolbar; FALSE untuk meratakan tombol kotak kombo ke bagian atas toolbar.

Keterangan

Secara default, tombol kotak kombo diratakan ke bagian atas.

CMFCToolBarComboBoxButton::SetContextMenuID

Mengatur ID sumber daya menu pintasan untuk tombol kotak kombo.

void SetContextMenuID(UINT uiResID);

Parameter

uiResID
[di] ID sumber daya menu pintasan.

CMFCToolBarComboBoxButton::SetDropDownHeight

Mengatur tinggi kotak daftar saat dijatuhkan ke bawah.

void SetDropDownHeight(int nHeight);

Parameter

nHeight
[di] Tinggi, dalam piksel, dari kotak daftar.

Keterangan

Tinggi default adalah 150 piksel.

CMFCToolBarComboBoxButton::SetFlatMode

Mengatur tampilan gaya datar tombol kotak kombo dalam aplikasi.

static void SetFlatMode(BOOL bFlat=TRUE);

Parameter

bFlat
[di] TRUE untuk tampilan gaya datar; jika tidak FALSE.

Keterangan

Gaya datar default untuk tombol kotak kombo adalah FALSE.

CMFCToolBarComboBoxButton::SetStyle

Mengatur gaya yang ditentukan untuk tombol kotak kombo dan menggambar ulang kontrol jika tidak dinonaktifkan.

virtual void SetStyle(UINT nStyle);

Parameter

nStyle
[di] Kombinasi bitwise (OR) gaya bilah alat.

Keterangan

Untuk daftar gaya tombol toolbar, lihat Gaya Kontrol Bilah Alat

CMFCToolBarComboBoxButton::SetText

Mengatur teks dalam kotak edit tombol kotak kombo.

void SetText(LPCTSTR lpszText);

Parameter

lpszText
[di] Penunjuk ke string yang berisi teks untuk kotak edit.

Lihat juga

Bagan Hierarki
Kelas
Kelas CMFCToolBarButton
Kelas CComboBox
CMFCToolBar::ReplaceButton
Panduan: Menempatkan Kontrol Pada Toolbar