CVSListBox osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CVSListBox osztály támogatja a szerkeszthető listavezérlőt.

Szemantika

class CVSListBox : public CVSListBoxBase

Tagok

Nyilvános konstruktorok

Név	Description
CVSListBox::CVSListBox	Egy CVSListBox objektumot hoz létre.
CVSListBox::~CVSListBox	Destruktor.

Nyilvános módszerek

Név	Description
CVSListBox::AddItem	Sztringet ad hozzá egy listavezérlőhöz. (Felülírja CVSListBoxBase::AddItem.)
CVSListBox::EditItem	Szerkesztési műveletet indít el egy listavezérlőelem szövegén. (Felülírja CVSListBoxBase::EditItem.)
CVSListBox::GetCount	Lekéri a szerkeszthető listavezérlőben lévő sztringek számát. (Felülírja CVSListBoxBase::GetCount.)
CVSListBox::GetItemData	Egy szerkeszthető listavezérlő elemhez társított alkalmazásspecifikus 32 bites értéket kér le. (Felülírja CVSListBoxBase::GetItemData.)
CVSListBox::GetItemText	Beolvassa egy szerkeszthető lista vezérlőelemének szövegét. (Felülírja CVSListBoxBase::GetItemText.)
CVSListBox::GetSelItem	A jelenleg kijelölt elem nulla alapú indexét kéri le egy szerkeszthető listavezérlőben. (Felülírja CVSListBoxBase::GetSelItem.)
CVSListBox::PreTranslateMessage	Lefordítja az ablaküzeneteket, mielőtt elküldené őket a TranslateMessage és a DispatchMessage Windows függvénybe. További információ és metódusszintaxis: CWnd::P reTranslateMessage. (Felülírja CVSListBoxBase::PreTranslateMessage.)
CVSListBox::RemoveItem	Eltávolít egy elemet egy szerkeszthető listavezérlőből. (Felülírja CVSListBoxBase::RemoveItem.)
CVSListBox::SelectItem	Kijelöl egy szerkeszthető listavezérlő sztringet. (Felülírja CVSListBoxBase::SelectItem.)
CVSListBox::SetItemData	Alkalmazásspecifikus 32 bites értéket társít egy szerkeszthető listavezérlő elemhez. (Felülírja CVSListBoxBase::SetItemData.)

Védett metódusok

Név	Description
CVSListBox::GetListHwnd	A fogópontot az aktuális beágyazott listanézet vezérlőjének adja vissza.

Megjegyzések

Az CVSListBox osztály szerkesztési gombokat biztosít, amelyekkel a felhasználó létrehozhatja, módosíthatja, törölheti vagy átrendezheti a listavezérlő elemeit.

Az alábbiakban egy kép látható a szerkeszthető listavezérlőről. A második listabejegyzés, amelynek címe "Item2", ki van jelölve szerkesztésre.

Ha az erőforrás-szerkesztővel hozzáad egy szerkeszthető listavezérlőt, figyelje meg, hogy a szerkesztő Eszközpanelje nem biztosít előre definiált szerkeszthető listavezérlőt. Ehelyett adjon hozzá egy statikus vezérlőt, például a Group Box vezérlőt. A keretrendszer a statikus vezérlőt használja helyőrzőként a szerkeszthető listavezérlő méretének és pozíciójának megadásához.

Ha szerkeszthető listavezérlőt szeretne használni egy párbeszédpanelsablonban, deklaráljon egy változót CVSListBox a párbeszédpanel-osztályban. A változó és a vezérlő közötti adatcsere támogatásához adjon meg egy DDX_Control makróbejegyzést a DoDataExchange párbeszédpanel metódusában. A szerkeszthető lista vezérlőelem alapértelmezés szerint szerkesztési gombok nélkül jön létre. A szerkesztési gombok engedélyezéséhez használja az örökölt CVSListBoxBase::SetStandardButtons metódust.

További információkért tekintse meg a Minták könyvtárat, a New Controls mintát, a Page3.cpp és a Page3.h fájlokat.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CStatic

CVSListBoxBase

CVSListBox

Requirements

Fejléc: afxvslistbox.h

CVSListBox::AddItem

Sztringet ad hozzá egy listavezérlőhöz.

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

Paraméterek

strIext
[in] Hivatkozás egy sztringre.

dwData
[in] A sztringhez társított alkalmazásspecifikus 32 bites érték. Az alapértelmezett érték 0.

iIndex
[in] A sztringet tartalmazó pozíció nullaalapú indexe. Ha az iIndex paraméter -1, a sztring a lista végére kerül. Az alapértelmezett érték -1.

Visszaadott érték

A sztring helyének nulla alapú indexe a listavezérlőben.

Megjegyzések

A CVSListBox::GetItemData metódussal kérje le a dwData paraméter által megadott értéket. Ez az érték lehet alkalmazásspecifikus egész szám vagy más adatokra mutató mutató.

CVSListBox::CVSListBox

Egy CVSListBox objektumot hoz létre.

CVSListBox();

Visszaadott érték

Megjegyzések

CVSListBox::EditItem

Szerkesztési műveletet indít el egy listavezérlőelem szövegén.

virtual BOOL EditItem(int iIndex);

Paraméterek

iIndex
[in] Listavezérlő elem nulla alapú indexe.

Visszaadott érték

IGAZ, ha a szerkesztési művelet sikeresen elindul; egyéb esetben HAMIS.

Megjegyzések

A felhasználó elindít egy szerkesztési műveletet egy elem címkéére duplán kattintva, vagy az F2 vagy SZÓKÖZ billentyű lenyomásával, amikor egy elem fókuszba kerül.

CVSListBox::GetCount

Lekéri a szerkeszthető listavezérlőben lévő sztringek számát.

virtual int GetCount() const;

Visszaadott érték

A listavezérlő elemeinek száma.

Megjegyzések

Vegye figyelembe, hogy a darabszám egy nagyobb, mint az utolsó elem indexértéke, mivel az index nulla alapú.

CVSListBox::GetItemData

Egy szerkeszthető listavezérlő elemhez társított alkalmazásspecifikus 32 bites értéket kér le.

virtual DWORD_PTR GetItemData(int iIndex) const;

Paraméterek

iIndex
[in] Szerkeszthető listavezérlő elem nulla alapú indexe.

Visszaadott érték

A megadott elemhez társított 32 bites érték.

Megjegyzések

A CVSListBox::SetItemData vagy CVSListBox::AddItem metódussal társíthatja a 32 bites értéket a listavezérlő elemhez. Ez az érték lehet alkalmazásspecifikus egész szám vagy más adatokra mutató mutató.

CVSListBox::GetItemText

Beolvassa egy szerkeszthető lista vezérlőelemének szövegét.

virtual CString GetItemText(int iIndex) const;

Paraméterek

iIndex
[in] Szerkeszthető listavezérlő elem nulla alapú indexe.

Visszaadott érték

Egy CString objektum, amely a megadott elem szövegét tartalmazza.

Megjegyzések

CVSListBox::GetListHwnd

A fogópontot az aktuális beágyazott listanézet vezérlőjének adja vissza.

virtual HWND GetListHwnd() const;

Visszaadott érték

A beágyazott listanézet vezérlőjének fogópontja.

Megjegyzések

Ezzel a módszerrel lekérhet egy fogópontot az osztályt támogató beágyazott listanézet-vezérlőhöz CVSListBox .

CVSListBox::GetSelItem

A jelenleg kijelölt elem nulla alapú indexét kéri le egy szerkeszthető listavezérlőben.

virtual int GetSelItem() const;

Visszaadott érték

Ha ez a módszer sikeres, az aktuálisan kijelölt elem nulla alapú indexe; ellenkező esetben -1.

Megjegyzések

CVSListBox::RemoveItem

Eltávolít egy elemet egy szerkeszthető listavezérlőből.

virtual BOOL RemoveItem(int iIndex);

Paraméterek

iIndex
[in] Szerkeszthető listavezérlő elem nulla alapú indexe.

Visszaadott érték

IGAZ, ha a megadott elem el lett távolítva; egyéb esetben HAMIS.

Megjegyzések

CVSListBox::SelectItem

Kijelöl egy szerkeszthető listavezérlő sztringet.

virtual BOOL SelectItem(int iItem);

Paraméterek

iItem
[in] Szerkeszthető listavezérlő elem nulla alapú indexe.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus kiválasztja a megadott elemet, és szükség esetén görgeti az elemet a nézetbe.

CVSListBox::SetItemData

Alkalmazásspecifikus 32 bites értéket társít egy szerkeszthető listavezérlő elemhez.

virtual void SetItemData(
    int iIndex,
    DWORD_PTR dwData);

Paraméterek

iIndex
[in] Szerkeszthető listavezérlő elem nulla alapú indexe.

dwData
[in] 32 bites érték. Ez az érték lehet alkalmazásspecifikus egész szám vagy más adatokra mutató mutató.

Megjegyzések

Lásd még

hierarchiadiagram
osztályok