Třída CListBox

Článek
06/10/2015

Poskytuje funkce seznamu Windows.

class CListBox : public CWnd

Členy

Veřejné konstruktory

Název	Description
CListBox::CListBox	Konstrukce CListBox objektu.

Veřejné metody

Název	Description
CListBox::AddString	Přidá řetězec do pole se seznamem.
CListBox::CharToItem	Přepsat poskytnout vlastní WM_CHAR zpracování pro překreslování seznamy, které nemají řetězce.
CListBox::CompareItem	Rámec pro určení pozice nové položky v seznamu seřazeném překreslování volány.
CListBox::Create	Vytvoří seznam Windows a připojí jej CListBox objektu.
CListBox::DeleteItem	Při odstranění položky ze seznamu vykreslování vlastníka, nazývá rámcem.
CListBox::DeleteString	Řetězec odstraní ze seznamu.
CListBox::Dir	Přidá do seznamu názvů souborů, jednotky nebo obě z aktuálního adresáře.
CListBox::DrawItem	Volat framework při vizuální hledisko změn v seznamu vykreslování vlastníka.
CListBox::FindString	Vyhledá řetězec v seznamu.
CListBox::FindStringExact	Vyhledá řetězce první pole seznamu, která odpovídá zadaný řetězec.
CListBox::GetAnchorIndex	Načte z nuly vycházející index aktuální položky v seznamu kotvu.
CListBox::GetCaretIndex	Určuje index položky, která má obdélník v rozevíracím seznamu s vícenásobným výběrem.
CListBox::GetCount	Vrátí počet řetězců v seznamu.
CListBox::GetCurSel	Vrátí z nuly vycházející index řetězce aktuálně vybrané v seznamu.
CListBox::GetHorizontalExtent	Vrátí šířku v pixelech, lze seznam vodorovně posunout.
CListBox::GetItemData	Vrátí hodnotu 32 bit přidružené položky seznamu pole.
CListBox::GetItemDataPtr	Vrací ukazatel na položku pole seznamu.
CListBox::GetItemHeight	Určuje výšku položky v seznamu.
CListBox::GetItemRect	Vrátí ohraničovacího rámečku položku pole seznamu je aktuálně zobrazena.
CListBox::GetListBoxInfo	Vyhledá číslo položky na sloupec.
CListBox::GetLocale	Načte identifikátor národního prostředí pro pole.
CListBox::GetSel	Vrátí stav výběru položky seznamu pole.
CListBox::GetSelCount	Vrátí počet řetězců vybranou v seznamu s vícenásobným výběrem.
CListBox::GetSelItems	Vrátí indexy řetězce aktuálně vybrané v seznamu.
CListBox::GetText	Položky seznamu pole se zkopíruje do vyrovnávací paměti.
CListBox::GetTextLen	Vrátí délku položky seznamu pole bajtů.
CListBox::GetTopIndex	Vrátí index prvního řetězce viditelné v seznamu.
CListBox::InitStorage	Preallocates bloky paměti pro pole položky seznamu a řetězce.
CListBox::InsertString	Vloží řetězec na určité místo v seznamu.
CListBox::ItemFromPoint	Vrátí index položky seznamu nejbližší bod.
CListBox::MeasureItem	Při vytváření seznamu překreslování určit rozměry pole seznamu volat rozhraní.
CListBox::ResetContent	Vymaže všechny položky ze seznamu.
CListBox::SelectString	Vyhledá a vybere řetězec v seznamu jeden výběr.
CListBox::SelItemRange	Táhnutím rozsah řetězců v rozevíracím seznamu s vícenásobným výběrem.
CListBox::SetAnchorIndex	Nastaví seznam s vícenásobným výběrem políčka spustíte rozšířený výběr kotvu.
CListBox::SetCaretIndex	Nastaví obdélník v rozevíracím seznamu s vícenásobným výběrem položky v zadaném indexu.
CListBox::SetColumnWidth	Nastaví šířku sloupce vícesloupcovém seznamu.
CListBox::SetCurSel	Vybere pole seznamu řetězec.
CListBox::SetHorizontalExtent	Nastaví šířku v pixelech, lze seznam vodorovně posunout.
CListBox::SetItemData	Nastaví hodnotu 32 bit přidružené položky seznamu pole.
CListBox::SetItemDataPtr	Nastaví ukazatel na položku v rozevíracím seznamu.
CListBox::SetItemHeight	Nastaví výšku položek v seznamu.
CListBox::SetLocale	Nastaví identifikátor národního prostředí pro pole.
CListBox::SetSel	Táhnutím rozevíracím seznamu položku v rozevíracím seznamu s vícenásobným výběrem.
CListBox::SetTabStops	Nastaví zarážku tabulátoru pozice v seznamu.
CListBox::SetTopIndex	Nastaví z nuly vycházející index prvního řetězce viditelné v seznamu.
CListBox::VKeyToItem	Přepsat poskytnout vlastní WM_KEYDOWN zpracování pro seznamy se LBS_WANTKEYBOARDINPUT sadu stylů.

Poznámky

Zobrazuje seznam položek, například názvy souborů, které můžete zobrazit a vyberte uživatele.

V seznamu jeden výběr můžete uživatele vybrat pouze jednu položku.Seznam s vícenásobným výběrem pole lze vybrat oblast položek.Pokud uživatel vybere položku, je zvýrazněn a seznam odešle oznámení nadřazené okno.

Můžete vytvořit seznam z dialogového okna šablony nebo přímo v kódu.Vytvořit přímo, sestavit CListBox objekt a potom volat vytvořit členské funkce vytvořit ovládací prvek pole seznamu Windows a připojit ji k CListBox objektu.Pomocí seznamu v dialogovém okně šablony, deklarování proměnné pole seznamu v dialogovém okně pole Třída a potom pomocí DDX_Control ve své třídě pole dialogového okna DoDataExchange funkce připojit členské proměnné na ovládací prvek.(důvodem je pro vás automaticky při přidání řídicí proměnná pole Třída dialogového okna.)

Konstrukce může být jednoduchý proces do třídy odvozené od CListBox .Zápis pro odvozené třídy a volání konstruktoru vytvořit z v rámci konstruktoru.

Pokud chcete Windows oznámení zprávami seznamu jeho nadřazeným (obvykle Třída odvozená od CDialog), přidat funkci mapy zprávy vstup a zpracování zpráv členských nadřazené třídy pro každou zprávu.

Každá položka mapování zprávy má následující formát:

ON_Notification( id, memberFxn )

kde id Určuje ID podřízené okno ovládacího prvku pole seznamu odesílání oznámení a memberFxn je název nadřazené funkce člena napsané zpracovat oznámení.

Nadřazené funkce prototypu je následující:

afx_msg void memberFxn( );

Následuje seznam možných položek mapy zprávy a popis případů, ve kterých se bude odesláno nadřazený:

ON_LBN_DBLCLK uživatel poklepe řetězec v seznamu.Pouze seznam, který má LBS_NOTIFY styl bude odeslání tohoto oznámení.
ON_LBN_ERRSPACE seznamu nelze přidělit dostatek paměti pro uspokojení žádosti.
ON_LBN_KILLFOCUS seznamu je ztráta vstupního fokusu.
ON_LBN_SELCANCEL aktuální výběr pole seznamu je zrušena.Tato zpráva je odeslána pouze, když seznam LBS_NOTIFY styl.
ON_LBN_SELCHANGE byl změněn výběr v seznamu.Toto oznámení není odeslána, pokud změní výběr CListBox::SetCurSel členské funkce.Toto oznámení se vztahuje pouze na seznamu, který má LBS_NOTIFY styl.LBN_SELCHANGE oznámení odesílána seznam s vícenásobným výběrem pole vždy, když uživatel stiskne klávesu se šipkou i v případě výběru nezmění.
ON_LBN_SETFOCUS seznamu přijímá vstupní fokus.
ON_WM_CHARTOITEM obdrží pole seznamu vykreslování vlastníka, který nemá žádné řetězce WM_CHAR zprávy.
ON_WM_VKEYTOITEM pole se seznamem LBS_WANTKEYBOARDINPUT obdrží styl WM_KEYDOWN zprávy.

Pokud vytvoříte CListBox objektu v rámci dialogového (prostřednictvím dialogového okna prostředek) CListBox objekt zničen automaticky při zavření dialogového okna.

Pokud vytvoříte CListBox objekt v okně a budete muset zničit CListBox objektu.Pokud vytvoříte CListBox v zásobníku, objekt je automaticky zničen.Pokud vytvoříte CListBox na haldy pomocí objektu nové funkci, musíte zavolat Odstranit na objekt zničit při zavření nadřazeného okna.

Pokud přidělit paměť v CListBox objekt, přepsat CListBox destructor nakládat přidělení.