Reset (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Control management functions

WLanguage procedure

Reset

Presentation

Example

File variables

Initialization process

Table and Looper controls

Limitations

See also

Reset (Function)

In french: RAZ

Reinitializes:

all controls found in the current window or in the current page (including the groups of controls, the supercontrols, the popups and the internal windows).
the controls found in a group of controls, a supercontrol, a popup, an internal window or an internal page.

Reinitializes all the controls to their initial value. The initial value of controls corresponds to the value of controls during the last page display on the browser (first page display or display during a refresh operation, ...).

Example

// Add a customer
ScreenToFile()
HAdd(Customer)
// Reinitialize controls to enter a new customer
Reset(True)

// Reinitialize controls in the "SC_Customer" supercontrol
// The list box, combo box, table and looper controls of this supercontrol
// will keep their current content.
Reset(SC_Customer, True)

// -- Browser click code of BTN_CANCEL
// Cancels the inputs performed in the form
Reset()

Syntax

Reinitializing all the controls in the current window or page Hide the details

RESET([<Management of Special controls>])

<Management of Special controls>: Optional boolean

True:
Edit controls and Static controls are reinitialized to their initial value,
browsing or memory List Box, Combo Box, Table and Looper controls are neither cleared nor reinitialized. They keep their current content.
False (default value):
Edit controls and Static controls are reinitialized to their initial value,
memory List Box, Combo Box, Table and Looper controls are cleared and reinitialized to their initial content,
browsing List Box, Combo Box, Table and Looper controls are only reinitialized (they are not cleared).
This parameter is not available: all the page controls are reinitialized to their initial value. The initial value of controls corresponds to the value of controls during the last page display on the browser (first page display or display during a refresh operation, ...).

Reinitializing all the controls found in a group of controls, a supercontrol, an internal window or an internal page Hide the details

RESET(<Element name> [, <Management of Special controls>])

<Element name>: Character string

Name of element whose controls will be reinitialized. Can correspond to:
Name of group of controls.
Name of supercontrol.
Name of internal window or internal page.
Name of control template.
Name of popup.
Name of group of controls to reinitialize.

<Management of Special controls>: Optional boolean

True:
Edit controls and Static controls are reinitialized to their initial value,
browsing or memory List Box, Combo Box, Table and Looper controls are neither cleared nor reinitialized. They keep their current content.
False (default value):
Edit controls and Static controls are reinitialized to their initial value,
memory List Box, Combo Box, Table and Looper controls are cleared and reinitialized to their initial content,
browsing List Box, Combo Box, Table and Looper controls are only reinitialized (they are not cleared).
This parameter is not available: all the page controls are reinitialized to their initial value. The initial value of controls corresponds to the value of controls during the last page display on the browser (first page display or display during a refresh operation, ...).

Remarks

File variables

HReset is used to reset the variables of HFSQL files. To reinitialize the variables of the HFSQL files in a page, you must use the following code:

HReset(<File name>)
FileToPage()

Caution: If controls are associated with file items, these items contain stars ("*").

Initialization process

Do not confuse Reset and PageInitialization. Indeed:

Reset resets the controls
PageInitialization resets the controls and runs the initialization processes.

Table and Looper controls

A Table or Looper control linked to a data file can never be empty. This control is automatically initialized with the values of the linked items in the data file.

Limitations

Reset does not reset the labels of the Button controls.

Reset has no effect on the following controls:

Static control,
Button control,
Image control.

Component: wd270obj.dll