State (Property)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Este contenido se ha traducido automáticamente. Haga clic aquí para ver la versión en inglés.

Ayuda / WLanguage / Propiedades WLanguage / Propiedades duplicadas

Visible o Invisible control/bloque
Estado de un grupo de controles
Estado de una columna en una control Tabla
Pestañas y controles de un panel de pestañas
Controles de botón de selección/caja de verificación y sus opciones
Control activo hecho Invisible o no
Limitaciones

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

State (Property)

La propiedad State permite:

en un reporte.
en una ventana.
en una página.

En un reporte, el Estado Property se utiliza para get y cambiar el estado:

de una control,
de un bloque de reporte.

Observación: En un reporte, el Estado Property sólo puede utilizarse para set la visibilidad de un control o de un bloque (los controles y los bloques no pueden ser Grayed fuera). En este caso, esta Property está disponible para la compatibilidad con WINDEV 5.5 y WEBDEV 1.5. Para mostrar u ocultar un control o un bloque en un reporte, utilice el Visible Property.

En una ventana, el Estado Property utiliza para get y cambiar el estado:

de una ventana,
de una control o grupo de control s,
de una célula de tabla o tabla fila,
de una opción de menú.

Ejemplo

// The STC_Static1 control becomes active
STC_Static1.State = Active

// The EDT_Edit1 control becomes active
EDT_Edit1.State = Active
// Modify the content of the Combo Box if it is active
IF COMBO_Combo1.State = Active THEN
COMBO_Combo1 = "<Enter HERE>"
SetFocusAndReturnToUserInput(COMBO_Combo1)
END

Sintaxis

Obtener el estado de un elemento en una reporte Ocultar los detalles

<Current state> = <Element name>.State

<Current state>: Constante de tipo Integer

Estado actual del objeto.
Active El control o bloqueo es Visible.
Invisible Control o bloque Invisible (se recomienda utilizar el Visible Property).

<Element name>: Cadena de caracteres

Nombre de reporte control o bloque.

Modificar el estado de un elemento en una reporte Ocultar los detalles

<Element name>.State = <New state>

<Element name>: Cadena de caracteres

Nombre de reporte control o bloque.

<New state>: Constante de tipo Integer

Nuevo estado del objeto.
Active El control o bloqueo es Visible.
Invisible Control o bloque Invisible (se recomienda utilizar el Visible Property).

Obtener el estado de una ventana o de un elemento de una ventana Ocultar los detalles

<Current state> = <Element name>.State

<Current state>: Constante de tipo Integer

Estado actual del objeto.
Controles de ventanas
Active El control es Active y editable.
ReadOnlyNoSelection Sólo para los controles de tabla: El control es de sólo lectura, no se permite ninguna entrada.

En este caso, el usuario no podrá seleccionar un tabla fila con el ratón o con las flechas. Una fila sólo puede seleccionarse mediante programación con TableSelectPlus. Esta fila se seleccionará a través del banda de selección.
DisplayOnly o Inactive La control es de sólo lectura, no se permite ninguna entrada o acción.
Para los controles de Tabla, Tabla TreeView y Looper, el usuario podrá seleccionar un tabla fila. También puede seleccionarse mediante programación (con TableSelectPlus para las tablas).
Grayed control Grayed fuera.
Célula TABLE fila o celda de tabla, TreeView tabla, List Box, ListView, Combo Box, Looper
Active La control está habilitada y es editable (si la tabla está en modo de edición).
ReadOnlyNoSelection El control es de sólo lectura, no se permite ninguna entrada o acción. El usuario no podrá seleccionar un tabla fila con el ratón o con las teclas de flecha. Una fila sólo puede seleccionarse mediante programación con TableSelectPlus.

Esta fila se seleccionará a través del banda de selección.
Grayed La control es Grayed fuera
Windows
Active Ventana que puede ser manejada por el usuario.
DisplayOnly Los controles de la ventana ya no se pueden modificar. Sin embargo, el usuario podrá modificar el fila seleccionado en los controles Table, TreeView Table o Looper. La ventana no se puede mover.
Grayed Despeja todos los controles de las ventanas.
OutsideScreen La ventana es Active pero sus coordenadas son negativas

<Element name>: Cadena de caracteres

Nombre de control, tabla fila, celda, grupo de control s o ventana.

Modificar el estado de un elemento en una ventana o el estado de una ventana Ocultar los detalles

<Element name>.State = <New state>

<Element name>: Cadena de caracteres

Nombre de control, tabla fila, celda, grupo de control s o ventana.

<New state>: Constante de tipo Integer

Nuevo estado de los elementos.
Controles de ventanas
Active El control es Active y editable.
ReadOnlyNoSelection Sólo para los controles de tabla: La control es de sólo lectura, no se permite la entrada de datos.
En este caso, el usuario no podrá seleccionar un tabla fila con el ratón o con las flechas. Una fila sólo puede seleccionarse mediante programación con TableSelectPlus. Esta fila se seleccionará a través del banda de selección.
DisplayOnly o Inactive La control es de sólo lectura, no se permite ninguna entrada o acción.
Para los controles Table, TreeView Table y Looper, el usuario podrá seleccionar un fila. También puede seleccionarse mediante programación (con TableSelectPlus para las tablas).
Grayed La control es Grayed fuera
Célula TABLE fila o celda de tabla, TreeView tabla, List Box, ListView, Combo Box, Looper
Active La control está habilitada y es editable (si la tabla está en modo de edición).
ReadOnlyNoSelection El control es de sólo lectura, no se permite ninguna entrada o acción. El usuario no podrá seleccionar un tabla fila con el ratón o con las teclas de flecha. Una fila sólo puede seleccionarse mediante programación con TableSelectPlus.
Esta fila se seleccionará a través del banda de selección.
Grayed control Grayed fuera.
Windows
Active Ventana que puede ser manejada por el usuario.
DisplayOnly Los controles de la ventana ya no se pueden modificar. Sin embargo, el usuario podrá modificar el fila seleccionado en los controles Table, TreeView Table o Looper. La ventana no se puede mover.
Grayed Despeja todos los controles de las ventanas.
OutsideScreen La ventana es Active pero sus coordenadas son negativas.

Observaciones

Visible o Invisible control/bloque

En una reporte, el único estado posible para un control o un bloqueo es visible o Invisible. Para establecer la visibilidad de un control, se recomienda utilizar el programa Visible Property. Esta Property optimiza la gestión de la visibilidad de control.

Estado de un grupo de controles

Averiguar el estado de un grupo de controles: el estado corresponde al estado de la primera control del grupo.
Modificación del estado de un grupo de controles: todos los controles del grupo se modifican y corresponden al nuevo estado.

Estado de una columna en una control Tabla

Si se aplica el State Property a una columna, se cambia el estado de toda la columna (y no sólo el estado de una celda).

Atención: la propiedad State sólo restringe el estado de la columna definida en la ventana description. Por ejemplo, si la columna es de sólo lectura, ninguna celda de columna puede ser editada.

Pestañas y controles de un panel de pestañas

El estado de una control en un panel de pestañas depende del estado de la pestaña:

Si no se selecciona el panel, el control es Invisible.
Si se selecciona el panel y Invisible, el control es Invisible.
Si el panel está seleccionado y Grayed fuera, el control es Grayed fuera.
Si el panel está seleccionado y desactivado, la control está desactivada.
Si el panel está seleccionado y habilitado, el control puede estar activado, desactivado, en gris o Invisible.

Controles de botón de selección/caja de verificación y sus opciones

Puede modificar el estado de la control o el estado de una opción del botón de radio/control Casilla de verificación. Una opción puede ser Grayed fuera o habilitada.

Para modificar el estado de una control Botón de opción:
RADIO_Radio1.State = Grayed
Para modificar el estado de una opción en un control Botón de opción:
RADIO_Radio1[2].State = Grayed

Atención: El estado de una opción depende del estado de la control Botón de opción. Por lo tanto, si se realizan las siguientes operaciones:

Una opción es Grayed fuera.
El botón de radio/control Casilla de verificación es Grayed out.
El Botón de radio/control Casilla de verificación se vuelve a activar. La opción sigue siendo Grayed fuera.

Control activo hecho Invisible o no

El Visible Property se puede utilizar para ocultar un control (habilitado, Grayed fuera o de sólo lectura).

Cuando el control es Invisible, pierde todas las características de su estado anterior: el control es Invisible y no puede ser usado. La única forma de ejecutar su código es llamar a ExecuteProcess. Por ejemplo, una Invisible control no responde al usar el atajo. Por ejemplo, un botón activo hecho Invisible no responde al usar el atajo.

Para restablecer el estado anterior del control, basta con volver a utilizar la Visible Property.

Limitaciones

El State Property no tiene efecto en los informes.

El State Property no tiene ningún efecto sobre los controles HTML.

Ver también

Versión mínima requerida

Versión 9

Esta página también está disponible para…

Comentarios

PROCEDURE evento_state_fields(myNameWindow,myNameControl)

// ReadOnlyNoSelection // OutsideScreen // Grayed // DisplayOnly // Active

Indirection is string = myNameWindow +"."+ myNameControl

SWITCH {Indirection}..State
CASE Active
RESULT "1-Active"
CASE ReadOnlyNoSelection
RESULT "2-ReadOnly"
CASE Grayed
RESULT "3-Grayed"
CASE DisplayOnly
RESULT "4-DisplayOnly"
OTHER CASE
RESULT "5-Other"
END

Boller

02 09 2023

Última modificación: 27/05/2022

Señalar un error o enviar una sugerencia | Ayuda local