Kombinált lista (Windows-vezérlők)

Ez a szakasz a kombinált listákban használt programozási elemekről tartalmaz információkat. A kombinált lista egy egyedi vezérlőtípus, amelyet a COMBOBOX osztály határoz meg, amely egyesíti a lista és a szerkesztési vezérlő funkcióinak nagy részét.

Áttekintés

Téma	Tartalomjegyzék
A kombinált lista	Ez a szakasz a kombinált listák különböző típusait ismerteti.
Kombinált lista funkciói	Ez a dokumentum a kombinált lista funkcióit ismerteti.
Kombinált lista használata	Az ebben a szakaszban szereplő kód példák bemutatják, hogyan hajthatja végre a kombinált listákhoz társított feladatokat.

Funkciók

Téma	Tartalomjegyzék
DlgDirListComboBox	A kombinált lista tartalmát lecseréli egy adott könyvtár alkönyvtárainak és fájljainak nevére. A nevek listáját fájlattribútumok halmazának megadásával szűrheti. A nevek listája tartalmazhat megfeleltetett meghajtóbetűjeleket.
DlgDirSelectComboBoxEx	Az aktuális kijelölést a DlgDirListComboBox függvénnyel kitöltött kombinált listából kéri le. A kijelölést meghajtóbetűjelként, fájlként vagy könyvtárnévként értelmezi a rendszer.
GetComboBoxInfo	Beolvassa a megadott kombinált lista adatait.

Makrók

Téma	Tartalomjegyzék
ComboBox_AddItemData	Elemadatokat ad hozzá a listához egy kombinált listában a megadott helyen. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_ADDSTRING üzenetet.
ComboBox_AddString	Sztringet ad hozzá egy kombinált lista listájához. Ha a kombinált lista nem rendelkezik a CBS_SORT stílusával, a sztring a lista végére kerül. Ellenkező esetben a sztring be lesz szúrva a listába, és a lista rendezve lesz. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_ADDSTRING üzenetet.
ComboBox_DeleteString	Törli az elemet a lista megadott helyén egy kombinált listában. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_DELETESTRING üzenetet.
ComboBox_Dir	Neveket ad hozzá a kombinált lista által megjelenített listához. A makró hozzáadja a megadott sztringnek és fájlattribútum-készletnek megfelelő könyvtárak és fájlok nevét. Egy kombinált lista megfeleltetett meghajtóbetűjeleit is hozzáadhatja a listához. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_DIR üzenetet.
ComboBox_Enable	Kombinált lista vezérlőelem engedélyezése vagy letiltása.
ComboBox_FindItemData	Megkeresi a kombinált lista első olyan elemét, amely a megadott elemadatokat tartalmazza. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_FINDSTRING üzenetet.
ComboBox_FindString	Megkeresi a kombinált lista első sztringét, amely a megadott sztringgel kezdődik. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_FINDSTRING üzenetet.
ComboBox_FindStringExact	Megkeresi a kombinált lista első sztringét, amely pontosan megfelel a megadott sztringnek, azzal a kivétellel, hogy a keresés nem megkülönbözteti a kis- és nagybetűt. Használhatja ezt a makrót, vagy explicit módon küldheti el a CB_FINDSTRINGEXACT üzenetet.
ComboBox_GetCount	A kombinált lista listaelemeinek számát adja meg. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETCOUNT üzenetet.
ComboBox_GetCueBannerText	Lekéri a kombinált lista szerkesztési vezérlőjében megjelenő szalagcímszöveget. Használja ezt a makrót, vagy küldje el kifejezetten a CB_GETCUEBANNER üzenetet.
ComboBox_GetCurSel	Lekéri az aktuálisan kijelölt elem indexét egy kombinált listában. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETCURSEL üzenetet.
ComboBox_GetDroppedControlRect	Lekéri egy kombinált lista képernyőkoordinátáit a ledobott állapotban. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETDROPPEDCONTROLRECT üzenetet.
ComboBox_GetDroppedState	Megállapítja, hogy a kombinált lista vezérlőelem legördülő listája látható-e. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETDROPPEDSTATE üzenetet.
ComboBox_GetExtendedUI	Megállapítja, hogy a kombinált lista az alapértelmezett felhasználói felületet (UI) vagy a kiterjesztett felhasználói felületet használja-e. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETEXTENDEDUI üzenetet.
ComboBox_GetItemData	Beolvasja az alkalmazás által megadott értéket a megadott listaelemhez egy kombinált listában. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETITEMDATA üzenetet.
ComboBox_GetItemHeight	Beolvassa a listaelemek magasságát a kombinált listában. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETITEMHEIGHT üzenetet.
ComboBox_GetLBText	Sztringet kap egy kombinált lista listájából. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETLBTEXT üzenetet.
ComboBox_GetLBTextLen	Egy karakterlánc hosszát adja meg a lista egy kombinált listában. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_GETLBTEXTLEN üzenetet.
ComboBox_GetMinVisible	Lekéri a lista legördülő listájában látható elemek minimális számát.
ComboBox_GetText	Beolvassa a szöveget egy kombinált lista vezérlőelemből.
ComboBox_GetTextLength	A kombinált lista szövegében szereplő karakterek számát adja meg.
ComboBox_InsertItemData	Elemadatokat szúr be egy listába egy kombinált listában a megadott helyen. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_INSERTSTRING üzenetet.
ComboBox_InsertString	Sztringet ad hozzá a megadott helyen lévő kombinált lista listájához. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_INSERTSTRING üzenetet.
ComboBox_LimitText	Korlátozza annak a szövegnek a hosszát, amelybe a felhasználó beírhat egy kombinált lista szerkesztési vezérlőjeként. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_LIMITTEXT üzenetet.
ComboBox_ResetContent	Eltávolítja az összes elemet a listamezőből, és módosítja a kombinált lista vezérlőelemét. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_RESETCONTENT üzenetet.
ComboBox_SelectItemData	Lista keresése kombinált listában olyan elemhez, amely a megadott elemadatokat tartalmazza. Ha talál egyező elemet, az elem ki van jelölve. Ezt a makrót használhatja, vagy kifejezetten elküldheti a CB_SELECTSTRING üzenetet.
ComboBox_SelectString	Lista keresése kombinált listában egy adott sztringben szereplő karakterekkel kezdődő elemhez. Ha talál egyező elemet, az elem ki van jelölve. Ezt a makrót használhatja, vagy kifejezetten elküldheti a CB_SELECTSTRING üzenetet.
ComboBox_SetCueBannerText	Beállítja a kombinált lista szerkesztési vezérlője számára megjelenített szalagcímszöveget.
ComboBox_SetCurSel	Beállítja az aktuálisan kijelölt elemet egy kombinált listában. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_SETCURSEL üzenetet.
ComboBox_SetExtendedUI	A CBS_DROPDOWN vagy CBS_DROPDOWNLIST stílussal rendelkező kombinált lista alapértelmezett felhasználói felületét (UI) vagy kiterjesztett felhasználói felületét választja ki. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_SETEXTENDEDUI üzenetet.
ComboBox_SetItemData	A kombinált lista megadott listaeleméhez társított alkalmazás által definiált értéket állítja be. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_SETITEMDATA üzenetet.
ComboBox_SetItemHeight	A listaelemek vagy a kijelölési mező magasságának beállítása kombinált listában. Használhatja ezt a makrót, vagy kifejezetten elküldheti a CB_SETITEMHEIGHT üzenetet.
ComboBox_SetMinVisible	A kombinált lista legördülő listájában szereplő látható elemek minimális számát adja meg.
ComboBox_SetText	Egy kombinált lista szövegét állítja be.
ComboBox_ShowDropdown	Megjeleníti vagy elrejti a listát egy kombinált listában. Használhatja ezt a makrót, vagy explicit módon küldheti el a CB_SHOWDROPDOWN üzenetet.

Üzenetek

Téma	Tartalomjegyzék
CB_ADDSTRING	Sztringet ad hozzá a kombinált lista listájához. Ha a kombinált lista nem rendelkezik a CBS_SORT stílusával, a sztring a lista végére kerül. Ellenkező esetben a sztring be lesz szúrva a listába, és a lista rendezve lesz.
CB_DELETESTRING	Sztring törlése a kombinált lista listamezőjében.
CB_DIR	Neveket ad hozzá a kombinált lista által megjelenített listához. Az üzenet hozzáadja a megadott sztringnek és fájlattribútum-készletnek megfelelő könyvtárak és fájlok nevét. CB_DIR hozzárendelt meghajtóbetűjeleket is hozzáadhat a listához.
CB_FINDSTRING	A kombinált lista listában keres egy adott sztringben szereplő karakterekkel kezdődő elemet.
CB_FINDSTRINGEXACT	Megkeresi az első listamező-sztringet egy kombinált listában, amely megfelel az lParam paraméterben megadott sztringnek.
CB_GETCOMBOBOXINFO	Információt kap a megadott kombinált listáról.
CB_GETCOUNT	A kombinált lista listaelemeinek számát adja meg.
CB_GETCUEBANNER	Lekéri a kombinált lista szerkesztési vezérlőjében megjelenő szalagcímszöveget. Küldje el ezt az üzenetet explicit módon vagy a ComboBox_GetCueBannerText makró használatával.
CB_GETCURSEL	Az alkalmazás egy CB_GETCURSEL üzenetet küld, amely lekéri az aktuálisan kijelölt elem indexét( ha van ilyen), a kombinált lista listájában.
CB_GETDROPPEDCONTROLRECT	Az alkalmazás CB_GETDROPPEDCONTROLRECT üzenetet küld egy legördülő lista képernyőkoordinátáinak lekéréséhez.
CB_GETDROPPEDSTATE	Meghatározza, hogy a kombinált lista listamezője le van-e dobva.
CB_GETDROPPEDWIDTH	A CBS_DROPDOWN vagy CBS_DROPDOWNLIST stílussal rendelkező kombinált lista listamezőjének képpontban megadott minimális szélességét adja meg képpontban.
CB_GETEDITSEL	Beolvashatja az aktuális kijelölés kezdő és befejező karakterpozícióit a kombinált lista szerkesztési vezérlőjében.
CB_GETEXTENDEDUI	Meghatározza, hogy a kombinált lista rendelkezik-e az alapértelmezett felhasználói felülettel vagy a kiterjesztett felhasználói felülettel.
CB_GETHORIZONTALEXTENT	Képpontban lekéri azt a szélességet, amelynél a listamező vízszintesen görgethető (a görgethető szélesség). Ez csak akkor alkalmazható, ha a listamező vízszintes görgetősávot tartalmaz.
CB_GETITEMDATA	Az alkalmazás egy CB_GETITEMDATA üzenetet küld egy kombinált listának, amely lekéri a kombinált lista megadott eleméhez társított alkalmazás által megadott értéket.
CB_GETITEMHEIGHT	Meghatározza a listaelemek magasságát vagy a kombinált lista kijelölési mezőjét.
CB_GETLBTEXT	Sztringet kap a kombinált lista listájából.
CB_GETLBTEXTLEN	A kombinált lista listájában egy sztring hosszát adja meg karakterben.
CB_GETLOCALE	Lekéri a kombinált lista aktuális területi beállítását. A területi beállítással meghatározhatja a megjelenített szöveg helyes rendezési sorrendjét az CBS_SORT stílussal és a CB_ADDSTRING üzenettel hozzáadott szöveggel.
CB_GETMINVISIBLE	Lekéri a lista legördülő listájában látható elemek minimális számát.
CB_GETTOPINDEX	Egy alkalmazás elküldi a CB_GETTOPINDEX üzenetet, amely lekéri a kombinált lista listamezőjének első látható elemének nulla alapú indexét. Kezdetben a 0 indexű elem a listamező tetején található, de ha a listadoboz tartalma görgetve van, egy másik elem lehet a tetején.
CB_INITSTORAGE	Az alkalmazás elküldi a CB_INITSTORAGE üzenetet, mielőtt nagy számú elemet ad hozzá a kombinált lista listarészéhez. Ez az üzenet memóriát foglal le a listaelemek tárolásához.
CB_INSERTSTRING	Sztring- vagy elemadatokat szúr be a kombinált lista listájába. A CB_ADDSTRING üzenettől eltérően a CB_INSERTSTRING üzenet nem okoz CBS_SORT stílusú listát.
CB_LIMITTEXT	Korlátozza annak a szövegnek a hosszát, amelybe a felhasználó beírhat egy kombinált lista szerkesztési vezérlőjeként.
CB_RESETCONTENT	Eltávolítja az összes elemet a listamezőből, és módosítja a kombinált lista vezérlőelemét.
CB_SELECTSTRING	Megkeresi a kombinált lista azon elemeinek listáját, amelyek egy adott sztringben szereplő karakterekkel kezdődnek. Ha egyező elemet talál, ki van jelölve, és átmásolja a szerkesztési vezérlőbe.
CB_SETCUEBANNER	Beállítja a kombinált lista szerkesztési vezérlője számára megjelenített szalagcímszöveget.
CB_SETCURSEL	Egy alkalmazás egy CB_SETCURSEL üzenetet küld, amely kijelöl egy sztringet a kombinált lista listájában. Szükség esetén a lista görgeti a sztringet a nézetben. A kombinált lista szerkesztési vezérlőjében lévő szöveg az új kijelölésnek megfelelően változik, és a lista bármely korábbi kijelölése el lesz távolítva.
CB_SETDROPPEDWIDTH	Az alkalmazás elküldi a CB_SETDROPPEDWIDTH üzenetet, amely a CBS_DROPDOWN vagy CBS_DROPDOWNLIST stílusú kombinált lista listamezőjének képpontban megadott maximális szélességét állítja be képpontban.
CB_SETEDITSEL	Egy alkalmazás CB_SETEDITSEL üzenetet küld a kombinált lista szerkesztési vezérlőjében szereplő karakterek kijelöléséhez.
CB_SETEXTENDEDUI	Az alkalmazás egy CB_SETEXTENDEDUI üzenetet küld az alapértelmezett felhasználói felület vagy a kiterjesztett felhasználói felület kiválasztásához egy olyan kombinált lista esetében, amely CBS_DROPDOWN vagy CBS_DROPDOWNLIST stílussal rendelkezik.
CB_SETHORIZONTALEXTENT	Az alkalmazás elküldi a CB_SETHORIZONTALEXTENT üzenetet a szélesség képpontban történő beállításához, amellyel egy listamező vízszintesen görgethető (a görgethető szélesség). Ha a lista szélessége kisebb ennél az értéknél, a vízszintes görgetősáv vízszintesen görgeti a lista elemeit. Ha a lista szélessége egyenlő vagy nagyobb ennél az értéknél, a vízszintes görgetősáv rejtett, vagy ha a kombinált lista CBS_DISABLENOSCROLL stílust tartalmaz, le van tiltva.
CB_SETITEMDATA	Egy alkalmazás egy CB_SETITEMDATA üzenetet küld a megadott elemhez társított érték beállításához a kombinált listában.
CB_SETITEMHEIGHT	Egy alkalmazás egy CB_SETITEMHEIGHT üzenetet küld a listaelemek magasságának vagy a kijelölési mezőnek a kombinált listában való beállításához.
CB_SETLOCALE	Egy alkalmazás CB_SETLOCALE üzenetet küld a kombinált lista aktuális területi beállításának beállításához. Ha a kombinált lista stílusa CBS_SORT, és a sztringek CB_ADDSTRINGhasználatával vannak hozzáadva, a kombinált lista területi beállítása befolyásolja a listaelemek rendezését.
CB_SETMINVISIBLE	Az alkalmazás egy CB_SETMINVISIBLE üzenetet küld a kombinált lista legördülő listájában látható elemek minimális számának beállításához.
CB_SETTOPINDEX	Az alkalmazás elküldi a CB_SETTOPINDEX üzenetet, hogy egy adott elem látható legyen a kombinált lista listában. A rendszer görgeti a lista tartalmát, hogy vagy a megadott elem jelenik meg a lista tetején, vagy elérte a maximális görgetési tartományt.
CB_SHOWDROPDOWN	Az alkalmazás egy CB_SHOWDROPDOWN üzenetet küld a CBS_DROPDOWN vagy CBS_DROPDOWNLIST stílussal rendelkező kombinált lista listájának megjelenítéséhez vagy elrejtéséhez.

Értesítések

Téma	Tartalomjegyzék
CBN_CLOSEUP	A CBN_CLOSEUP értesítési kód akkor lesz elküldve, ha a kombinált lista listamezője bezárult. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_DBLCLK	A CBN_DBLCLK értesítési kód akkor lesz elküldve, ha a felhasználó duplán kattint egy sztringre a kombinált lista listájában. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_DROPDOWN	A CBN_DROPDOWN értesítési kód akkor lesz elküldve, amikor a kombinált lista listamezője láthatóvá válik. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_EDITCHANGE	A CBN_EDITCHANGE értesítési kód akkor lesz elküldve, ha a felhasználó olyan műveletet hajtott végre, amely esetleg módosította a kombinált lista szerkesztésvezérlő részének szövegét. A CBN_EDITUPDATE értesítési kóddal ellentétben ezt az értesítési kódot a rendszer a képernyő frissítése után küldi el. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_EDITUPDATE	A CBN_EDITUPDATE értesítési kód akkor lesz elküldve, ha a kombinált lista szerkesztésvezérlő része módosított szöveget jelenít meg. Ezt az értesítési kódot azután küldi el a rendszer, hogy a vezérlő formázta a szöveget, de mielőtt megjelenítené a szöveget. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_ERRSPACE	A CBN_ERRSPACE értesítési kód akkor lesz elküldve, ha egy kombinált lista nem tud elegendő memóriát lefoglalni egy adott kérés teljesítéséhez. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_KILLFOCUS	A CBN_KILLFOCUS értesítési kód akkor lesz elküldve, ha egy kombinált lista elveszíti a billentyűzet fókuszát. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_SELCHANGE	A CBN_SELCHANGE értesítési kód akkor lesz elküldve, amikor a felhasználó módosítja az aktuális kijelölést a kombinált lista listájában. A felhasználó a listamezőre kattintva vagy a nyílbillentyűkkel módosíthatja a kijelölést. A kombinált lista szülőablaka egy WM_COMMAND üzenet formájában kapja meg ezt az értesítést, amelyben CBN_SELCHANGE a wParam paraméter magasrendű szójában.
CBN_SELENDCANCEL	A CBN_SELENDCANCEL értesítési kód akkor lesz elküldve, amikor a felhasználó kiválaszt egy elemet, de egy másik vezérlőt jelöl ki, vagy bezárja a párbeszédpanelt. Azt jelzi, hogy a felhasználó kezdeti kijelölését figyelmen kívül kell hagyni. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_SELENDOK	A CBN_SELENDOK értesítési kód akkor lesz elküldve, amikor a felhasználó kiválaszt egy listaelemet, vagy kijelöl egy elemet, majd bezárja a listát. Ez azt jelzi, hogy a felhasználó kiválasztását fel kell dolgozni. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
CBN_SETFOCUS	A CBN_SETFOCUS értesítési kód akkor lesz elküldve, amikor egy kombinált lista megkapja a billentyűzet fókuszát. A kombinált lista szülőablaka a WM_COMMAND üzeneten keresztül kapja meg ezt az értesítési kódot.
WM_COMPAREITEM	A rendszer elküldi a WM_COMPAREITEM üzenetet egy új elem relatív pozíciójának meghatározásához a tulajdonos által rajzolt kombinált lista vagy lista rendezett listájában. Amikor az alkalmazás új elemet ad hozzá, a rendszer elküldi ezt az üzenetet a CBS_SORT vagy LBS_SORT stílussal létrehozott kombinált lista vagy lista tulajdonosának.
WM_DRAWITEM	A WM_DRAWITEM üzenetet a rendszer a tulajdonos által rajzolt gomb, kombinált lista, lista vagy menü szülőablakába küldi, ha a gomb, kombinált lista, lista vagy menü vizuális aspektusa megváltozott.
WM_MEASUREITEM	A WM_MEASUREITEM üzenet a vezérlő vagy menü létrehozásakor egy kombinált lista, listamező, listanézet vezérlőelem vagy menüelem tulajdonosablakába kerül.

Struktúrák

Téma	Tartalomjegyzék
COMBOBOXINFO	Kombinált lista állapotadatait tartalmazza.
COMPAREITEMSTRUCT	Egy rendezett, tulajdonos által rajzolt lista vagy kombinált lista két eleméhez adja meg az azonosítókat és az alkalmazás által megadott adatokat.
DRAWITEMSTRUCT	Megadja a tulajdonos ablakának szükséges információját annak meghatározásához, hogy miként festhet egy tulajdonos által rajzolt vezérlőt vagy menüelemet. A tulajdonos által rajzolt vezérlő vagy menüelem tulajdonosi ablaka a WM_DRAWITEM üzenet lParam paramétereként kap erre a struktúrára mutató mutatót.
MEASUREITEMSTRUCT	Tájékoztatja a rendszert egy tulajdonos által rajzolt vezérlő vagy menüelem méretéről. Ez lehetővé teszi, hogy a rendszer megfelelően dolgozza fel a vezérlővel való felhasználói interakciót.

Állandók

Téma	Tartalomjegyzék
kombinált listastílusok	Ha a CreateWindow vagy CreateWindowEx függvénnyel szeretne kombinált listát létrehozni, adja meg a COMBOBOX osztályt, a megfelelő ablakstílus-állandókat és a következő kombinált listastílusok kombinációját.