RadioButtonGroup Control
Het besturingselement RadioButtonGroup is een groep keuzerondjes. Hiermee kan de gebruiker een tekenreeks of geheel getal voor een eigenschap selecteren in een vooraf bepaalde lijst met waarden. U kunt dit besturingselement koppelen aan een eigenschap door de naam van de eigenschap in te voeren in de kolom Eigenschap van de tabel Control. Geef de mogelijke waarden op voor selectie in de kolom Waarde van de tabel RadioButton. Houd er rekening mee dat de weergegeven tekenreeks niet noodzakelijkerwijs dezelfde is als de waarde die de gebruiker kiest.
Elk besturingselement RadioButtonGroup is gekoppeld aan een eigenschap. De standaardwaarde voor deze eigenschap moet worden geïnitialiseerd in de tabel Eigenschap. Binnen elke RadioButtonGroup die is opgegeven in de tabel RadioButton, is er mogelijk één keuzerondje met een waarde in het veld Waarde die overeenkomt met de standaardwaarde voor deze eigenschap. Dit is de standaardknop voor het besturingselement RadioButtonGroup. De knop Standaard wordt in eerste instantie weergegeven als geselecteerd in het besturingselement.
Houd er rekening mee dat de focus op een dialoogvenster niet kan worden verplaatst naar een besturingselement RadioButtonGroup totdat een van de knoppen in de groep is geselecteerd. Als u de focus naar deze knopgroep wilt verplaatsen, geeft u een van de knoppen op als standaardknop voor de groep.
RadioButtonGroup-besturingselementen stellen alleen eigenschapswaarden in en kunnen niet worden gebruikt om een ControlEvent-te verzenden.
De implementatie behandelt de hele groep als één besturingselement, daarom is het niet mogelijk om afzonderlijke knoppen in de groep te verbergen of uit te schakelen. Op dezelfde manier moeten alle knoppen dezelfde stijl hebben, dat wil gezegd: ze hebben allemaal tekst of allemaal hebben bitmaps (of andere vergelijkbare functies). De positie van de knoppen is gemaakt ten opzichte van de groep. Op deze manier kan de hele groep worden verplaatst door alleen de coördinaten van de groep te wijzigen zonder de afzonderlijke knoppen te wijzigen. Bij het maken van het besturingselement wordt gecontroleerd of de afzonderlijke knoppen niet buiten de grenzen van de groep worden uitgebreid.
Besturingskenmerken
U kunt de volgende kenmerken gebruiken met dit besturingselement. Als u de waarde van een kenmerk wilt wijzigen met behulp van een gebeurtenis, abonneert u het besturingselement op een ControlEvent in de EventMapping-tabel en vermeldt u de id van het kenmerk in de kolom Kenmerk. Voer de id in van de ControlEvent in de kolom Gebeurtenis.
| Kenmerk-id | Hexadecimale bit | Beschrijving |
|---|---|---|
| IndirectPropertyName | Dit is de naam van een indirecte eigenschap die is gekoppeld aan het besturingselement. Als de bit van het indirecte kenmerk is ingesteld, wordt in het besturingselement de waarde van de eigenschap met deze naam weergegeven of gewijzigd. Als de bit van het indirecte kenmerk is ingesteld, is deze naam ook de waarde van de eigenschap die wordt vermeld in de kolom Eigenschap van de Control-tabel. | |
| positie | Positie van het besturingselement in het dialoogvenster. Voer de breedte, hoogte en coördinaten van het besturingselement in de linkerhoek van het besturingselement in de kolommen Breedte, Hoogte, X en Y van de Control-tabel in. Gebruik installatie-eenheden voor lengte en afstand. |
|
| PropertyName- | Dit is de naam van de eigenschap die aan dit besturingselement is gekoppeld. Als de bit van het indirecte kenmerk niet is ingesteld, wordt in het besturingselement de waarde van de eigenschap met deze naam weergegeven of gewijzigd. Dit kenmerk wordt opgegeven in de kolom Eigenschap van de Control-tabel. | |
| PropertyValue- | Huidige waarde van de eigenschap die door dit besturingselement wordt weergegeven of gewijzigd. Als de indirecte kenmerk-bit niet is ingesteld, is dit de waarde van PropertyName. Als de bit van het indirecte kenmerk is ingesteld, is dit de waarde van IndirectPropertyName. Als het kenmerk wordt gewijzigd, geeft het besturingselement de nieuwe waarde weer. | |
| tekst | Met dit besturingselementkenmerk kunt u de tekst opgeven die wordt weergegeven door het besturingselement, een afbeelding die is opgeslagen in de binaire tabel of een afbeelding die tijdens runtime is ingesteld. Als u tekst wilt opgeven, typt u de tekenreeks in de kolom Tekst van de Control-tabel. Als u het lettertype en de tekenstijl van deze tekst wilt instellen, moet u de tekenreeks van weergegeven tekens voorafzetten met {\style} of {&stijl}. Waar stijl een id is die wordt vermeld in de kolom TextStyle van de tabel TextStyle. Als geen van deze aanwezig is, maar de eigenschap DefaultUIFont is gedefinieerd als een geldige tekststijl, wordt dat lettertype gebruikt. Als u een pictogram of bitmapafbeelding wilt opgeven die is opgeslagen in de binaire tabel voert u de primaire sleutel van de record van de afbeelding in de kolom Naam van de binaire tabel in de kolom Tekst van de Control-tabel record voor het besturingselement in. |
|
| zichtbare | 0x00000000 0x00000001 |
Verborgen besturingselement. Zichtbaar besturingselement. Neem deze bit op in het bitwoord van de kolom Kenmerken in de tabel Control om het besturingselement zichtbaar of verborgen te maken. U kunt een besturingselement ook verbergen of weergeven met behulp van de tabel ControlCondition. |
| ingeschakelde | 0x00000000 0x00000002 |
Besturingselement met een uitgeschakelde status. Besturingselement in een ingeschakelde status. Neem deze bit op in de kolom Kenmerken van de Control om het besturingselement bij het maken in te schakelen. U kunt een besturingselement ook in- of uitschakelen met behulp van de tabel ControlCondition. |
| 0x00000000 0x00000004 |
Hiermee wordt de standaardvisualstijl weergegeven. Geeft het besturingselement weer met een gezonken, 3D, look. Neem deze bits op in het bitwoord in de kolom Kenmerken van de Control-tabel. |
|
| indirect | 0x00000000 0x00000008 |
Het besturingselement geeft de waarde van de eigenschap weer of wijzigt deze in de kolom Eigenschap van de tabel Control. Het besturingselement geeft de waarde weer of wijzigt de waarde van de eigenschap met de id die wordt vermeld in de kolom Eigenschap van de tabel Control. Bepaalt of de eigenschap die aan dit besturingselement is gekoppeld indirect wordt verwezen. |
| geheel getal | 0x00000000 0x00000010 |
De eigenschap die aan het besturingselement is gekoppeld, is een tekenreekswaarde. De eigenschap die aan het besturingselement is gekoppeld, is een geheel getal. Neem deze bit op in het bitwoord van de kolom Kenmerken van de tabel Control om dit kenmerk in te stellen bij het maken van het besturingselement. |
| RTLRO- | 0x00000000 0x00000020 |
Tekst in het besturingselement wordt weergegeven in de leesrichting van links naar rechts. Tekst in het besturingselement wordt weergegeven in de leesrichting van rechts naar links. |
| rechts uitgelijnde | 0x00000000 0x00000040 |
Tekst in het besturingselement wordt links uitgelijnd. Tekst in het besturingselement wordt rechts uitgelijnd. |
| PushLike- | 0x00000000 0x00020000 |
Controle wordt getekend met zijn gebruikelijke uiterlijk. Het besturingselement heeft de BS_PUSHLIKE stijl en wordt getekend om te worden weergegeven als een drukknop. Neem deze bit op in het bitwoord van de kolom Kenmerken van de tabel Control om dit kenmerk in te stellen bij het maken van het besturingselement. |
| bitmap | 0x00000000 0x00040000 |
Tekst in het besturingselement wordt opgegeven in de kolom Tekst van de tabel Control. Het besturingselement heeft de BS_BITMAP stijl, tekst in het besturingselement wordt vervangen door een bitmapafbeelding. De kolom Tekst in de Control-tabel wordt gebruikt als refererende sleutel voor de binaire tabel. Neem deze bit op in het bitwoord in de kolom Kenmerken van de Control-tabel. Stel de bits van de pictogram- en bitmapstijl niet tegelijk in. De knop mag geen bitmapafbeelding en tekst bevatten. Als u het lettertype en de tekenstijl van een tekenreeks wilt instellen, moet u de tekenreeks van weergegeven tekens voorafzetten met {\style} of {&stijl}. Waar stijl een id is die wordt vermeld in de kolom TextStyle van de tabel TextStyle. Als geen van deze aanwezig is, maar de eigenschap DefaultUIFont is gedefinieerd als een geldige tekststijl, wordt dat lettertype gebruikt. |
| pictogram | 0x00000000 0x00080000 |
Tekst in het besturingselement wordt opgegeven in de kolom Tekst van de tabel Control. Het besturingselement heeft de stijl BS_ICON, tekst in het besturingselement wordt vervangen door een pictogramafbeelding. De kolom Tekst in de Control-tabel wordt gebruikt als refererende sleutel voor de binaire tabel. Neem deze bit op in het bitwoord in de kolom Kenmerken van de Control-tabel. Stel de pictogram- en bitmap-bits niet tegelijk in. De knop mag geen pictogramafbeelding en tekst bevatten. Als u het lettertype en de tekenstijl van een tekenreeks wilt instellen, moet u de tekenreeks van weergegeven tekens voorafzetten met {\style} of {&stijl}. Waar stijl een id is die wordt vermeld in de kolom TextStyle van de tabel TextStyle. Als geen van deze aanwezig is, maar de eigenschap DefaultUIFont is gedefinieerd als een geldige tekststijl, wordt dat lettertype gebruikt. |
| FixedSize | 0x00000000 0x00100000 |
Stretch the icon image to fit the control. De pictogramafbeelding in het besturingselement bijsnijden of centreren. Neem deze bit op in het bitwoord van de kolom Kenmerken van de Control-tabel. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Laadt de eerste afbeelding. Laadt de eerste 16x16-afbeelding. Laadt de eerste 32x32 afbeelding. Laadt de eerste afbeelding van 48x48. Een pictogrambestand kan verschillende grootteafbeeldingen van hetzelfde pictogram bevatten. Neem de waarde van het juiste bitwoord op in de kolom Kenmerken van de Control-tabel Als deze bits niet zijn ingesteld, negeert het installatieprogramma het kenmerk FixedSize en wordt de afbeelding uitgerekt zodat deze past bij de rechthoek van het besturingselement. Als zowel de IconSize-bits als de FixedSize-bits zijn ingesteld, wordt een afbeelding kleiner dan het besturingselement gecentreerd en is een afbeelding groter dan het besturingselement dat het passend is. |
| HasBorder- | 0x01000000 niet is ingesteld |
Geen rand en geen tekst. Hiermee worden rand en tekst weergegeven. Neem 16777216 op in het bitwoord in de kolom Kenmerken van het Besturingselement om een rand en tekst weer te geven. |
Opmerkingen
Vanwege de manier waarop Windows het frame tekent, is er een tussenruimte tussen de bovenkant van het venster van het besturingselement en het zichtbare frame, zelfs als er geen bijschrift is.
Dit besturingselement kan worden gemaakt op basis van de klasse BUTTON met behulp van de functie CreateWindowEx. Als de HasBorder bit is ingesteld, heeft deze de BS_GROUPBOX stijl, anders heeft deze de BS_OWNERDRAW stijl.
Het besturingselement RadioButtonGroup mag geen andere besturingselementen overlappen en andere besturingselementen mogen geen RadioButtonGroup overlappen. Het overlappen van dit besturingselement en een andere kan ertoe leiden dat de besturingselementen werken of onjuist worden weergegeven. Als u programma's voor schermlezers wilt voorzien van extra beschrijvende tekst over een Besturingselement RadioButtonGroup, volgt u het voorbeeld in Extra tekst toevoegen aan keuzerondjes.