Sdílet prostřednictvím

Button (ovládací prvky Windows)

  • Článek

Tato část obsahuje informace o programovacích prvcích používaných s ovládacími prvky tlačítek. Tlačítko je ovládací prvek, na který může uživatel kliknout a zadat vstup do aplikace.

Přehledy

Námět Obsah
zpráv tlačítek Toto téma popisuje zprávy, které se používají s tlačítky.
Stavy tlačítek Tato část popisuje, jak výběr tlačítka změní jeho stav a jak má aplikace reagovat.
typy tlačítek Toto téma popisuje různé druhy tlačítek.
použití tlačítek Tato část vysvětluje, jak provádět určité úlohy spojené s tlačítky.

Funkce

Námět Obsah
CheckDlgButton Změní stav zaškrtnutí ovládacího prvku tlačítka.
CheckRadioButton Přidá značku zaškrtnutí (kontroluje) zadaný přepínač ve skupině a odebere značku zaškrtnutí (vymaže) všechna ostatní přepínače ve skupině.
IsDlgButtonChecked Funkce IsDlgButtonChecked určuje, zda je ovládací prvek tlačítka zaškrtnutý nebo zda je zaškrtnuté, nezaškrtnuté nebo nedeterminované ovládací prvek tlačítka se třemi stavy.

Makra

Námět Obsah
Button_Enable Povolí nebo zakáže tlačítko.
Button_GetCheck Získá stav zaškrtnutí přepínače nebo zaškrtávacího políčka. Toto makro můžete použít nebo odeslat zprávu BM_GETCHECK explicitně.
Button_GetIdealSize Získá velikost tlačítka, které nejlépe odpovídá textu a obrázku, pokud je k dispozici seznam obrázků. Toto makro můžete použít nebo odeslat zprávu BCM_GETIDEALSIZE explicitně.
Button_GetImageList Získá BUTTON_IMAGELIST strukturu, která popisuje seznam obrázků, který je nastaven pro ovládací prvek tlačítka. Toto makro můžete použít nebo odeslat zprávu BCM_GETIMAGELIST explicitně.
Button_GetNote Získá text poznámky přidružené k příkazovému tlačítku odkazu. Toto makro můžete použít nebo odeslat zprávu BCM_GETNOTE explicitně.
Button_GetNoteLength Získá délku textu poznámky, který může být zobrazen v popisu odkazu příkazu. Toto makro použijte nebo odešlete zprávu BCM_GETNOTELENGTH explicitně.
Button_GetSplitInfo Získá informace pro zadaný ovládací prvek rozděleného tlačítka. Toto makro použijte nebo odešlete zprávu BCM_GETSPLITINFO explicitně.
Button_GetState Získá stav zaškrtnutí přepínače nebo zaškrtávacího políčka. Toto makro můžete použít nebo odeslat zprávu BM_GETSTATE explicitně.
Button_GetText Získá text tlačítka.
Button_GetTextLength Získá počet znaků v textu tlačítka.
Button_GetTextMargin Získá okraje použité k kreslení textu v ovládacím prvku tlačítka. Toto makro můžete použít nebo odeslat zprávu BCM_GETTEXTMARGIN explicitně.
Button_SetCheck Nastaví stav zaškrtnutí přepínače nebo zaškrtávacího políčka. Toto makro můžete použít nebo odeslat zprávu BM_SETCHECK explicitně.
Button_SetDropDownState Nastaví rozevírací seznam pro zadané tlačítko se stylem BS_SPLITBUTTON. Použijte toto makro nebo explicitně odešlete zprávu BCM_SETDROPDOWNSTATE.
Button_SetElevationRequiredState Nastaví požadovaný stav zvýšení oprávnění pro zadané tlačítko nebo odkaz na příkaz, aby se zobrazila ikona se zvýšenými oprávněními. Toto makro použijte nebo odešlete zprávu BCM_SETSHIELD explicitně.
Button_SetImageList Přiřadí seznam obrázků ovládacímu prvku tlačítko. Toto makro můžete použít nebo odeslat zprávu BCM_SETIMAGELIST explicitně.
Button_SetNote Nastaví text poznámky přidružené k zadanému příkazovému tlačítku odkazu. Toto makro můžete použít nebo odeslat zprávu BCM_SETNOTE explicitně.
Button_SetSplitInfo Nastaví informace pro zadaný ovládací prvek rozděleného tlačítka. Toto makro použijte nebo odešlete zprávu BCM_SETSPLITINFO explicitně.
Button_SetState Nastaví stav zvýraznění tlačítka. Stav zvýraznění označuje, jestli je tlačítko zvýrazněné, jako kdyby ho uživatel nasdílil. Toto makro můžete použít nebo odeslat zprávu BM_SETSTATE explicitně.
Button_SetStyle Nastaví styl tlačítka. Toto makro můžete použít nebo odeslat zprávu BM_SETSTYLE explicitně.
Button_SetText Nastaví text tlačítka.
Button_SetTextMargin Nastaví okraje pro kreslení textu v ovládacím prvku tlačítka. Toto makro můžete použít nebo odeslat zprávu BCM_SETTEXTMARGIN explicitně.

Zprávy

Námět Obsah
BCM_GETIDEALSIZE Získá velikost tlačítka, které nejlépe odpovídá jeho textu a obrázku, pokud je k dispozici seznam obrázků. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_GetIdealSize.
BCM_GETIMAGELIST Získá BUTTON_IMAGELIST strukturu, která popisuje seznam obrázků přiřazený ovládacímu prvku tlačítko. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_GetImageList.
BCM_GETNOTE Získá text poznámky přidružené k příkazovému tlačítku odkazu. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_GetNote.
BCM_GETNOTELENGTH Získá délku textu poznámky, který může být zobrazen v popisu příkazového odkazu tlačítko. Odešlete tuto zprávu explicitně nebo pomocí makra Button_GetNoteLength.
BCM_GETSPLITINFO Získá informace pro ovládací prvek rozděleného tlačítka. Odešlete tuto zprávu explicitně nebo pomocí makra Button_GetSplitInfo.
BCM_GETTEXTMARGIN Získá okraje použité k kreslení textu v ovládacím prvku tlačítka. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_GetTextMargin.
BCM_SETDROPDOWNSTATE Nastaví rozevírací seznam tlačítka se stylem TBSTYLE_DROPDOWN. Odešlete tuto zprávu explicitně nebo pomocí makra Button_SetDropDownState.
BCM_SETIMAGELIST Přiřadí seznam obrázků ovládacímu prvku tlačítko. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_SetImageList.
BCM_SETNOTE Nastaví text poznámky přidružené k příkazovému tlačítku odkazu. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_SetNote.
BCM_SETSHIELD Nastaví požadovaný stav zvýšení oprávnění pro zadané tlačítko nebo odkaz na příkaz, aby se zobrazila ikona se zvýšenými oprávněními. Odešlete tuto zprávu explicitně nebo pomocí makra Button_SetElevationRequiredState.
BCM_SETSPLITINFO Nastaví informace pro ovládací prvek rozděleného tlačítka. Odešlete tuto zprávu explicitně nebo pomocí makra Button_SetSplitInfo.
BCM_SETTEXTMARGIN Zpráva BCM_SETTEXTMARGIN nastaví okraje pro kreslení textu v ovládacím prvku tlačítka.
BM_CLICK Simuluje uživatele, který klikne na tlačítko. Tato zpráva způsobí, že tlačítko obdrží WM_LBUTTONDOWN a WM_LBUTTONUP zprávy a nadřazené okno tlačítka obdrží kód oznámení BN_CLICKED.
BM_GETCHECK Získá stav zaškrtnutí přepínače nebo zaškrtávacího políčka. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_GetCheck.
BM_GETIMAGE Načte úchyt obrázku (ikony nebo rastrového obrázku) přidruženého k tlačítku.
BM_GETSTATE Načte stav tlačítka nebo zaškrtávacího políčka. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_GetState.
BM_SETCHECK Nastaví stav zaškrtnutí přepínače nebo zaškrtávacího políčka. Tuto zprávu můžete odeslat explicitně nebo pomocí makra Button_SetCheck.
BM_SETDONTCLICK Nastaví příznak na přepínači, který řídí generování BN_CLICKED zpráv, když tlačítko obdrží fokus.
BM_SETIMAGE Přidruží k tlačítku nový obrázek (ikonu nebo rastrový obrázek).
BM_SETSTATE Nastaví stav zvýraznění tlačítka. Stav zvýraznění označuje, jestli je tlačítko zvýrazněné, jako kdyby ho uživatel nasdílil. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_SetState.
BM_SETSTYLE Nastaví styl tlačítka. Tuto zprávu můžete odeslat explicitně nebo použít makro Button_SetStyle.

Upozornění

Námět Obsah
BCN_DROPDOWN Odesláno, když uživatel klikne na šipku rozevíracího seznamu na tlačítku. Nadřazené okno ovládacího prvku obdrží tento kód oznámení ve formě WM_NOTIFY zprávy.
BCN_HOTITEMCHANGE Upozorní vlastníka ovládacího prvku tlačítka, že myš zadává nebo opouští klientskou oblast ovládacího prvku tlačítka. Ovládací prvek tlačítka odešle tento kód oznámení ve formě WM_NOTIFY zprávy.
BN_CLICKED Odesláno, když uživatel klikne na tlačítko.
Nadřazené okno tlačítka obdrží kód oznámení BN_CLICKED prostřednictvím zprávy WM_COMMAND.
BN_DBLCLK Odesláno, když uživatel dvakrát klikne na tlačítko. Tento kód oznámení se odesílá automaticky pro tlačítka BS_USERBUTTON, BS_RADIOBUTTONa BS_OWNERDRAW. Ostatní typy tlačítek odesílají BN_DBLCLK jenom v případě, že mají styl BS_NOTIFY.
Nadřazené okno tlačítka obdrží kód oznámení BN_DBLCLK prostřednictvím zprávy WM_COMMAND.
BN_DISABLE Odesláno, když je tlačítko zakázané. Poznámka: Tento kód oznámení je poskytován pouze z důvodu kompatibility s 16bitovými verzemi Windows staršími než verze 3.0. Aplikace by měly pro tuto úlohu používat styl tlačítka BS_OWNERDRAW a strukturuDRAWITEMSTRUCT.
Nadřazené okno tlačítka obdrží kód oznámení BN_DISABLE prostřednictvím WM_COMMAND zprávy.
BN_DOUBLECLICKED Odesláno, když uživatel dvakrát klikne na tlačítko. Tento kód oznámení se odesílá automaticky pro tlačítka BS_USERBUTTON, BS_RADIOBUTTONa BS_OWNERDRAW. Ostatní typy tlačítek odesílají BN_DOUBLECLICKED jenom v případě, že mají styl BS_NOTIFY.
Nadřazené okno tlačítka obdrží kód oznámení BN_DOUBLECLICKED prostřednictvím WM_COMMAND zprávy.
BN_HILITE Odesláno, když uživatel vybere tlačítko. Poznámka: Tento kód oznámení je poskytován pouze z důvodu kompatibility s 16bitovými verzemi Windows staršími než verze 3.0. Aplikace by měly pro tuto úlohu používat styl tlačítka BS_OWNERDRAW a strukturuDRAWITEMSTRUCT.
Nadřazené okno tlačítka obdrží kód oznámení BN_HILITE prostřednictvím zprávy WM_COMMAND.
BN_KILLFOCUS Odesláno, když tlačítko ztratí fokus klávesnice. Tlačítko musí mít styl BS_NOTIFY k odeslání tohoto kódu oznámení.
Nadřazené okno tlačítka obdrží kód oznámení BN_KILLFOCUS prostřednictvím zprávy WM_COMMAND.
BN_PAINT Odesláno, když má být tlačítko malováno. Poznámka: Tento kód oznámení je poskytován pouze z důvodu kompatibility s 16bitovými verzemi Windows staršími než verze 3.0. Aplikace by měly pro tuto úlohu používat styl tlačítka BS_OWNERDRAW a strukturuDRAWITEMSTRUCT.
Nadřazené okno tlačítka obdrží kód oznámení BN_PAINT prostřednictvím WM_COMMAND zprávy.
BN_PUSHED Odesláno, když je stav nabízení tlačítka nastaven na nasdílení. Poznámka: Tento kód oznámení je poskytován pouze z důvodu kompatibility s 16bitovými verzemi Windows staršími než verze 3.0. Aplikace by měly pro tuto úlohu používat styl tlačítka BS_OWNERDRAW a strukturuDRAWITEMSTRUCT.
Nadřazené okno tlačítka obdrží kód oznámení BN_PUSHED prostřednictvím WM_COMMAND zprávy.
BN_SETFOCUS Odesláno, když tlačítko obdrží fokus klávesnice. Tlačítko musí mít styl BS_NOTIFY k odeslání tohoto kódu oznámení.
Nadřazené okno tlačítka obdrží kód oznámení BN_SETFOCUS prostřednictvím WM_COMMAND zprávy.
BN_UNHILITE Odesláno, když má být zvýraznění odebráno z tlačítka. Poznámka: Tento kód oznámení je poskytován pouze z důvodu kompatibility s 16bitovými verzemi Windows staršími než verze 3.0. Aplikace by měly pro tuto úlohu používat styl tlačítka BS_OWNERDRAW a strukturuDRAWITEMSTRUCT.
Nadřazené okno tlačítka obdrží kód oznámení BN_UNHILITE prostřednictvím zprávy WM_COMMAND.
BN_UNPUSHED Odesláno, když je stav nasdílení tlačítka nastaven na nepushed. Poznámka: Tento kód oznámení je poskytován pouze z důvodu kompatibility s 16bitovými verzemi Windows staršími než verze 3.0. Aplikace by měly pro tuto úlohu používat styl tlačítka BS_OWNERDRAW a strukturuDRAWITEMSTRUCT.
Nadřazené okno tlačítka obdrží kód oznámení BN_UNPUSHED prostřednictvím WM_COMMAND zprávy.
NM_CUSTOMDRAW (tlačítko) Upozorní nadřazené okno ovládacího prvku tlačítka o vlastních operacích kreslení na tlačítku.
Ovládací prvek tlačítka odešle tento kód oznámení ve formě WM_NOTIFY zprávy.
WM_CTLCOLORBTN Zpráva WM_CTLCOLORBTN se před nakreslením tlačítka odešle do nadřazeného okna tlačítka. Nadřazené okno může změnit barvu textu a pozadí tlačítka. Tato zpráva ale zpracovává pouze tlačítka nakreslená vlastníkem.

Struktury

Námět Obsah
BUTTON_IMAGELIST Obsahuje informace o seznamu obrázků, který se používá s ovládacím tlačítkem.
BUTTON_SPLITINFO Obsahuje informace definující tlačítko rozdělení (stylyBS_SPLITBUTTON a BS_DEFSPLITBUTTON). Používá se se zprávami BCM_GETSPLITINFO a BCM_SETSPLITINFO.
NMBCDROPDOWN Obsahuje informace o BCN_DROPDOWN oznámení.
NMBCHOTITEM Obsahuje informace o pohybu myši nad ovládacím prvku tlačítka.

Konstanty

Námět Obsah
styly tlačítek Určuje kombinaci stylů tlačítek. Pokud vytvoříte tlačítko pomocí třídy BUTTON s CreateWindow nebo CreateWindowEx funkce, můžete zadat některý z níže uvedených stylů tlačítek.