RadioButtonGroup-kontroll
RadioButtonGroup-kontrollen är en grupp med alternativknappar. Det gör att användaren kan välja ett sträng- eller heltalsvärde för en egenskap från en fördefinierad lista med värden. Du kan associera den här kontrollen med en egenskap genom att ange egenskapens namn i kolumnen Egenskap i tabellen Control. Ange möjliga värden för markering i kolumnen Värde i tabellen RadioButton. Observera att strängen som visas inte nödvändigtvis är samma som värdet som användaren väljer.
Varje RadioButtonGroup-kontroll är associerad med en egenskap. Standardvärdet för den här egenskapen måste initieras i tabellen Egenskap. Inom varje RadioButtonGroup som anges i tabellen RadioButtonkan det finnas en alternativknapp som har ett värde i fältet Värde som matchar standardvärdet för den här egenskapen. Det här är standardknappen för RadioButtonGroup-kontrollen. Knappen Standard visas ursprungligen som markerad i kontrollen.
Observera att fokus på en dialogruta inte kan flyttas till en RadioButtonGroup-kontroll förrän en av knapparna i gruppen har valts. Om du vill flytta fokus till den här knappgruppen anger du en av knapparna som standardknapp för gruppen.
RadioButtonGroup-kontroller anger endast egenskapsvärden och kan inte användas för att skicka en ControlEvent-.
Implementeringen behandlar hela gruppen som en kontroll, därför går det inte att dölja eller inaktivera enskilda knappar i gruppen. På samma sätt måste alla knappar vara av samma formatmall, dvs. antingen har alla text eller så har alla bitmappar (eller andra liknande funktioner). Knapparnas position är skapad i förhållande till gruppen. På så sätt kan hela gruppen flyttas genom att endast ändra koordinaterna för gruppen utan att ändra de enskilda knapparna. När kontrollen skapas verifieras att de enskilda knapparna inte sträcker sig utanför gruppens gränser.
Kontrollattribut
Du kan använda följande attribut med den här kontrollen. Om du vill ändra värdet för ett attribut med hjälp av en händelse prenumererar du på kontrollen till en ControlEvent i tabellen EventMapping och listar attributets identifierare i kolumnen Attribut. Ange identifieraren för ControlEvent i kolumnen Händelse.
| Attributidentifierare | Hexadecimal bit | Beskrivning |
|---|---|---|
| IndirectPropertyName | Det här är namnet på en indirekt egenskap som är associerad med kontrollen. Om den indirekta attributbiten har angetts visar eller ändrar kontrollen värdet för egenskapen med det här namnet. Om biten Indirekt attribut anges är det här namnet också värdet för egenskapen som anges i kolumnen Egenskap i tabellen Control. | |
| position | Kontrollens position i dialogrutan. Ange kontrollens bredd, höjd och koordinater i kontrollens vänstra hörn i kolumnerna Width, Height, X och Y i tabellen Control. Använd installationsenheter för längd och avstånd. |
|
| PropertyName | Det här är namnet på egenskapen som är associerad med den här kontrollen. Om den indirekta attributbiten inte har angetts visar eller ändrar kontrollen värdet för egenskapen med det här namnet. Det här attributet anges i kolumnen Egenskap i tabellen Control. | |
| PropertyValue | Aktuellt värde för egenskapen som visas eller ändras av den här kontrollen. Om biten Indirect attribute inte har angetts är det värdet för PropertyName. Om biten Indirect attribute har angetts är det värdet indirectPropertyName. Om attributet ändras återspeglar kontrollen det nya värdet. | |
| Text | Det här kontrollattributet kan ange den text som visas av kontrollen, en bild som lagras i binärtabellen eller en bilduppsättning vid körning. Om du vill ange text anger du textsträngen i kolumnen Text i tabellen Control. Om du vill ange teckensnittet och teckensnittsformatet för den här texten prefixar du strängen med tecken som visas med {\style} eller {&formatmall}. Där formatmallen är en identifierare i kolumnen TextStyle i tabellen TextStyle. Om ingen av dessa finns, men egenskapen DefaultUIFont definieras som ett giltigt textformat, används det teckensnittet. Om du vill ange en ikon eller bitmappsbild som lagras i tabellen Binär anger du den primära nyckeln för bildens post från kolumnen Namn i den binära tabellen i kolumnen Text i tabellen Control för kontrollen. |
|
| synlig | 0x00000000 0x00000001 |
Dold kontroll. Synlig kontroll. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control för att göra kontrollen synlig eller dold när den skapas. Du kan också dölja eller visa en kontroll med hjälp av tabellen ControlCondition. |
| aktiverat | 0x00000000 0x00000002 |
Kontroll i inaktiverat tillstånd. Kontroll i ett aktiverat tillstånd. Inkludera den här biten i kolumnen Attribut i Control för att aktivera kontrollen när du skapar den. Du kan också aktivera eller inaktivera en kontroll med hjälp av tabellen ControlCondition. |
| nedsänkt | 0x00000000 0x00000004 |
Visar standardformatet för visuella objekt. Visar kontrollen med en nedsänkt 3D-look. Inkludera dessa bitar i bitordet i kolumnen Attribut i tabellen Control. |
| Indirekt | 0x00000000 0x00000008 |
Kontrollen visar eller ändrar värdet för egenskapen i kolumnen Egenskap i tabellen Control. Kontrollen visar eller ändrar värdet för egenskapen som innehåller identifieraren i kolumnen Egenskap i tabellen Kontroll. Avgör om egenskapen som är associerad med den här kontrollen refereras indirekt. |
| Heltal | 0x00000000 0x00000010 |
Egenskapen som är associerad med kontrollen är ett strängvärde. Egenskapen som är associerad med kontrollen är ett heltalsvärde. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control för att ange det här attributet när kontrollen skapas. |
| RTLRO- | 0x00000000 0x00000020 |
Text i kontrollen visas i läsordning från vänster till höger. Text i kontrollen visas i läsordning från höger till vänster. |
| RightAligned | 0x00000000 0x00000040 |
Texten i kontrollen är justerad till vänster. Texten i kontrollen är justerad till höger. |
| PushLike- | 0x00000000 0x00020000 |
Kontrollen ritas med sitt vanliga utseende. Kontrollen har BS_PUSHLIKE formatmall och ritas för att visas som en push-knapp. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control för att ange det här attributet när kontrollen skapas. |
| Bitmapp | 0x00000000 0x00040000 |
Text i kontrollen anges i kolumnen Text i tabellen Control. Kontrollen har BS_BITMAP formatmall, text i kontrollen ersätts av en bitmappsbild. Kolumnen Text i tabellen Control används som sekundärnyckel till binär tabell. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control. Ställ inte in bitarna i ikon- och bitmappsformat samtidigt. Knappen får inte innehålla både en bitmappsbild och text. Om du vill ange teckensnittet och teckensnittsformatet för en textsträng prefixar du strängen med tecken som visas med {\style} eller {&formatmall}. Där formatmallen är en identifierare i kolumnen TextStyle i tabellen TextStyle. Om ingen av dessa finns, men egenskapen DefaultUIFont definieras som ett giltigt textformat, används det teckensnittet. |
| ikon | 0x00000000 0x00080000 |
Text i kontrollen anges i kolumnen Text i tabellen Control. Kontrollen har BS_ICON formatmall. Texten i kontrollen ersätts av en ikonbild. Kolumnen Text i tabellen Control används som sekundärnyckel till binär tabell. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control. Ställ inte in ikon- och bitmappsbitarna samtidigt. Knappen får inte innehålla både en ikonbild och text. Om du vill ange teckensnittet och teckensnittsformatet för en textsträng prefixar du strängen med tecken som visas med {\style} eller {&formatmall}. Där formatmallen är en identifierare i kolumnen TextStyle i tabellen TextStyle. Om ingen av dessa finns, men egenskapen DefaultUIFont definieras som ett giltigt textformat, används det teckensnittet. |
| FixedSize | 0x00000000 0x00100000 |
Sträck ut ikonbilden så att den passar kontrollen. Beskär eller centrera ikonbilden i kontrollen. Inkludera den här biten i bitordet i kolumnen Attribut i tabellen Control. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Läser in den första bilden. Läser in den första 16x16-avbildningen. Läser in den första 32x32-avbildningen. Läser in den första 48x48-avbildningen. En ikonfil kan innehålla olika storleksbilder av samma ikon. Inkludera värdet för lämpligt bitord i kolumnen Attribut i tabellen Control Om dessa bitar inte har angetts ignorerar installationsprogrammet attributet FixedSize och avbildningen sträcks ut så att den passar kontrollrektangeln. Om både IconSize-bitar och FixedSize-bitar har angetts är en bild som är mindre än kontrollen centrerad och en bild är större än den kontroll som den krymper för att passa. |
| HasBorder | inte 0x01000000 |
Ingen kantlinje och ingen text. Visar kantlinje och text. Ta med 16777216 i bitordet i kolumnen Attribut i Control för att visa en kantlinje och text. |
Anmärkningar
På grund av hur Windows ritar ramen finns det ett mellanrum mellan kontrollens överkant och den synliga ramen, även när det inte finns någon bildtext.
Den här kontrollen kan skapas från klassen BUTTON med hjälp av funktionen CreateWindowEx. Om HasBorder bit har angetts har den BS_GROUPBOX formatmallen, annars har den BS_OWNERDRAW formatmallen.
RadioButtonGroup-kontrollen bör inte överlappa andra kontroller och andra kontroller bör inte överlappa en RadioButtonGroup. Överlappning av den här kontrollen och en annan kan göra att kontrollerna fungerar eller visas felaktigt. Om du vill ge skärmläsarprogram extra beskrivande text om en RadioButtonGroup-kontroll följer du exemplet i Lägga till extra text i alternativknappar.