Reset (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | Français

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing controls

Initialization process

Table and Looper controls

Limits

See also

Reset (Function)

In french: RAZ

Re-initializes:

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)
// Re-initialize the controls in order to enter a new customer
Reset(True)

// Re-initialize the controls found 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

Re-initializing all the controls found in the current window or page

Reset()

Re-initializing 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 will be re-initialized.

<Management of List Box Controls>: Optional boolean

True:
the edit controls are re-initialized to their initial value,
the list boxes, combo boxes, tables and loopers (browsing or memory) are neither cleared nor re-initialized. They keep their current content.
False (default value):
the edit controls are re-initialized to their initial value,
the "memory" list boxes, combo boxes, tables and loopers are cleared and re-initialized with their initial content,
the "browsing" list boxes, combo boxes, tables and loopers are re-initialized (they are not cleared).

Re-initializing 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 re-initialized. 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:
the edit controls and the Static controls are re-initialized with their initial value,
the browsing or memory List Box, Combo Box, Table and Looper controls are neither cleared nor re-initialized. They keep their current content.
False (default value):
the edit controls and the Static controls are re-initialized with their initial value,
the memory List Box, Combo Box, Table and Looper controls are cleared and re-initialized with their initial content,
the browsing List Box, Combo Box, Table and Looper controls are re-initialized (they are not cleared).
This parameter is not available: all the page controls are re-initialized 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 : wd250obj.dll