RadioButtonGroup Control
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 Propiedad de la tabla control de . Especifique los valores posibles para la selección en la columna Valor de la tabla RadioButton de . Tenga en cuenta que la cadena mostrada no es necesariamente la misma que el valor que el usuario elige.
Cada control RadioButtonGroup está asociado a una propiedad . El valor predeterminado de esta propiedad debe inicializarse en la tabla Property de . Dentro de cada radioButtonGroup especificado en la tabla RadioButton, puede haber un botón de radio que tenga un valor en el campo Valor que coincida con el valor predeterminado para 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 se puede mover a un control RadioButtonGroup hasta que se haya seleccionado uno de los botones del grupo. Para que el foco se mueva a este grupo de botones, especifique uno de los botones como un 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 dentro del grupo. Del mismo 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 este modo, 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 extienden más allá de los límites del grupo.
Atributos de control
Puede usar los siguientes atributos con este control. Para cambiar el valor de un atributo mediante un evento, suscríbase el control a un ControlEvent en la tabla eventMapping de y enumere el identificador del atributo en la columna Atributo. Escriba el identificador de ControlEvent en la columna Evento.
| 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 Propiedad de la tabla control de . | |
| posición | Posición del control en el cuadro de diálogo. Escriba 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 de . Use unidades del instalador para la longitud y la distancia. |
|
| PropertyName de | 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 Propiedad de la tabla control de . | |
| PropertyValue | Valor actual de la propiedad mostrada o modificada por este control. Si no se establece el bit de atributo indirecto, este es el valor de PropertyName. Si se establece el bit de atributo indirecto, este es el valor de IndirectPropertyName. Si el atributo cambia, el control refleja el nuevo valor. | |
| text | Este atributo de control puede especificar el texto mostrado por 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 Texto de la tabla control de . Para establecer el estilo de fuente y fuente de este texto, prefijo la cadena de caracteres mostrados con {\style} o {&estilo}. 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 binaria de escriba la clave principal del registro de la imagen de la columna Nombre de la tabla Binary en la columna Texto de la tabla Control registro del control. |
|
| visible | 0x00000000 0x00000001 |
Control oculto. Control visible. Incluya este bit en la palabra bit de la columna Atributos de la tabla control de para que el control sea visible o oculto tras su creación. También puede ocultar o mostrar un control mediante la tabla ControlCondition de . |
| habilitado para | 0x00000000 0x00000002 |
Controlar en un estado deshabilitado. Controlar en un estado habilitado. Incluya este bit en la columna Atributos del Control para habilitar el control en la creación. También puede habilitar o deshabilitar un control mediante la tabla controlCondition de . |
| hundido | 0x00000000 0x00000004 |
Muestra el estilo visual predeterminado. Muestra el control con un aspecto 3D, hundido. Incluya estos bits en la palabra bit de la columna Atributos de la tabla control de . |
| indirecto | 0x00000000 0x00000008 |
El control muestra o cambia el valor de la propiedad en la columna Propiedad de la tabla control de . El control muestra o cambia el valor de la propiedad que tiene el identificador enumerado en la columna Propiedad de la tabla Control. Determina si la propiedad asociada a este control se hace referencia indirectamente. |
| 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 bit de la columna Atributos de la tabla control de para establecer este atributo al crear el control. |
| RTLRO de | 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 se alinea a la izquierda. El texto del control está alineado a la derecha. |
| PushLike | 0x00000000 0x00020000 |
El control se dibuja con su apariencia 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 bit de la columna Atributos de la tabla control de para establecer este atributo al crear el control. |
| de mapa de bits de | 0x00000000 0x00040000 |
El texto del control se especifica en la columna Texto de la tabla control de . El control tiene el estilo BS_BITMAP, el texto del control se reemplaza por una imagen de mapa de bits. La columna Texto de la tabla control de se usa como clave externa para la tabla binaria de . Incluya este bit en la palabra bit de la columna Atributos de la tabla control de . No establezca los bits de estilo Icono y Mapa de bits simultáneamente. El botón no puede contener tanto una imagen de mapa de bits como un texto. Para establecer el estilo de fuente y fuente de una cadena de texto, prefijo la cadena de caracteres mostrados con {\style} o {&estilo}. 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 de | 0x00000000 0x00080000 |
El texto del control se especifica en la columna Texto de la tabla control de . El control tiene el estilo BS_ICON, el texto del control se reemplaza por una imagen de icono. La columna Texto de la tabla control de se usa como clave externa para la tabla binaria de . Incluya este bit en la palabra bit de la columna Atributos de la tabla control de . No establezca los bits icono y mapa de bits simultáneamente. El botón no puede contener tanto una imagen de icono como un texto. Para establecer el estilo de fuente y fuente de una cadena de texto, prefijo la cadena de caracteres mostrados con {\style} o {&estilo}. 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 |
Ajuste 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 Atributos de la tabla control de . |
| icono de Icono de tamaño | 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 tamaño diferentes del mismo icono. Incluya el valor de la palabra de bits adecuada en la columna Atributos de la tabla control de Si no se establecen estos bits, el instalador omite el atributo FixedSize y la imagen se extiende para ajustarse al rectángulo de control. Si se establecen los bits IconSize y fixedSize, se establece una imagen más pequeña que el control y una imagen es mayor que el control que se reduce para ajustarse. |
| HasBorder | no establecido 0x01000000 |
Sin borde y sin texto. Muestra el borde y el texto. Incluya 16777216 en la palabra bit de la columna Atributos del Control para mostrar un borde y texto. |
Observaciones
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 ningún título.
Este control se puede crear a partir de la clase BUTTON mediante la función CreateWindowEx. Si se establece el bit HasBorder, tiene el estilo BS_GROUPBOX; de lo contrario, tiene el estilo BS_OWNERDRAW.
El control RadioButtonGroup no debe superponerse a otros controles y otros controles no debe superponerse a RadioButtonGroup. La superposición de este control y otra puede hacer que los controles funcionen o se muestren incorrectamente. Para proporcionar programas de lector de pantalla con texto descriptivo adicional sobre un control RadioButtonGroup, siga el ejemplo proporcionado en Agregar texto adicional a botones de radio.