CVSListBox Sınıfı
CVSListBox sınıfı düzenlenebilir liste denetimini destekler.
Sözdizimi
class CVSListBox : public CVSListBoxBase
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CVSListBox::CVSListBox | Bir CVSListBox nesne oluşturur. |
CVSListBox::~CVSListBox |
Yıkıcı. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CVSListBox::AddItem | Liste denetimine bir dize ekler. (Geçersiz Kılmalar CVSListBoxBase::AddItem.) |
| CVSListBox::EditItem | Liste denetim öğesinin metni üzerinde düzenleme işlemi başlatır. (Geçersiz Kılmalar CVSListBoxBase::EditItem.) |
| CVSListBox::GetCount | Düzenlenebilir liste denetimindeki dize sayısını alır. (Geçersiz Kılmalar CVSListBoxBase::GetCount.) |
| CVSListBox::GetItemData | Düzenlenebilir liste denetim öğesiyle ilişkili uygulamaya özgü 32 bitlik bir değer alır. (Geçersiz Kılmalar CVSListBoxBase::GetItemData.) |
| CVSListBox::GetItemText | Düzenlenebilir liste denetim öğesinin metnini alır. (Geçersiz Kılmalar CVSListBoxBase::GetItemText.) |
| CVSListBox::GetSelItem | Düzenlenebilir liste denetiminde seçili durumdaki öğenin sıfır tabanlı dizinini alır. (Geçersiz Kılmalar CVSListBoxBase::GetSelItem.) |
CVSListBox::PreTranslateMessage |
Pencere iletilerini TranslateMessage ve DispatchMessage Windows işlevlerine göndermeden önce çevirir. Daha fazla bilgi ve yöntem söz dizimi için bkz . CWnd::P reTranslateMessage. (Geçersiz Kılmalar CVSListBoxBase::PreTranslateMessage.) |
| CVSListBox::RemoveItem | Bir öğeyi düzenlenebilir liste denetiminden kaldırır. (Geçersiz Kılmalar CVSListBoxBase::RemoveItem.) |
| CVSListBox::SelectItem | Düzenlenebilir bir liste denetim dizesi seçer. (Geçersiz Kılmalar CVSListBoxBase::SelectItem.) |
| CVSListBox::SetItemData | Uygulamaya özgü 32 bitlik bir değeri düzenlenebilir liste denetim öğesiyle ilişkilendirir. (Geçersiz Kılmalar CVSListBoxBase::SetItemData.) |
Korumalı Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CVSListBox::GetListHwnd | Geçerli eklenmiş liste görünümü denetiminin tutamacını döndürür. |
Açıklamalar
sınıfı, CVSListBox kullanıcının liste denetimindeki öğeleri oluşturmasına, değiştirmesine, silmesine veya yeniden düzenlemesine olanak tanıyan bir dizi düzenleme düğmesi sağlar.
Aşağıda, düzenlenebilir liste denetiminin bir resmi yer alır. Düzenleme için "Öğe2" başlıklı ikinci liste girdisi seçilir.
Düzenlenebilir liste denetimi eklemek için kaynak düzenleyicisini kullanırsanız, düzenleyicinin Araç Kutusu bölmesinin önceden tanımlanmış düzenlenebilir liste denetimi sağlamadığını göreceksiniz. Bunun yerine, Group Box denetimi gibi bir statik denetim ekleyin. Çerçeve, düzenlenebilir liste denetiminin boyutunu ve konumunu belirtmek için yer tutucu olarak statik denetimi kullanır.
bir iletişim kutusu şablonunda düzenlenebilir liste denetimi kullanmak için, iletişim kutusu sınıfınızda bir CVSListBox değişken bildirin. Değişken ve denetim arasında veri alışverişini desteklemek için, iletişim kutusunun yönteminde DoDataExchange bir DDX_Control makro girdisi tanımlayın. Varsayılan olarak, düzenlenebilir liste denetimi düzenleme düğmeleri olmadan oluşturulur. Düzenleme düğmelerini etkinleştirmek için devralınan CVSListBoxBase::SetStandardButtons yöntemini kullanın.
Daha fazla bilgi için Örnekler dizinine, örneğe New Controls , Page3.cpp ve Page3.h dosyalarına bakın.
Devralma Hiyerarşisi
CVSListBoxBase
Gereksinimler
Üst bilgi: afxvslistbox.h
CVSListBox::AddItem
Liste denetimine bir dize ekler.
virtual int AddItem(
const CString& strIext,
DWORD_PTR dwData=0,
int iIndex=-1);
Parametreler
strIext
[in] Bir dizeye başvuru.
dwData
[in] Dizeyle ilişkili uygulamaya özgü 32 bit değer. Varsayılan değer 0'tir.
iIndex
[in] Dizeyi barındıracak konumun sıfır tabanlı dizini. iIndex parametresi -1 ise, dize listenin sonuna eklenir. Varsayılan değer -1'dir.
Dönüş Değeri
Dizenin liste denetimindeki konumunun sıfır tabanlı dizini.
Açıklamalar
dwData parametresi tarafından belirtilen değeri almak için CVSListBox::GetItemData yöntemini kullanın. Bu değer uygulamaya özgü bir tamsayı veya diğer verilere yönelik bir işaretçi olabilir.
CVSListBox::CVSListBox
Bir CVSListBox nesne oluşturur.
CVSListBox();
Dönüş Değeri
Açıklamalar
CVSListBox::EditItem
Liste denetim öğesinin metni üzerinde düzenleme işlemi başlatır.
virtual BOOL EditItem(int iIndex);
Parametreler
iIndex
[in] Liste denetim öğesinin sıfır tabanlı dizini.
Dönüş Değeri
Düzenleme işlemi başarıyla başlatılırsa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
Kullanıcı, bir öğenin etiketine çift tıklayarak veya odak öğeye sahip olduğunda F2 veya ARA ÇUBUĞU tuşuna basarak düzenleme işlemi başlatır.
CVSListBox::GetCount
Düzenlenebilir liste denetimindeki dize sayısını alır.
virtual int GetCount() const;
Dönüş Değeri
Liste denetimindeki öğe sayısı.
Açıklamalar
Dizin sıfır tabanlı olduğundan, sayının son öğenin dizin değerinden büyük olduğunu unutmayın.
CVSListBox::GetItemData
Düzenlenebilir liste denetim öğesiyle ilişkili uygulamaya özgü 32 bitlik bir değer alır.
virtual DWORD_PTR GetItemData(int iIndex) const;
Parametreler
iIndex
[in] Düzenlenebilir liste denetim öğesinin sıfır tabanlı dizini.
Dönüş Değeri
Belirtilen öğeyle ilişkili 32 bit değer.
Açıklamalar
32 bit değerini liste denetim öğesiyle ilişkilendirmek için CVSListBox::SetItemData veya CVSListBox::AddItem yöntemini kullanın. Bu değer uygulamaya özgü bir tamsayı veya diğer verilere yönelik bir işaretçi olabilir.
CVSListBox::GetItemText
Düzenlenebilir liste denetim öğesinin metnini alır.
virtual CString GetItemText(int iIndex) const;
Parametreler
iIndex
[in] Düzenlenebilir liste denetim öğesinin sıfır tabanlı dizini.
Dönüş Değeri
Belirtilen öğenin metnini içeren bir CString nesnesi.
Açıklamalar
CVSListBox::GetListHwnd
Geçerli eklenmiş liste görünümü denetiminin tutamacını döndürür.
virtual HWND GetListHwnd() const;
Dönüş Değeri
Eklenmiş liste görünümü denetiminin tutamacı.
Açıklamalar
sınıfını destekleyen CVSListBox eklenmiş liste görünümü denetimine bir tanıtıcı almak için bu yöntemi kullanın.
CVSListBox::GetSelItem
Düzenlenebilir liste denetiminde seçili durumdaki öğenin sıfır tabanlı dizinini alır.
virtual int GetSelItem() const;
Dönüş Değeri
Bu yöntem başarılı olursa, seçili durumdaki öğenin sıfır tabanlı dizini; aksi takdirde, -1.
Açıklamalar
CVSListBox::RemoveItem
Bir öğeyi düzenlenebilir liste denetiminden kaldırır.
virtual BOOL RemoveItem(int iIndex);
Parametreler
iIndex
[in] Düzenlenebilir liste denetim öğesinin sıfır tabanlı dizini.
Dönüş Değeri
Belirtilen öğe kaldırılırsa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
CVSListBox::SelectItem
Düzenlenebilir bir liste denetim dizesi seçer.
virtual BOOL SelectItem(int iItem);
Parametreler
iItem
[in] Düzenlenebilir liste denetim öğesinin sıfır tabanlı dizini.
Dönüş Değeri
Bu yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
Bu yöntem belirtilen öğeyi seçer ve gerekirse öğeyi görünüme kaydırarak görüntüler.
CVSListBox::SetItemData
Uygulamaya özgü 32 bitlik bir değeri düzenlenebilir liste denetim öğesiyle ilişkilendirir.
virtual void SetItemData(
int iIndex,
DWORD_PTR dwData);
Parametreler
iIndex
[in] Düzenlenebilir liste denetim öğesinin sıfır tabanlı dizini.
dwData
[in] 32 bit değer. Bu değer uygulamaya özgü bir tamsayı veya diğer verilere yönelik bir işaretçi olabilir.