Control RadioButtonGroup
El control RadioButtonGroup es un grupo de botones de radio. Permite al usuario seleccionar un valor de cadena o entero para una propiedad de una lista predeterminada de valores. Para asociar este control a una propiedad, escriba el nombre de la propiedad en la columna Property de la tabla Control. Especifique los valores posibles para la selección en la columna Value de la tabla RadioButton. Tenga en cuenta que la cadena que se muestra no es necesariamente la misma que el valor que elige el usuario.
Cada control RadioButtonGroup está asociado a una propiedad. El valor predeterminado de esta propiedad debe inicializarse en la tabla Property. Dentro de cada RadioButtonGroup especificado en la tabla RadioButton, puede haber un botón de radio que tenga un valor en el campo Value que coincida con el valor predeterminado de esta propiedad. Este es el botón predeterminado para el control RadioButtonGroup. El botón Predeterminado se muestra inicialmente como seleccionado en el control.
Tenga en cuenta que el foco en un cuadro de diálogo no puede moverse a un control RadioButtonGroup hasta que se haya seleccionado uno de los botones del grupo. A fin de que el foco se mueva a este grupo de botones, especifique uno de los botones como botón predeterminado para el grupo.
Los controles RadioButtonGroup solo establecen valores de propiedad y no se pueden usar para enviar un ControlEvent.
La implementación trata todo el grupo como un control, por lo que no es posible ocultar ni deshabilitar botones individuales en el grupo. De igual modo, todos los botones tienen que ser del mismo estilo, es decir, todos ellos tienen texto o todos ellos tienen mapas de bits (u otras características similares). La posición de los botones se crea en relación con el grupo. De esta forma, todo el grupo se puede mover cambiando solo las coordenadas del grupo sin cambiar los botones individuales. Al crear el control se comprueba que los botones individuales no se extiendan más allá de los límites del grupo.
Atributos de control
Puede usar los atributos siguientes con este control. Para cambiar el valor de un atributo mediante un evento, suscriba el control a un ControlEvent en la tabla EventMapping y enumere el identificador del atributo en la columna Attribute. Escriba el identificador de ControlEvent en la columna Event.
| Identificador de atributo | Bit hexadecimal | Descripción |
|---|---|---|
| IndirectPropertyName | Este es el nombre de una propiedad indirecta asociada al control. Si se establece el bit de atributo indirecto, el control muestra o cambia el valor de la propiedad que tiene este nombre. Si se establece el bit de atributo indirecto, este nombre también es el valor de la propiedad que aparece en la columna Property de la tabla Control. | |
| Posición | Posición del control en el cuadro de diálogo. Especifique el ancho, el alto y las coordenadas del control de la esquina izquierda del control en las columnas Width, Height, X e Y de la tabla Control. Use unidades del instalador para la longitud y la distancia. |
|
| PropertyName | Este es el nombre de la propiedad asociada a este control. Si no se establece el bit de atributo indirecto, el control muestra o cambia el valor de la propiedad que tiene este nombre. Este atributo se especifica en la columna Property de la tabla Control. | |
| PropertyValue | Valor actual de la propiedad mostrada o modificada por este control. Si no se establece el bit de atributo Indirect, este es el valor de PropertyName. Si se establece el bit de atributo Indirect, este es el valor de IndirectPropertyName. Si el atributo cambia, el control refleja el nuevo valor. | |
| Texto | Este atributo de control puede especificar el texto que muestra el control, una imagen almacenada en la tabla Binary o un conjunto de imágenes en tiempo de ejecución. Para especificar texto, escriba la cadena de texto en la columna Text de la tabla Control. Para establecer la fuente y el estilo de fuente de este texto, anteponga {\style} o {&style} a la cadena de caracteres mostrados. Donde style es un identificador que aparece en la columna TextStyle de la tabla TextStyle. Si ninguno de estos elementos está presente, pero la propiedad DefaultUIFont se define como un estilo de texto válido, se usará esa fuente. Para especificar un icono o una imagen de mapa de bits almacenada en la tabla Binary, escriba la clave principal del registro de la imagen de la columna Name de la tabla Binary en la columna Text del registro de la tabla Control para el control. |
|
| Visible | 0x00000000 0x00000001 |
Control oculto. Control visible. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control para que el control esté visible u oculto al crearlo. Un control se puede ocultar o mostrar también mediante la tabla ControlCondition. |
| Enabled | 0x00000000 0x00000002 |
Control en estado deshabilitado. Control en estado habilitado. Incluya este bit en la columna Atributos del control para habilitar el control al crearlo. También puede habilitar o deshabilitar un control mediante la tabla ControlCondition. |
| Sunken | 0x00000000 0x00000004 |
Muestra el estilo visual predeterminado. Muestra el control con un aspecto 3D, con profundidad. Incluya estos bits en la palabra de bit de la columna Attributes de la tabla Control. |
| Indirecto | 0x00000000 0x00000008 |
El control muestra o cambia el valor de la propiedad en la columna Property de la tabla Control. El control muestra o cambia el valor de la propiedad que tiene el identificador que aparece en la columna Property de la tabla Control. Determina si se hace referencia indirectamente a la propiedad asociada a este control. |
| Entero | 0x00000000 0x00000010 |
La propiedad asociada al control es un valor de cadena. La propiedad asociada al control es un valor entero. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control para establecer este atributo al crear el control. |
| RTLRO | 0x00000000 0x00000020 |
El texto del control se muestra en orden de lectura de izquierda a derecha. El texto del control se muestra en orden de lectura de derecha a izquierda. |
| RightAligned | 0x00000000 0x00000040 |
El texto del control está alineado a la izquierda. El texto del control está alineado a la derecha. |
| PushLike | 0x00000000 0x00020000 |
El control se dibuja con su aspecto habitual. El control tiene el estilo BS_PUSHLIKE y se dibuja para que aparezca como un botón de inserción. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control para establecer este atributo al crear el control. |
| Bitmap | 0x00000000 0x00040000 |
El texto del control se especifica en la columna Text de la tabla Control. El control tiene el estilo BS_BITMAP, al texto del control lo reemplaza una imagen de mapa de bits. La columna Text de la tabla Control se usa como clave externa para la tabla Binary. Incluya este bit en la palabra bit de la columna Attributes de la tabla Control. No establezca los bits de estilo Icono y Mapa de bits simultáneamente. El botón no puede contener una imagen de mapa de bits y texto a la vez. Para establecer la fuente y el estilo de fuente de una cadena de texto, anteponga la cadena de caracteres mostrados con {\style} o {&style}. Donde style es un identificador que aparece en la columna TextStyle de la tabla TextStyle. Si ninguno de estos elementos está presente, pero la propiedad DefaultUIFont se define como un estilo de texto válido, se usará esa fuente. |
| Icono | 0x00000000 0x00080000 |
El texto del control se especifica en la columna Text de la tabla Control. El control tiene el estilo BS_ICON, al texto del control lo reemplaza una imagen de icono. La columna Text de la tabla Control se usa como clave externa para la tabla Binary. Incluya este bit en la palabra bit de la columna Attributes de la tabla Control. No establezca los bits Icono y Mapa de bits simultáneamente. El botón no puede contener una imagen de icono y texto a la vez. Para establecer la fuente y el estilo de fuente de una cadena de texto, anteponga la cadena de caracteres mostrados con {\style} o {&style}. Donde style es un identificador que aparece en la columna TextStyle de la tabla TextStyle. Si ninguno de estos elementos está presente, pero la propiedad DefaultUIFont se define como un estilo de texto válido, se usará esa fuente. |
| FixedSize | 0x00000000 0x00100000 |
Estire la imagen del icono para ajustar el control. Recorte o centre la imagen de icono en el control. Incluya este bit en la palabra bit de la columna Attributes de la tabla Control. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Carga la primera imagen. Carga la primera imagen de 16 x 16. Carga la primera imagen de 32 x 32. Carga la primera imagen de 48 x 48. Un archivo de icono puede contener imágenes de diferentes tamaños del mismo icono. Incluya el valor de la palabra bit adecuada en la columna Atributos de la tabla Control Si no se establecen estos bits, el instalador omite el atributo FixedSize y la imagen se estira para ajustarla al rectángulo de control. Si los bits IconSize y FixedSize están establecidos, se centra una imagen más pequeña que el control y se reduce una imagen más grande que el control para que se ajusten. |
| HasBorder | no se establece en 0x01000000 |
Sin borde y sin texto. Muestra el borde y el texto. Incluya 16777216 en la palabra de bits de la columna Attributes de la tabla Control para mostrar un borde y texto. |
Comentarios
Debido a la forma en que Windows dibuja el marco, hay un espacio entre la parte superior de la ventana del control y el marco visible, incluso cuando no hay leyenda.
Este control se puede crear a partir de la clase BUTTON mediante la función CreateWindowEx. Si el bit HasBorder está establecido, tiene el estilo BS_GROUPBOX; de lo contrario, tiene el estilo BS_OWNERDRAW.
El control RadioButtonGroup no debe superponerse a otros controles; del mismo modo, otros controles no deben superponerse a RadioButtonGroup. La superposición de este control y de otro puede hacer que los controles funcionen mal o se muestren incorrectamente. Para proporcionar programas de lector de pantalla con texto descriptivo adicional sobre un control RadioButtonGroup, siga el ejemplo proporcionado en Incorporación de texto adicional a botones de radio.