Kelas CVSListBox

Kelas CVSListBox mendukung kontrol daftar yang dapat diedit.

Sintaks

class CVSListBox : public CVSListBoxBase

Anggota

Konstruktor Publik

Metode Publik

Metode yang Dilindungi

Keterangan

Kelas menyediakan CVSListBox sekumpulan tombol edit yang memungkinkan pengguna untuk membuat, memodifikasi, menghapus, atau mengatur ulang item dalam kontrol daftar.

Berikut ini adalah gambar kontrol daftar yang dapat diedit. Entri daftar kedua, yang berjudul "Item2", dipilih untuk pengeditan.

Jika Anda menggunakan editor sumber daya untuk menambahkan kontrol daftar yang dapat diedit, perhatikan bahwa panel Kotak Alat editor tidak menyediakan kontrol daftar yang dapat diedit sebelumnya. Sebagai gantinya, tambahkan kontrol statis seperti kontrol Kotak Grup. Kerangka kerja menggunakan kontrol statis sebagai tempat penampung untuk menentukan ukuran dan posisi kontrol daftar yang dapat diedit.

Untuk menggunakan kontrol daftar yang dapat diedit dalam templat kotak dialog, deklarasikan CVSListBox variabel di kelas kotak dialog Anda. Untuk mendukung pertukaran data antara variabel dan kontrol, tentukan DDX_Control entri makro dalam DoDataExchange metode kotak dialog. Secara default, kontrol daftar yang dapat diedit dibuat tanpa tombol edit. Gunakan metode CVSListBoxBase::SetStandardButtons yang diwariskan untuk mengaktifkan tombol edit.

Untuk informasi selengkapnya, lihat direktori Sampel, New Controls sampel, file Page3.cpp dan Page3.h.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CStatic

CVSListBoxBase

CVSListBox

Persyaratan

Header: afxvslistbox.h

CVSListBox::AddItem

Menambahkan string ke kontrol daftar.

virtual int AddItem(
    const CString& strIext,
    DWORD_PTR dwData=0,
    int iIndex=-1);

Parameter

strIext
[di] Referensi ke string.

dwData
[di] Nilai 32-bit khusus aplikasi yang terkait dengan string. Nilai default adalah 0.

iIndex
[di] Indeks berbasis nol dari posisi yang akan menahan string. Jika parameter iIndex adalah -1, string ditambahkan ke akhir daftar. Nilai defaultnya adalah -1.

Tampilkan Nilai

Indeks berbasis nol dari posisi string dalam kontrol daftar.

Keterangan

Gunakan metode CVSListBox::GetItemData untuk mengambil nilai yang ditentukan oleh parameter dwData. Nilai ini dapat berupa bilangan bulat khusus aplikasi atau penunjuk ke data lain.

CVSListBox::CVSListBox

Membuat CVSListBox objek.

CVSListBox();

Tampilkan Nilai

Keterangan

CVSListBox::EditItem

Memulai operasi edit pada teks item kontrol daftar.

virtual BOOL EditItem(int iIndex);

Parameter

iIndex
[di] Indeks berbasis nol dari item kontrol daftar.

Tampilkan Nilai

TRUE jika operasi edit berhasil dimulai; jika tidak, FALSE.

Keterangan

Pengguna memulai operasi edit baik dengan mengklik dua kali label item, atau dengan menekan tombol F2 atau SPACEBAR saat item memiliki fokus.

CVSListBox::GetCount

Mengambil jumlah string dalam kontrol daftar yang dapat diedit.

virtual int GetCount() const;

Tampilkan Nilai

Jumlah item dalam kontrol daftar.

Keterangan

Perhatikan bahwa jumlahnya lebih besar dari nilai indeks item terakhir karena indeks berbasis nol.

CVSListBox::GetItemData

Mengambil nilai 32-bit khusus aplikasi yang terkait dengan item kontrol daftar yang dapat diedit.

virtual DWORD_PTR GetItemData(int iIndex) const;

Parameter

iIndex
[di] Indeks berbasis nol dari item kontrol daftar yang dapat diedit.

Tampilkan Nilai

Nilai 32-bit yang terkait dengan item yang ditentukan.

Keterangan

Gunakan metode CVSListBox::SetItemData atau CVSListBox::AddItem untuk mengaitkan nilai 32-bit dengan item kontrol daftar. Nilai ini dapat berupa bilangan bulat khusus aplikasi atau penunjuk ke data lain.

CVSListBox::GetItemText

Mengambil teks item kontrol daftar yang dapat diedit.

virtual CString GetItemText(int iIndex) const;

Parameter

iIndex
[di] Indeks berbasis nol dari item kontrol daftar yang dapat diedit.

Tampilkan Nilai

Objek CString yang berisi teks item yang ditentukan.

Keterangan

CVSListBox::GetListHwnd

Mengembalikan handel ke kontrol tampilan daftar yang disematkan saat ini.

virtual HWND GetListHwnd() const;

Tampilkan Nilai

Handel ke kontrol tampilan daftar yang disematkan.

Keterangan

Gunakan metode ini untuk mengambil handel ke kontrol tampilan daftar yang disematkan yang mendukung CVSListBox kelas .

CVSListBox::GetSelItem

Mengambil indeks berbasis nol dari item yang saat ini dipilih dalam kontrol daftar yang dapat diedit.

virtual int GetSelItem() const;

Tampilkan Nilai

Jika metode ini berhasil, indeks berbasis nol dari item yang saat ini dipilih; jika tidak, -1.

Keterangan

CVSListBox::RemoveItem

Menghapus item dari kontrol daftar yang dapat diedit.

virtual BOOL RemoveItem(int iIndex);

Parameter

iIndex
[di] Indeks berbasis nol dari item kontrol daftar yang dapat diedit.

Tampilkan Nilai

TRUE jika item yang ditentukan dihapus; jika tidak, FALSE.

Keterangan

CVSListBox::SelectItem

Memilih string kontrol daftar yang dapat diedit.

virtual BOOL SelectItem(int iItem);

Parameter

iItem
[di] Indeks berbasis nol dari item kontrol daftar yang dapat diedit.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Metode ini memilih item yang ditentukan, dan jika diperlukan, menggulir item ke tampilan.

CVSListBox::SetItemData

Mengaitkan nilai 32-bit khusus aplikasi dengan item kontrol daftar yang dapat diedit.

virtual void SetItemData(
    int iIndex,
    DWORD_PTR dwData);

Parameter

iIndex
[di] Indeks berbasis nol dari item kontrol daftar yang dapat diedit.

dwData
[di] Nilai 32-bit. Nilai ini dapat berupa bilangan bulat khusus aplikasi atau penunjuk ke data lain.

Keterangan

Lihat juga

Bagan Hierarki
Kelas