Controllo RadioButtonGroup

Il controllo RadioButtonGroup è un gruppo di pulsanti di opzione. Consente all'utente di selezionare una stringa o un valore intero per una proprietà da un elenco predeterminato di valori. È possibile associare questo controllo a una proprietà immettendo il nome della proprietà nella colonna Proprietà della tabella Control. Specificare i valori possibili per la selezione nella colonna Valore della tabella RadioButton. Si noti che la stringa visualizzata non corrisponde necessariamente al valore scelto dall'utente.

Ogni controllo RadioButtonGroup è associato a una proprietà . Il valore predefinito per questa proprietà deve essere inizializzato nella tabella Property. All'interno di ogni RadioButtonGroup specificato nella tabella RadioButton, potrebbe essere presente un pulsante di opzione con un valore nel campo Valore che corrisponde al valore predefinito per questa proprietà. Questo è il pulsante predefinito per il controllo RadioButtonGroup. Il pulsante Predefinito viene inizialmente visualizzato come selezionato nel controllo .

Si noti che lo stato attivo su una finestra di dialogo non può essere spostato in un controllo RadioButtonGroup fino a quando non è stato selezionato uno dei pulsanti del gruppo. Per spostare lo stato attivo su questo gruppo di pulsanti, specificare uno dei pulsanti come pulsante predefinito per il gruppo.

I controlli RadioButtonGroup impostano solo i valori delle proprietà e non possono essere utilizzati per inviare un oggetto ControlEvent.

L'implementazione considera l'intero gruppo come un unico controllo, pertanto non è possibile nascondere o disabilitare singoli pulsanti all'interno del gruppo. Analogamente, tutti i pulsanti devono essere dello stesso stile, ovvero tutti hanno testo o tutti hanno bitmap (o altre funzionalità simili). La posizione dei pulsanti viene creata in relazione al gruppo. In questo modo l'intero gruppo può essere spostato modificando solo le coordinate del gruppo senza modificare i singoli pulsanti. Al momento della creazione, il controllo verifica che i singoli pulsanti non si estendono oltre i limiti del gruppo.

Attributi di controllo

È possibile usare gli attributi seguenti con questo controllo. Per modificare il valore di un attributo usando un evento, sottoscrivere il controllo a un Oggetto ControlEvent nella tabella EventMapping ed elencare l'identificatore dell'attributo nella colonna Attribute. Immettere l'identificatore dell'evento ControlEvent nella colonna Evento.

Identificatore dell'attributo	Bit esadecimale	Descrizione
IndirectPropertyName		Si tratta del nome di una proprietà indiretta associata al controllo . Se il bit dell'attributo indiretto è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Se il bit dell'attributo indiretto è impostato, questo nome corrisponde anche al valore della proprietà elencata nella colonna Proprietà della tabella Control.
Posizione		Posizione del controllo nella finestra di dialogo. Immettere la larghezza, l'altezza e le coordinate del controllo nell'angolo sinistro del controllo nelle colonne Width, Height, X e Y della tabella Control. Usare le unità di installazione per lunghezza e distanza.
PropertyName		Si tratta del nome della proprietà associata a questo controllo. Se il bit dell'attributo indiretto non è impostato, il controllo visualizza o modifica il valore della proprietà con questo nome. Questo attributo viene specificato nella colonna Property della tabella Control.
PropertyValue		Valore corrente della proprietà visualizzata o modificata da questo controllo. Se il bit dell'attributo indiretto non è impostato, questo è il valore di PropertyName. Se il bit dell'attributo indiretto è impostato, questo è il valore di IndirectPropertyName. Se l'attributo viene modificato, il controllo riflette il nuovo valore.
Text		Questo attributo di controllo può specificare il testo visualizzato dal controllo, un'immagine archiviata nella tabella binaria o un set di immagini in fase di esecuzione. Per specificare il testo, immettere la stringa di testo nella colonna Testo della tabella Control. Per impostare il tipo di carattere e lo stile del carattere di questo testo, anteporre la stringa dei caratteri visualizzati con {\style} o {&style}. Dove style è un identificatore elencato nella colonna TextStyle della tabella TextStyle. Se nessuno di questi elementi è presente, ma la proprietà DefaultUIFont è definita come uno stile di testo valido, verrà utilizzato tale tipo di carattere. Per specificare un'icona o un'immagine bitmap archiviata nella tabella Binaria, immettere la chiave primaria del record dell'immagine dalla colonna Name della tabella Binary nella colonna Text del record della tabella Control per il controllo.
Visible	0x00000000 0x00000001	Controllo nascosto. Controllo visibile. Includere questo bit nella parola bit della colonna Attributes della tabella Control per rendere visibile o nascosto il controllo al momento della creazione. È anche possibile nascondere o visualizzare un controllo tramite la tabella ControlCondition.
Abilitato	0x00000000 0x00000002	Controllo in uno stato disabilitato. Controllo in uno stato abilitato. Includere questo bit nella colonna Attributi del controllo per abilitare il controllo alla creazione. È anche possibile abilitare o disabilitare un controllo tramite la tabella ControlCondition.
Affondata	0x00000000 0x00000004	Visualizza lo stile di visualizzazione predefinito. Visualizza il controllo con un aspetto incassato, 3D. Includere questi bit nella parola bit nella colonna Attributi della tabella Control.
Indiretto	0x00000000 0x00000008	Il controllo visualizza o modifica il valore della proprietà nella colonna Proprietà della tabella Control. Il controllo visualizza o modifica il valore della proprietà con l'identificatore elencato nella colonna Proprietà della tabella Control. Determina se alla proprietà associata a questo controllo viene fatto riferimento indirettamente.
Integer	0x00000000 0x00000010	La proprietà associata al controllo è un valore stringa. La proprietà associata al controllo è un valore intero. Includere questo bit nella parola bit della colonna Attributes della tabella Control per impostare questo attributo alla creazione del controllo.
RTLRO	0x00000000 0x00000020	Il testo nel controllo viene visualizzato in ordine di lettura da sinistra a destra. Il testo nel controllo viene visualizzato in ordine di lettura da destra a sinistra.
RightAligned	0x00000000 0x00000040	Il testo nel controllo è allineato a sinistra. Il testo nel controllo è allineato a destra.
PushLike	0x00000000 0x00020000	Il controllo viene disegnato con il suo aspetto consueto. Il controllo ha lo stile BS_PUSHLIKE e viene disegnato per essere visualizzato come pulsante di pressione. Includere questo bit nella parola bit della colonna Attributes della tabella Control per impostare questo attributo alla creazione del controllo.
Bitmap	0x00000000 0x00040000	Il testo nel controllo viene specificato nella colonna Testo della tabella Control. Il controllo ha lo stile BS_BITMAP, il testo nel controllo viene sostituito da un'immagine bitmap. La colonna Text nella tabella Control viene utilizzata come chiave esterna per la tabella Binaria. Includere questo bit nella parola bit nella colonna Attributes della tabella Control. Non impostare contemporaneamente i bit di stile Icona e Bitmap. Il pulsante non può contenere sia un'immagine bitmap che un testo. Per impostare il tipo di carattere e lo stile del carattere di una stringa di testo, anteporre la stringa dei caratteri visualizzati con {\style} o {&style}. Dove style è un identificatore elencato nella colonna TextStyle della tabella TextStyle. Se nessuno di questi elementi è presente, ma la proprietà DefaultUIFont è definita come uno stile di testo valido, verrà utilizzato tale tipo di carattere.
Icona	0x00000000 0x00080000	Il testo nel controllo viene specificato nella colonna Testo della tabella Control. Il controllo ha lo stile BS_ICON, il testo nel controllo viene sostituito da un'immagine icona. La colonna Text nella tabella Control viene utilizzata come chiave esterna per la tabella Binaria. Includere questo bit nella parola bit nella colonna Attributes della tabella Control. Non impostare contemporaneamente i bit Icon e Bitmap. Il pulsante non può contenere sia un'immagine dell'icona che un testo. Per impostare il tipo di carattere e lo stile del carattere di una stringa di testo, anteporre la stringa dei caratteri visualizzati con {\style} o {&style}. Dove style è un identificatore elencato nella colonna TextStyle della tabella TextStyle. Se nessuno di questi elementi è presente, ma la proprietà DefaultUIFont è definita come uno stile di testo valido, verrà utilizzato tale tipo di carattere.
FixedSize	0x00000000 0x00100000	Estendere l'immagine dell'icona per adattarsi al controllo. Ritagliare o allineare al centro l'immagine dell'icona nel controllo . Includere questo bit nella parola bit della colonna Attributes della tabella Control.
IconSize	0x00000000 0x00200000 0x00400000 0x00600000	Carica la prima immagine. Carica la prima immagine 16x16. Carica la prima immagine 32x32. Carica la prima immagine 48x48. Un file icona può contenere immagini di dimensioni diverse della stessa icona. Includere il valore della parola di bit appropriata nella colonna Attributi della tabella Control Se questi bit non sono impostati, il programma di installazione ignora l'attributo FixedSize e l'immagine viene estesa per adattarsi al rettangolo di controllo. Se vengono impostati sia i bit IconSize che i bit FixedSize, un'immagine più piccola del controllo è allineata al centro e un'immagine è più grande del controllo che viene ridotta per adattarsi.
HasBorder	non impostare 0x01000000	Nessun bordo e nessun testo. Visualizza bordo e testo. Includere 16777216 nella parola bit nella colonna Attributi del controllo per visualizzare un bordo e un testo.

 

Osservazioni:

A causa del modo in cui Windows disegna il frame, c'è un divario tra la parte superiore della finestra del controllo e la cornice visibile, anche quando non c'è didascalia.

Questo controllo può essere creato dalla classe BUTTON usando la funzione CreateWindowEx. Se il bit HasBorder è impostato, ha lo stile BS_GROUPBOX , in caso contrario ha lo stile BS_OWNERDRAW .

Il controllo RadioButtonGroup non deve sovrapporsi ad altri controlli e altri controlli non devono sovrapporsi a radioButtonGroup. La sovrapposizione di questo controllo e un altro può causare il funzionamento o la visualizzazione non corretta dei controlli. Per fornire programmi per la lettura dello schermo con testo descrittivo aggiuntivo su un controllo RadioButtonGroup, seguire l'esempio fornito in Aggiunta di testo aggiuntivo ai pulsanti di opzione.