Choose the action of the button in a page

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Button control

Choose the action of the button in a page

Overview

The different available choices

Choosing a type of button

See also

Choose the action of the button in a page

Overview

When defining the action of a button in a page, a button can perform different operations depending on the type of the action selected.

The different available choices

The operation performed during the action is chosen in the button description window ("General" tab).

The possible operations during the action are:

Send values to the server (submit):
The button validates all the controls in the current page and returns the value of the controls to the server. Then, the server performs the specified action.
Do not send anything to the server:
The button performs the requested action but it does not return the content of the controls found in the current page to the server.
Delete content of the controls in the browser (reset) - for compatibility:
The button clears all the page controls (except for the controls initialized through programming).

Remark: Internet browsers only allow a single action on the page per process

Some types of buttons automatically trigger an action on the page ("Send the value of controls to the server (submit)").

This function will be ignored if PageSubmit or EmailOpenMail are used in the "Click" browser event of these buttons (or in a procedure called by this event): only the action of the button will be performed.

Consequences: PageSubmit or EmailOpenMail cannot be used in a code that triggers an action (automatically or not). These functions are ignored:

in the click code of a button that performs the action "Send values to the server (submit)".
in the click code of a button that performs an action different from "Do not send anything to the server".
if PageSubmit is followed by EmailOpenMail (in the current event, in a procedure called by the current event or in another process called by Execute).
if EmailOpenMail is followed by PageSubmit (in the current event, in a procedure called by the current event or in another process called by Execute).

To use PageSubmit or EmailOpenMail from a button ("Click" browser event of the button), this button must have the following characteristics ("General" tab in the description window):

Operation on the controls: "Run browser click code only".
Action: "Do not send anything to the server".

Choosing a type of button

Let's see some "standard" examples for using buttons in a page:

Action to perform	Example	Operation available with the action

Send data of the current page to the server to be processed	Registration form The button checks whether the entered information is correct and displays a confirmation page.	Send value of controls to server (submit)
Perform a process on the server, without retrieving the data of the current page	Menu page with buttons. Each button is used to display a page of the site	None
Perform a process in browser code	Perform a simple calculation, an input check, ...	None
Display a static page of the site	Display the home page of the site	None
Display a page external to the site	Start a search engine	None
Reset the page controls	Clear the controls of the current page	Reset page controls