CVSListBox – třída

Třída CVSListBox podporuje upravitelný ovládací prvek seznamu.

Syntaxe

class CVSListBox : public CVSListBoxBase

Členové

Veřejné konstruktory

Jméno	popis
CVSListBox::CVSListBox	CVSListBox Vytvoří objekt.
CVSListBox::~CVSListBox	Destruktor.

Veřejné metody

Jméno	popis
CVSListBox::AddItem	Přidá řetězec do ovládacího prvku seznamu. (Přepsání CVSListBoxBase::AddItem.)
CVSListBox::EditItem	Spustí operaci úprav textu položky ovládacího prvku seznamu. (Přepsání CVSListBoxBase::EditItem.)
CVSListBox::GetCount	Načte počet řetězců v upravitelném ovládacím prvku seznamu. (Přepsání CVSListBoxBase::GetCount.)
CVSListBox::GetItemData	Načte 32bitovou hodnotu specifickou pro aplikaci, která je přidružená k upravitelné položce ovládacího prvku seznamu. (Přepsání CVSListBoxBase::GetItemData.)
CVSListBox::GetItemText	Načte text upravitelné položky ovládacího prvku seznamu. (Přepsání CVSListBoxBase::GetItemText.)
CVSListBox::GetSelItem	Načte index na základě nuly aktuálně vybrané položky v upravitelném ovládacím prvku seznamu. (Přepsání CVSListBoxBase::GetSelItem.)
CVSListBox::PreTranslateMessage	Překládá zprávy okna před odesláním do funkcí TranslateMessage a DispatchMessage systému Windows. Další informace a syntaxe metody naleznete v tématu CWnd::P reTranslateMessage. (Přepsání CVSListBoxBase::PreTranslateMessage.)
CVSListBox::RemoveItem	Odebere položku z upravitelného ovládacího prvku seznamu. (Přepsání CVSListBoxBase::RemoveItem.)
CVSListBox::SelectItem	Vybere upravitelný ovládací řetězec seznamu. (Přepsání CVSListBoxBase::SelectItem.)
CVSListBox::SetItemData	Přidruží 32bitovou hodnotu specifickou pro aplikaci k upravitelné položce ovládacího prvku seznamu. (Přepsání CVSListBoxBase::SetItemData.)

Chráněné metody

Jméno	popis
CVSListBox::GetListHwnd	Vrátí popisovač aktuálnímu ovládacímu prvku zobrazení vloženého seznamu.

Poznámky

Třída CVSListBox poskytuje sadu tlačítek pro úpravy, které uživateli umožňují vytvářet, upravovat, odstraňovat nebo měnit uspořádání položek v ovládacím prvku seznamu.

Následuje obrázek upravitelného ovládacího prvku seznamu. Pro úpravy je vybrána druhá položka seznamu s názvem Item2.

Pokud editor prostředků použijete k přidání upravitelného ovládacího prvku seznamu, všimněte si, že podokno panelu nástrojů editoru neposkytuje předdefinovaný upravitelný ovládací prvek seznamu. Místo toho přidejte statický ovládací prvek, například ovládací prvek Group Box . Architektura používá statický ovládací prvek jako zástupný symbol k určení velikosti a umístění upravitelného ovládacího prvku seznamu.

Chcete-li použít upravitelný ovládací prvek seznamu v šabloně dialogového okna, deklarujte proměnnou CVSListBox ve třídě dialogového okna. Chcete-li podporovat výměnu dat mezi proměnnou a ovládacím prvku, definujte DDX_Control položku makra v DoDataExchange metodě dialogového okna. Ve výchozím nastavení se ovládací prvek upravitelného seznamu vytvoří bez tlačítek pro úpravy. K povolení tlačítek pro úpravy použijte zděděnou metodu CVSListBoxBase::SetStandardButtons.

Další informace najdete v adresáři Ukázky, ukázky New Controls , soubory Page3.cpp a Page3.h.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

Cwnd

CStatic

CVSListBoxBase

CVSListBox

Požadavky

Záhlaví: afxvslistbox.h

CVSListBox::AddItem

Přidá řetězec do ovládacího prvku seznamu.

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

Parametry

strIext
[v] Odkaz na řetězec.

dwData
[v] 32bitová hodnota specifická pro aplikaci, která je přidružená k řetězci. Výchozí hodnota je 0.

iIndex
[v] Index pozice založené na nule, který bude obsahovat řetězec. Pokud je parametr iIndex -1, řetězec se přidá na konec seznamu. Výchozí hodnota je -1.

Vrácená hodnota

Index založený na nule pozice řetězce v ovládacím prvku seznam.

Poznámky

K načtení hodnoty určené parametrem dwData použijte metodu CVSListBox::GetItemData. Tato hodnota může být celé číslo specifické pro aplikaci nebo ukazatel na jiná data.

CVSListBox::CVSListBox

CVSListBox Vytvoří objekt.

CVSListBox();

Vrácená hodnota

Poznámky

CVSListBox::EditItem

Spustí operaci úprav textu položky ovládacího prvku seznamu.

virtual BOOL EditItem(int iIndex);

Parametry

iIndex
[v] Index ovládacího prvku seznamu založený na nule

Vrácená hodnota

TRUE, pokud se operace úprav úspěšně spustí; jinak NEPRAVDA.

Poznámky

Uživatel spustí operaci úprav tak, že poklikáním na popisek položky nebo stisknutím klávesy F2 nebo MEZERNÍKU , když má položka fokus.

CVSListBox::GetCount

Načte počet řetězců v upravitelném ovládacím prvku seznamu.

virtual int GetCount() const;

Vrácená hodnota

Počet položek v ovládacím prvku seznam

Poznámky

Všimněte si, že počet je větší než hodnota indexu poslední položky, protože index je založený na nule.

CVSListBox::GetItemData

Načte 32bitovou hodnotu specifickou pro aplikaci, která je přidružená k upravitelné položce ovládacího prvku seznamu.

virtual DWORD_PTR GetItemData(int iIndex) const;

Parametry

iIndex
[v] Nulový index upravitelné položky ovládacího prvku seznamu.

Vrácená hodnota

32bitová hodnota přidružená k zadané položce.

Poznámky

Pomocí metody CVSListBox::SetItemData nebo CVSListBox::AddItem přidružte 32bitovou hodnotu k položce ovládacího prvku seznamu. Tato hodnota může být celé číslo specifické pro aplikaci nebo ukazatel na jiná data.

CVSListBox::GetItemText

Načte text upravitelné položky ovládacího prvku seznamu.

virtual CString GetItemText(int iIndex) const;

Parametry

iIndex
[v] Nulový index upravitelné položky ovládacího prvku seznamu.

Vrácená hodnota

CString objekt, který obsahuje text zadané položky.

Poznámky

CVSListBox::GetListHwnd

Vrátí popisovač aktuálnímu ovládacímu prvku zobrazení vloženého seznamu.

virtual HWND GetListHwnd() const;

Vrácená hodnota

Popisovač ovládacího prvku zobrazení vloženého seznamu.

Poznámky

Tuto metodu použijte k načtení popisovače do ovládacího prvku zobrazení vloženého seznamu, který podporuje CVSListBox třídu.

CVSListBox::GetSelItem

Načte index na základě nuly aktuálně vybrané položky v upravitelném ovládacím prvku seznamu.

virtual int GetSelItem() const;

Vrácená hodnota

Pokud je tato metoda úspěšná, index založený na nule aktuálně vybrané položky; jinak, -1.

Poznámky

CVSListBox::RemoveItem

Odebere položku z upravitelného ovládacího prvku seznamu.

virtual BOOL RemoveItem(int iIndex);

Parametry

iIndex
[v] Nulový index upravitelné položky ovládacího prvku seznamu.

Vrácená hodnota

TRUE, pokud je zadaná položka odebrána; jinak NEPRAVDA.

Poznámky

CVSListBox::SelectItem

Vybere upravitelný ovládací řetězec seznamu.

virtual BOOL SelectItem(int iItem);

Parametry

iItem
[v] Nulový index upravitelné položky ovládacího prvku seznamu.

Vrácená hodnota

TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA.

Poznámky

Tato metoda vybere zadanou položku a v případě potřeby ji posune do zobrazení.

CVSListBox::SetItemData

Přidruží 32bitovou hodnotu specifickou pro aplikaci k upravitelné položce ovládacího prvku seznamu.

virtual void SetItemData(
    int iIndex,
    DWORD_PTR dwData);

Parametry

iIndex
[v] Nulový index upravitelné položky ovládacího prvku seznamu.

dwData
[v] 32bitová hodnota. Tato hodnota může být celé číslo specifické pro aplikaci nebo ukazatel na jiná data.

Poznámky

Viz také

Graf hierarchie
Třídy