Gomb (Windows-vezérlők)
Ez a szakasz a gombvezérlőkkel használt programozási elemekről tartalmaz információkat. A gomb egy olyan vezérlő, a gombra kattintva adhat bemenetet egy alkalmazásnak.
Áttekintés
| Téma | Tartalomjegyzék |
|---|---|
| gombüzenetek | Ez a témakör a gombokkal használt üzeneteket ismerteti. |
| gombállapotok | Ez a szakasz azt ismerteti, hogyan változtatja meg a gomb állapotát és az alkalmazás válaszát. |
| gombtípusok | Ez a témakör a gombok különböző típusait ismerteti. |
| Gombok használata | Ez a szakasz bemutatja, hogyan hajthat végre gombokkal kapcsolatos bizonyos feladatokat. |
Funkciók
| Téma | Tartalomjegyzék |
|---|---|
| CheckDlgButton | Módosítja egy gombvezérlő ellenőrzési állapotát. |
| CheckRadioButton | Pipát ad hozzá egy adott választógombhoz (ellenőrzi) egy csoportban, és eltávolítja a pipát a csoport összes többi választógombjáról (törli). |
| IsDlgButtonChecked | Az IsDlgButtonChecked függvény határozza meg, hogy a gombvezérlő be van-e jelölve, vagy egy háromállapotú gombvezérlő van-e bejelölve, nincs bejelölve vagy meghatározatlan. |
Makrók
| Téma | Tartalomjegyzék |
|---|---|
| Button_Enable | Engedélyezi vagy letiltja a gombot. |
| Button_GetCheck | Beolvashatja a választógomb vagy a jelölőnégyzet állapotát. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BM_GETCHECK üzenetet. |
| Button_GetIdealSize | Lekéri a szöveghez és a képhez leginkább illő gomb méretét, ha van képlista. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BCM_GETIDEALSIZE üzenetet. |
| Button_GetImageList | Lekéri a gombvezérlőhöz beállított képlistát leíró BUTTON_IMAGELIST struktúrát. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BCM_GETIMAGELIST üzenetet. |
| Button_GetNote | Lekéri a parancshivatkozás gombhoz társított jegyzet szövegét. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BCM_GETNOTE üzenetet. |
| Button_GetNoteLength | Lekéri a parancshivatkozás leírásában megjeleníthető jegyzetszöveg hosszát. Használja ezt a makrót, vagy küldje el kifejezetten a BCM_GETNOTELENGTH üzenetet. |
| Button_GetSplitInfo | Lekéri a megadott felosztott gomb vezérlőelem adatait. Használja ezt a makrót, vagy küldje el kifejezetten a BCM_GETSPLITINFO üzenetet. |
| Button_GetState | Beolvashatja a választógomb vagy a jelölőnégyzet állapotát. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BM_GETSTATE üzenetet. |
| Button_GetText | Lekéri egy gomb szövegét. |
| Button_GetTextLength | A gomb szövegében szereplő karakterek számát adja meg. |
| Button_GetTextMargin | Lekéri a gombvezérlő szövegének rajzolásához használt margókat. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BCM_GETTEXTMARGIN üzenetet. |
| Button_SetCheck | A választógomb vagy a jelölőnégyzet jelölőnégyzetének beállítása. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BM_SETCHECK üzenetet. |
| Button_SetDropDownState | Egy adott gomb legördülő állapotát állítja be BS_SPLITBUTTONstílussal. Használja ezt a makrót, vagy küldje el kifejezetten a BCM_SETDROPDOWNSTATE üzenetet. |
| Button_SetElevationRequiredState | Beállítja a jogosultságszint-emeléshez szükséges állapotot egy adott gombhoz vagy parancshivatkozáshoz egy emelt szintű ikon megjelenítéséhez. Használja ezt a makrót, vagy küldje el kifejezetten a BCM_SETSHIELD üzenetet. |
| Button_SetImageList | Képlistát rendel egy gombvezérlőhöz. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BCM_SETIMAGELIST üzenetet. |
| Button_SetNote | Beállítja a megadott parancshivatkozás gombhoz társított jegyzet szövegét. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BCM_SETNOTE üzenetet. |
| Button_SetSplitInfo | Egy megadott felosztott gomb vezérlőelem adatait adja meg. Használja ezt a makrót, vagy küldje el kifejezetten a BCM_SETSPLITINFO üzenetet. |
| Button_SetState | Egy gomb kiemelési állapotát állítja be. A kiemelési állapot azt jelzi, hogy a gomb ki van-e emelve, mintha a felhasználó leküldte volna. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BM_SETSTATE üzenetet. |
| Button_SetStyle | Egy gomb stílusának beállítása. Használhatja ezt a makrót, vagy kifejezetten elküldheti a BM_SETSTYLE üzenetet. |
| Button_SetText | Egy gomb szövegének beállítása. |
| Button_SetTextMargin | Beállítja a szöveg rajzmargóit egy gombvezérlőben. Ezt a makrót használhatja, vagy kifejezetten elküldheti a BCM_SETTEXTMARGIN üzenetet. |
Üzenetek
| Téma | Tartalomjegyzék |
|---|---|
| BCM_GETIDEALSIZE | Lekéri annak a gombnak a méretét, amely a legjobban illik a szövegéhez és a képéhez, ha egy képlista van jelen. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_GetIdealSize makrót. |
| BCM_GETIMAGELIST | Lekéri a gombvezérlőhöz rendelt képlistát leíró BUTTON_IMAGELIST struktúrát. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_GetImageList makrót. |
| BCM_GETNOTE | Lekéri a parancshivatkozás gombhoz társított jegyzet szövegét. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_GetNote makrót. |
| BCM_GETNOTELENGTH | Lekéri a parancshivatkozás gomb leírásában megjeleníthető jegyzetszöveg hosszát. Küldje el ezt az üzenetet explicit módon vagy a Button_GetNoteLength makró használatával. |
| BCM_GETSPLITINFO | Információ lekéri a felosztott gomb vezérlőelemet. Küldje el ezt az üzenetet explicit módon vagy a Button_GetSplitInfo makró használatával. |
| BCM_GETTEXTMARGIN | Lekéri a gombvezérlő szövegének rajzolásához használt margókat. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_GetTextMargin makrót. |
| BCM_SETDROPDOWNSTATE | A TBSTYLE_DROPDOWNstílust tartalmazó gomb legördülő állapotát állítja be. Küldje el ezt az üzenetet explicit módon vagy a Button_SetDropDownState makró használatával. |
| BCM_SETIMAGELIST | Képlistát rendel egy gombvezérlőhöz. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_SetImageList makrót. |
| BCM_SETNOTE | Beállítja a parancshivatkozás gombhoz társított jegyzet szövegét. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_SetNote makrót. |
| BCM_SETSHIELD | Beállítja a jogosultságszint-emeléshez szükséges állapotot egy adott gombhoz vagy parancshivatkozáshoz egy emelt szintű ikon megjelenítéséhez. Küldje el ezt az üzenetet explicit módon vagy a Button_SetElevationRequiredState makró használatával. |
| BCM_SETSPLITINFO | A felosztott gomb vezérlőelem adatait adja meg. Küldje el ezt az üzenetet explicit módon vagy a Button_SetSplitInfo makró használatával. |
| BCM_SETTEXTMARGIN | A BCM_SETTEXTMARGIN üzenet egy gombvezérlőben beállítja a szöveg rajzolása margóit. |
| BM_CLICK | Szimulálja a felhasználót, aki egy gombra kattint. Az üzenet hatására a gomb megkapja a WM_LBUTTONDOWN és WM_LBUTTONUP üzeneteket, a gomb szülőablakában pedig egy BN_CLICKED értesítési kódot kap. |
| BM_GETCHECK | Beolvashatja a választógomb vagy a jelölőnégyzet állapotát. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_GetCheck makrót. |
| BM_GETIMAGE | Lekéri a gombhoz társított képhez (ikonhoz vagy bitképhez) tartozó fogópontot. |
| BM_GETSTATE | Lekéri egy gomb vagy jelölőnégyzet állapotát. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_GetState makrót. |
| BM_SETCHECK | A választógomb vagy a jelölőnégyzet jelölőnégyzetének beállítása. Ezt az üzenetet explicit módon vagy a Button_SetCheck makró használatával is elküldheti. |
| BM_SETDONTCLICK | Beállít egy jelölőt egy választógombon, amely szabályozza BN_CLICKED üzenetek létrehozását, amikor a gomb fókuszba kerül. |
| BM_SETIMAGE | Új képet (ikont vagy bitképet) társít a gombhoz. |
| BM_SETSTATE | Egy gomb kiemelési állapotát állítja be. A kiemelési állapot azt jelzi, hogy a gomb ki van-e emelve, mintha a felhasználó leküldte volna. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_SetState makrót. |
| BM_SETSTYLE | Egy gomb stílusának beállítása. Ezt az üzenetet explicit módon is elküldheti, vagy használhatja a Button_SetStyle makrót. |
Értesítések
| Téma | Tartalomjegyzék |
|---|---|
| BCN_DROPDOWN | Elküldve, amikor a felhasználó egy legördülő nyílra kattint egy gombra. A vezérlő szülőablaka WM_NOTIFY üzenet formájában kapja meg ezt az értesítési kódot. |
| BCN_HOTITEMCHANGE | Értesíti a gombvezérlő tulajdonosát, hogy az egér belép vagy elhagyja a gombvezérlő ügyfélterületét. A gombvezérlő ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el. |
| BN_CLICKED | Elküldve, amikor a felhasználó rákattint egy gombra. A gomb szülőablaka a WM_COMMAND üzeneten keresztül fogadja a BN_CLICKED értesítési kódot. |
| BN_DBLCLK | Elküldve, amikor a felhasználó duplán kattint egy gombra. A rendszer automatikusan elküldi ezt az értesítési kódot BS_USERBUTTON, BS_RADIOBUTTONés BS_OWNERDRAW gombokhoz. Más gombtípusok csak akkor küldenek BN_DBLCLK, ha BS_NOTIFY stílussal rendelkeznek. A gomb szülőablaka a WM_COMMAND üzeneten keresztül fogadja a BN_DBLCLK értesítési kódot. |
| BN_DISABLE | Egy gomb letiltásakor küldve.
Megjegyzés: Ez az értesítési kód csak a Windows 3.0-s verziónál korábbi, 16 bites verzióival való kompatibilitás érdekében érhető el. Az alkalmazásoknak a BS_OWNERDRAW gombstílust és a DRAWITEMSTRUCT struktúrát kell használniuk ehhez a feladathoz. A gomb szülőablaka a BN_DISABLE értesítési kódot fogadja a WM_COMMAND üzeneten keresztül. |
| BN_DOUBLECLICKED | Elküldve, amikor a felhasználó duplán kattint egy gombra. A rendszer automatikusan elküldi ezt az értesítési kódot BS_USERBUTTON, BS_RADIOBUTTONés BS_OWNERDRAW gombokhoz. Más gombtípusok csak akkor küldenek BN_DOUBLECLICKED, ha BS_NOTIFY stílussal rendelkeznek. A gomb szülőablaka a WM_COMMAND üzeneten keresztül fogadja a BN_DOUBLECLICKED értesítési kódot. |
| BN_HILITE | Elküldve, amikor a felhasználó kiválaszt egy gombot.
Megjegyzés: Ez az értesítési kód csak a Windows 3.0-s verziónál korábbi, 16 bites verzióival való kompatibilitás érdekében érhető el. Az alkalmazásoknak a BS_OWNERDRAW gombstílust és a DRAWITEMSTRUCT struktúrát kell használniuk ehhez a feladathoz. A gomb szülőablaka a WM_COMMAND üzeneten keresztül fogadja az BN_HILITE értesítési kódot. |
| BN_KILLFOCUS | Akkor lesz elküldve, ha egy gomb elveszíti a billentyűzetfókuszt. Az értesítési kód elküldéséhez a gombnak BS_NOTIFY stílussal kell rendelkeznie. A gomb szülőablaka a BN_KILLFOCUS értesítési kódot kapja az WM_COMMAND üzeneten keresztül. |
| BN_PAINT | Elküldve, ha egy gombot meg kell festeni.
Megjegyzés: Ez az értesítési kód csak a Windows 3.0-s verziónál korábbi, 16 bites verzióival való kompatibilitás érdekében érhető el. Az alkalmazásoknak a BS_OWNERDRAW gombstílust és a DRAWITEMSTRUCT struktúrát kell használniuk ehhez a feladathoz. A gomb szülőablaka az WM_COMMAND üzeneten keresztül fogadja a BN_PAINT értesítési kódot. |
| BN_PUSHED | Akkor küldi el, ha egy gomb leküldéses állapota leküldésre van állítva.
Megjegyzés: Ez az értesítési kód csak a Windows 3.0-s verziónál korábbi, 16 bites verzióival való kompatibilitás érdekében érhető el. Az alkalmazásoknak a BS_OWNERDRAW gombstílust és a DRAWITEMSTRUCT struktúrát kell használniuk ehhez a feladathoz. A gomb szülőablaka a BN_PUSHED értesítési kódot fogadja az WM_COMMAND üzeneten keresztül. |
| BN_SETFOCUS | Akkor küldve, amikor egy gomb megkapja a billentyűzet fókuszát. Az értesítési kód elküldéséhez a gombnak BS_NOTIFY stílussal kell rendelkeznie. A gomb szülőablaka a BN_SETFOCUS értesítési kódot fogadja az WM_COMMAND üzeneten keresztül. |
| BN_UNHILITE | Elküldve, ha a kiemelést el kell távolítani egy gombból.
Megjegyzés: Ez az értesítési kód csak a Windows 3.0-s verziónál korábbi, 16 bites verzióival való kompatibilitás érdekében érhető el. Az alkalmazásoknak a BS_OWNERDRAW gombstílust és a DRAWITEMSTRUCT struktúrát kell használniuk ehhez a feladathoz. A gomb szülőablaka a WM_COMMAND üzeneten keresztül fogadja a BN_UNHILITE értesítési kódot. |
| BN_UNPUSHED | Akkor küldi el, ha egy gomb leküldéses állapota le van állítva.
Megjegyzés: Ez az értesítési kód csak a Windows 3.0-s verziónál korábbi, 16 bites verzióival való kompatibilitás érdekében érhető el. Az alkalmazásoknak a BS_OWNERDRAW gombstílust és a DRAWITEMSTRUCT struktúrát kell használniuk ehhez a feladathoz. A gomb szülőablaka az BN_UNPUSHED értesítési kódot fogadja a WM_COMMAND üzeneten keresztül. |
| NM_CUSTOMDRAW (gomb) | Értesíti a gomb vezérlőelem szülőablakát a gomb egyéni rajzműveleteiről. A gombvezérlő ezt az értesítési kódot WM_NOTIFY üzenet formájában küldi el. |
| WM_CTLCOLORBTN | A WM_CTLCOLORBTN üzenetet a gomb szülőablakában küldi el a rendszer a gomb rajzolása előtt. A szülőablak módosíthatja a gomb szövegét és háttérszíneit. Az üzenetet feldolgozó szülőablakra azonban csak a tulajdonos által rajzolt gombok válaszolnak. |
Struktúrák
| Téma | Tartalomjegyzék |
|---|---|
| BUTTON_IMAGELIST | A gombvezérlővel használt képlistával kapcsolatos információkat tartalmaz. |
| BUTTON_SPLITINFO | Az osztott gombot (BS_SPLITBUTTON és BS_DEFSPLITBUTTON stílusokat) meghatározó információkat tartalmaz. Az BCM_GETSPLITINFO és BCM_SETSPLITINFO üzenetekhez használható. |
| NMBCDROPDOWN | Egy BCN_DROPDOWN értesítés adatait tartalmazza. |
| NMBCHOTITEM | Információkat tartalmaz az egér egy gombvezérlőre való áthelyezéséről. |
Állandók
| Téma | Tartalomjegyzék |
|---|---|
| gombstílusok | Gombstílusok kombinációját adja meg. Ha a Gomb osztály használatával hoz létre gombot a CreateWindow vagy CreateWindowEx függvénnyel, az alább felsorolt gombstílusok bármelyikét megadhatja. |