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 varias

Status (Status editor): Visible or invisible field/block
State of a group of controls
State of a column in a Table control
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

State (Property)

The State property gets and sets the state:

of a control in a window, page or report.
of a block in a report,
of a window.

In a page, the State property is used to get and change the state:

of a control or group of controls,
of a "container" control (Tab control, Internal Page, Layout, etc.),
of a group of controls.

In a report, the State property is used to get and change the visibility of a control or block. This property is kept for compatibility with WINDEV 5.5 and WEBDEV 1.5. To show or hide a control or a block in a report, use the Visible property.

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

Finding out the state of a control in a page Ocultar los detalles

<Current state> = <Control name>.State

<Current state>: Integer constant

Current status of object.
Active or Visible The control is active and editable.
Grayed Grayed-out control.
Inactive Edit control visible but read-only (applies to the edit controls only).
Invisible Invisible (it is recommended to use the Visible property).
This constant is not available. Use the Visible property.
Please note: on List and Combo Box controls, the 'Inactive' state behaves like the 'grayed' state.

<Control name>: Character string

Name of control or group of controls.

Changing the state of a control in a page Ocultar los detalles

<Control name>.State = <New state>

<Control name>: Character string

Name of control or group of controls.

<New state>: Integer constant

New object state.
Active or Visible The control is active and editable.
Grayed Grayed-out control.
Inactive Edit control visible but read-only (applies to the edit controls only).
Invisible Invisible (it is recommended to use the Visible property).
This constant is not available. Use the Visible property.
Remarks:
In List Box and Combo Box controls, 'Disabled' is equivalent to 'Grayed'.
The change of state may result in slightly different effects depending on the browser used. For example, the grayed state will be more noticeable in Internet Explorer and Chrome than in Firefox.

Getting the state of an element in a report Ocultar los detalles

<Current state> = <Element name>.State

<Current state>: Integer constant

Current status of object.
Active The control or block is visible.
Invisible Invisible control or block (it is recommended to use the Visible property).

<Element name>: Character string

Name of report control or block.

Changing the state of an element in a report Ocultar los detalles

<Element name>.State = <New state>

<Element name>: Character string

Name of report control or block.

<New state>: Integer constant

New object state.
Active The control or block is visible.
Invisible Invisible control or block (it is recommended to use the Visible property).

Observaciones

Status (Status editor): Visible or invisible field/block

In a report, the only possible state for a control or a block is visible or invisible. To set the visibility of a control, it is recommended to use the Visible property. This property optimizes the management of control visibility.

State of a group of controls

Find out the status of a group of fields: the status returned corresponds to the status of the first field in the group.
Modify the status of a group of fields: all the fields in the group are modified to match the new status.

State of a column in a Table control

If the State property is applied to a column of a Table control, the state of the entire column is changed (and not only the state of the cell).

Please note: the State property can only be used to restrict the column status defined in the description window.. For example, if the column is read-only, no column cell can become editable.

Limitations

The State property has no effect on reports created with the report editor.

The State property has no effect on the following elements:

Table,
TreeView Table,
Looper
Linear Looper
Table column.

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: 14/12/2024

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