Sdílet prostřednictvím

Seznam

  • Článek

Tato část obsahuje informace o programovacích prvcích používaných se seznamovými poli. Seznam je ovládací okno, které obsahuje jednoduchý seznam položek, ze kterých si uživatel může vybrat. Pro složitější seznamy použijte místo toho zobrazení seznamu.

Přehledy

Námět Obsah
o seznamu Popisuje funkce seznamu.
použití seznamů Vysvětluje, jak provádět úlohy přidružené k seznamům.

Funkce

Námět Obsah
DlgDirList Nahradí obsah seznamu názvy podadresářů a souborů v zadaném adresáři.
DlgDirSelectEx Načte aktuální výběr ze seznamu s jedním výběrem.
DrawInsert Nakreslí ikonu vložení v nadřazené okně zadaného seznamu přetažení.
GetListBoxInfo Načte informace o zadaném seznamu.
LBItemFromPt Načte index položky v zadaném bodě v seznamu.
MakeDragList Změní zadaný seznam s jedním výběrem na seznam přetažení.

Zprávy

Námět Obsah
LB_ADDFILE Přidá zadaný název souboru do seznamu, který obsahuje výpis adresáře.
LB_ADDSTRING Přidá řetězec do seznamu.
LB_DELETESTRING Odstraní řetězec v seznamu.
LB_DIR Přidá jména do seznamu zobrazeného seznamem.
LB_FINDSTRING Najde první řetězec v seznamu, který začíná zadaným řetězcem.
LB_FINDSTRINGEXACT Vyhledá první řetězec seznamu, který přesně odpovídá zadanému řetězci, s tím rozdílem, že hledání nerozlišuje malá a velká písmena.
LB_GETANCHORINDEX Získá index položky ukotvení, tj. položku, ze které začíná vícenásobný výběr.
LB_GETCARETINDEX Načte index položky, která má obdélník fokusu v seznamu s vícenásobným výběrem. Položka může nebo nemusí být vybrána.
LB_GETCOUNT Získá počet položek v seznamu.
LB_GETCURSEL Získá index aktuálně vybrané položky, pokud existuje, v seznamu s jedním výběrem.
LB_GETHORIZONTALEXTENT Získá šířku vpixelch
LB_GETITEMDATA Získá hodnotu definovanou aplikací přidruženou k zadané položce seznamu.
LB_GETITEMHEIGHT Získá výšku položek v seznamu.
LB_GETITEMRECT Získá rozměry obdélníku, který ohraničuje položku seznamu, protože je aktuálně zobrazen v seznamu.
LB_GETLISTBOXINFO Získá počet položek na sloupec v zadaném seznamu.
LB_GETLOCALE Získá aktuální národní prostředí seznamu.
LB_GETSEL Získá stav výběru položky.
LB_GETSELCOUNT Získá celkový počet vybraných položek v seznamu s vícenásobným výběrem.
LB_GETSELITEMS Vyplní vyrovnávací paměť polem celých čísel, která určují čísla položek vybraných položek v seznamu s vícenásobným výběrem.
LB_GETTEXT Získá řetězec ze seznamu.
LB_GETTEXTLEN Získá délku řetězce v seznamu.
LB_GETTOPINDEX Získá index první viditelné položky v seznamu.
LB_INITSTORAGE Přidělí paměť pro ukládání položek seznamu. Tato zpráva se používá před tím, než aplikace přidá do seznamu velký počet položek.
LB_INSERTSTRING Vloží data řetězce nebo položky do seznamu. Na rozdíl od zprávy LB_ADDSTRING zpráva LB_INSERTSTRING nezpůsobí řazení seznamu se stylem LBS_SORT.
LB_ITEMFROMPOINT Získá nulový index položky nejbližší zadaný bod v seznamu.
LB_RESETCONTENT Odebere všechny položky ze seznamu.
LB_SELECTSTRING Vyhledá položku, která začíná znaky v zadaném řetězci.
LB_SELITEMRANGE Vybere nebo zruší výběr jedné nebo více po sobě jdoucích položek v seznamu s vícenásobným výběrem.
LB_SELITEMRANGEEX Vybere jednu nebo více po sobě jdoucích položek v seznamu s vícenásobným výběrem.
LB_SETANCHORINDEX Nastaví položku ukotvení, tj. položku, ze které začíná vícenásobný výběr. Vícenásobný výběr zahrnuje všechny položky z položky ukotvení na stříšku.
LB_SETCARETINDEX Nastaví obdélník fokusu na položku v zadaném indexu v seznamu s vícenásobným výběrem. Pokud položka není viditelná, posune se do zobrazení.
LB_SETCOLUMNWIDTH Nastaví šířku všech sloupců v seznamu s více sloupci v pixelech.
LB_SETCOUNT Nastaví počet položek v seznamu vytvořeném pomocí stylu LBS_NODATA a nevytvořil se stylem LBS_HASSTRINGS.
LB_SETCURSEL Vybere řetězec a v případě potřeby ho posune do zobrazení.
LB_SETHORIZONTALEXTENT Nastaví šířku v pixelech, podle kterých lze seznam posunout vodorovně (posuvná šířka).
LB_SETITEMDATA Nastaví hodnotu přidruženou k zadané položce v seznamu.
LB_SETITEMHEIGHT Nastaví výšku položek v pixelech v seznamu.
LB_SETLOCALE Nastaví aktuální národní prostředí seznamu.
LB_SETSEL Vybere řetězec v seznamu s vícenásobným výběrem.
LB_SETTABSTOPS Nastaví pozice zarážky tabulátoru v seznamu.
LB_SETTOPINDEX Zajišťuje, aby byla zadaná položka v seznamu viditelná.

Upozornění

Námět Obsah
LBN_DBLCLK Upozorní aplikaci, že uživatel poklikáním na položku v seznamu.
LBN_ERRSPACE Upozorní aplikaci, že seznam nemůže přidělit dostatek paměti pro splnění konkrétního požadavku.
LBN_KILLFOCUS Upozorní aplikaci, že seznam ztratil fokus klávesnice.
LBN_SELCANCEL Upozorní aplikaci, že uživatel zrušil výběr v seznamu.
LBN_SELCHANGE Upozorní aplikaci, že se změnil výběr v seznamu.
LBN_SETFOCUS Upozorní aplikaci, že seznam obdržel fokus klávesnice.
WM_CHARTOITEM Odesláno seznamem se stylem LBS_WANTKEYBOARDINPUT jeho vlastníka v reakci na zprávu WM_CHAR.
WM_CTLCOLORLISTBOX Odesláno do nadřazeného okna seznamu před tím, než systém nakreslí seznam. Když odpovíte na tuto zprávu, nadřazené okno může nastavit text a barvy pozadí seznamu pomocí zadaného kontextového popisovače zařízení pro zobrazení.
WM_DELETEITEM Odesláno vlastníkovi seznamu nebo pole se seznamem při zničení seznamu nebo pole se seznamem nebo při odebrání položek LB_DELETESTRING, LB_RESETCONTENT, CB_DELETESTRINGnebo CB_RESETCONTENT zprávy.
WM_VKEYTOITEM Odesláno seznamem se stylem LBS_WANTKEYBOARDINPUT jeho vlastníka v reakci na zprávu WM_KEYDOWN.
DL_BEGINDRAG Upozorní nadřazené okno seznamu přetažení, že uživatel na položku kliknul na levé tlačítko myši.
DL_CANCELDRAG Signály, že uživatel zrušil operaci přetažení kliknutím na pravé tlačítko myši nebo stisknutím klávesy ESC.
DL_DRAGGING Signalizuje, že uživatel při přetahování položky přesunul myš.
DL_DROPPED Signály, že uživatel dokončil operaci přetažení uvolněním levého tlačítka myši.

Struktury

Námět Obsah
DELETEITEMSTRUCT Obsahuje informace o odstraněné položce seznamu nebo pole se seznamem.
DRAGLISTINFO Obsahuje informace o události přetažení. Ukazatel na DRAGLISTINFO se předává jako parametr lParam zprávy seznamu přetažení.

Konstanty

Námět Obsah
styly seznamu Popisuje styly oken, které definují ovládací prvek seznam.