CVSListBox – třída
Třída CVSListBox podporuje upravitelný ovládací prvek seznamu.
Syntaxe
class CVSListBox : public CVSListBoxBase
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CVSListBox::CVSListBox | CVSListBox Vytvoří objekt. |
CVSListBox::~CVSListBox |
Destruktor. |
Veřejné metody
| Název | 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
| Název | 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ázku New Controls , soubory Page3.cpp a Page3.h.
Hierarchie dědičnosti
CVSListBoxBase
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.
Návratová 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();
Návratová 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
Návratová 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;
Návratová 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.
Návratová 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.
Návratová 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;
Návratová 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;
Návratová 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.
Návratová 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.
Návratová 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.