Megosztás a következőn keresztül:

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

  • Cikk

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.