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

Initialization process

Table and Looper controls

Limits

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, ...).

Versions 16 and later

This function is now available for WINDEV applications in Linux.

New in version 16

This function is now available for WINDEV applications in Linux.

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

RESET()

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 List Box controls>])

<Element name>: Character string (with or without quotes)

Name of group of controls, supercontrol, internal window or internal page whose controls must be reinitialized.

<Management of List Box controls>: Optional boolean

True:
Edit controls are reinitialized to their initial value,
List Box, Combo Box, Table and Looper controls (browsing or memory) are neither cleared nor reinitialized. They keep their current content.
False (default value):
Edit 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).

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 (with or without quotes)

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 ("*").

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

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.

Limits

Reset does not reinitialize the caption of the Button controls.

Reset has no effect on the following controls:

Static control,
Button control,
Image control.

Component : wd260obj.dll