Ovládací prvek RadioButtonGroup
Ovládací prvek RadioButtonGroup je skupina přepínačů. Umožňuje uživateli vybrat řetězec nebo celočíselnou hodnotu vlastnosti z předem určeného seznamu hodnot. Tento ovládací prvek můžete přidružit k vlastnosti zadáním názvu vlastnosti do sloupce Vlastnost Tabulka ovládacích prvků. Zadejte možné hodnoty pro výběr ve sloupci Hodnota tabulky RadioButton. Všimněte si, že zobrazený řetězec nemusí být nutně stejný jako hodnota, kterou uživatel zvolí.
Každý ovládací prvek RadioButtonGroup je přidružen k vlastnosti. Výchozí hodnota této vlastnosti musí být inicializována v Property tabulka . V rámci každé RadioButtonGroup zadané v Tabulka RadioButton, může existovat jeden přepínač, který má hodnotu v poli Value, která odpovídá výchozí hodnotě pro tuto vlastnost. Toto je výchozí tlačítko pro ovládací prvek RadioButtonGroup. Tlačítko Výchozí se zpočátku zobrazí jako vybrané v ovládacím prvku.
Všimněte si, že fokus na dialogovém okně nelze přesunout do ovládacího prvku RadioButtonGroup, dokud není vybrána některá z tlačítek ve skupině. Pokud chcete přesunout fokus na tuto skupinu tlačítek, zadejte jedno z tlačítek jako výchozí tlačítko skupiny.
Ovládací prvky RadioButtonGroup nastavily pouze hodnoty vlastností a nelze je použít k odeslání ControlEvent.
Implementace považuje celou skupinu za jeden ovládací prvek, proto není možné skrýt ani zakázat jednotlivá tlačítka ve skupině. Podobně musí být všechna tlačítka stejného stylu, to znamená, že všechny mají text nebo všechny mají rastrové obrázky (nebo jiné podobné funkce). Umístění tlačítek je vytvořené vzhledem ke skupině. Tímto způsobem lze celou skupinu přesunout tak, že změníte pouze souřadnice skupiny beze změny jednotlivých tlačítek. Při vytváření ovládacího prvku ověří, že jednotlivá tlačítka nepřesahují hranice skupiny.
Atributy ovládacího prvku
U tohoto ovládacího prvku můžete použít následující atributy. Pokud chcete změnit hodnotu atributu pomocí události, přihlaste se k odběru ovládacího prvku ControlEvent v tabulce EventMapping a vypište identifikátor atributu ve sloupci Atribut. Zadejte identifikátor ControlEvent ve sloupci Událost.
| Identifikátor atributu | Šestnáctkový bit | Popis |
|---|---|---|
| IndirectPropertyName | Toto je název nepřímé vlastnosti přidružené k ovládacímu prvku. Pokud je nastaven bit nepřímého atributu, ovládací prvek zobrazí nebo změní hodnotu vlastnosti s tímto názvem. Pokud je nastaven nepřímý atribut bit, tento název je také hodnota vlastnosti uvedené ve sloupci Vlastnost Control tabulka. | |
| pozice | Umístění ovládacího prvku v dialogovém okně Zadejte šířku, výšku a souřadnice ovládacího prvku do sloupců Width, Height, X a Y v tabulkyControl . Pro délku a vzdálenost použijte jednotky instalačního programu . |
|
| PropertyName | Toto je název vlastnosti přidružené k tomuto ovládacímu prvku. Pokud není nastaven bit nepřímého atributu, ovládací prvek zobrazí nebo změní hodnotu vlastnosti s tímto názvem. Tento atribut je určen ve sloupci Property tabulky Control. | |
| PropertyValue | Aktuální hodnota vlastnosti zobrazené nebo změněné tímto ovládacím prvku. Pokud není nastaven bit nepřímého atributu, jedná se o hodnotu PropertyName. Pokud je nastaven bit nepřímého atributu, jedná se o hodnotu IndirectPropertyName. Pokud se atribut změní, ovládací prvek odráží novou hodnotu. | |
| textové | Tento atribut ovládacího prvku může určit text zobrazený ovládacím prvku, obrázek uložený v binární tabulce nebo obrázek nastavený za běhu. Chcete-li zadat text, zadejte textový řetězec do sloupce Text tabulky Ovládací prvek. Pokud chcete nastavit písmo a styl písma tohoto textu, zadejte před řetězec zobrazených znaků {\style} nebo {&styl}. Kde styl je identifikátor uvedený ve sloupci TextStyle tabulky TextStyle tabulky. Pokud žádná z těchto možností není k dispozici, ale DefaultUIFont vlastnost je definována jako platný styl textu, použije se toto písmo. Pokud chcete zadat ikonu nebo rastrový obrázek uložený v Binární tabulka zadejte primární klíč záznamu obrázku ze sloupce Name (Název) binární tabulky do sloupce Text Control table záznamu ovládacího prvku. |
|
| viditelných | 0x00000000 0x00000001 |
Skrytý ovládací prvek. Viditelný ovládací prvek. Tento bit zahrňte do bitového slova sloupce Atributy v řídicí tabulce, aby byl ovládací prvek viditelný nebo skrytý při jeho vytvoření. Ovládací prvek můžete také skrýt nebo zobrazit pomocí tabulky ControlCondition. |
| Povoleno | 0x00000000 0x00000002 |
Řízení v zakázaném stavu Řízení v povoleném stavu Tento bit zahrňte do sloupce Atributy ovládacího prvku, aby bylo možné ovládací prvek při vytváření povolit. Ovládací prvek můžete také povolit nebo zakázat pomocí tabulky ControlCondition. |
| sunken | 0x00000000 0x00000004 |
Zobrazí výchozí vizuální styl. Zobrazí ovládací prvek se sunkenem, prostorovým vzhledem. Zahrňte tyto bity do bitového slova ve sloupci Atributy tabulky Control. |
| nepřímých | 0x00000000 0x00000008 |
Ovládací prvek zobrazí nebo změní hodnotu vlastnosti ve sloupci Vlastnost tabulky Control. Ovládací prvek zobrazí nebo změní hodnotu vlastnosti, která má identifikátor uvedený ve sloupci Vlastnost tabulky Control. Určuje, zda vlastnost přidružená k tomuto ovládacího prvku je nepřímo odkazována. |
| celočíselná | 0x00000000 0x00000010 |
Vlastnost přidružená k ovládacího prvku je řetězcová hodnota. Vlastnost přidružená k ovládacího prvku je celočíselná hodnota. Tento bit zahrňte do bitového slova sloupce Atributy tabulky Control nastavit tento atribut při vytváření ovládacího prvku. |
| RTLRO | 0x00000000 0x00000020 |
Text v ovládacím prvku se zobrazí v pořadí čtení zleva doprava. Text v ovládacím prvku se zobrazí v pořadí čtení zprava doleva. |
| RightAligned | 0x00000000 0x00000040 |
Text v ovládacím prvku je zarovnaný doleva. Text v ovládacím prvku je zarovnaný doprava. |
| PushLike | 0x00000000 0x00020000 |
Ovládací prvek je nakreslen obvyklým vzhledem. Ovládací prvek má styl BS_PUSHLIKE a je nakreslený tak, aby se zobrazoval jako tlačítko. Tento bit zahrňte do bitového slova sloupce Atributy tabulky Control nastavit tento atribut při vytváření ovládacího prvku. |
| bitmapové | 0x00000000 0x00040000 |
Text v ovládacím prvku je zadán ve sloupci Text v Řídicí tabulka. Ovládací prvek má BS_BITMAP styl, text v ovládacím prvku se nahradí rastrovým obrázkem. Sloupec Text v tabulce Control se používá jako cizí klíč binární tabulky. Tento bit zahrňte do bitového slova ve sloupci Atributy tabulky Control. Nenastavujte bity stylu Icon a Bitmap současně. Tlačítko nemůže obsahovat rastrový obrázek i text. Pokud chcete nastavit písmo a styl písma textového řetězce, předponu řetězce zobrazených znaků zadejte {\style} nebo {&styl}. Kde styl je identifikátor uvedený ve sloupci TextStyle tabulky TextStyle tabulky. Pokud žádná z těchto možností není k dispozici, ale DefaultUIFont vlastnost je definována jako platný styl textu, použije se toto písmo. |
| ikony | 0x00000000 0x00080000 |
Text v ovládacím prvku je zadán ve sloupci Text v Řídicí tabulka. Ovládací prvek má styl BS_ICON, text v ovládacím prvku se nahradí obrázkem ikony. Sloupec Text v tabulce Control se používá jako cizí klíč binární tabulky. Tento bit zahrňte do bitového slova ve sloupci Atributy tabulky Control. Nenastavujte bity Icon a Bitmap současně. Tlačítko nemůže obsahovat obrázek ikony i text. Pokud chcete nastavit písmo a styl písma textového řetězce, předponu řetězce zobrazených znaků zadejte {\style} nebo {&styl}. Kde styl je identifikátor uvedený ve sloupci TextStyle tabulky TextStyle tabulky. Pokud žádná z těchto možností není k dispozici, ale DefaultUIFont vlastnost je definována jako platný styl textu, použije se toto písmo. |
| FixedSize | 0x00000000 0x00100000 |
Roztáhněte obrázek ikony tak, aby odpovídal ovládacímu prvku. Oříznout nebo zacentrovat obrázek ikony v ovládacím prvku Tento bit zahrňte do bitového slova sloupce Atributy tabulky Control. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Načte první obrázek. Načte první obrázek 16x16. Načte první obrázek 32x32. Načte první obrázek 48x48. Soubor ikony může obsahovat různé velikosti obrázků stejné ikony. Do sloupce Atributy tabulky Control zahrňte hodnotu odpovídajícího bitového slova. Pokud tyto bity nejsou nastaveny, instalační program ignoruje atribut FixedSize a obrázek se roztáhne tak, aby odpovídal obdélníku ovládacího prvku. Pokud jsou nastaveny bity IconSize i bity FixedSize, obrázek menší než ovládací prvek je zarovnaný na střed a obrázek je větší než ovládací prvek, který se zmenšuje tak, aby se vešl. |
| HasBorder | nenastavil 0x01000000 |
Bez ohraničení a bez textu. Zobrazí ohraničení a text. Do bitového slova ve sloupci Atributy ovládacího prvku Ovládací prvek zahrňte 16777216, aby se zobrazilo ohraničení a text. |
Poznámky
Vzhledem ke způsobu, jakým Windows vykresluje rámeček, je mezi horní částí okna ovládacího prvku a viditelným rámečkem mezera, i když není žádný titulek.
Tento ovládací prvek lze vytvořit z BUTTON třídy pomocí funkce CreateWindowEx. Pokud je nastaven HasBorder bit, má styl BS_GROUPBOX, jinak má styl BS_OWNERDRAW.
Ovládací prvek RadioButtonGroup by neměl překrývat jiné ovládací prvky a jiné ovládací prvky by neměly překrývat RadioButtonGroup. Překrývající se tento ovládací prvek a jiný může způsobit nesprávné fungování nebo zobrazení ovládacích prvků. Chcete-li poskytnout programy čtečky obrazovky s extra popisným textem o ovládacím prvku RadioButtonGroup, postupujte podle příkladu uvedeného v Přidání nadbytečného textu k přepínačům.