Choosing the type of link

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Link control

Choosing the type of link

Overview

The different types

Choosing a type of link

See also

The Link control

Choosing the type of link

Overview

WEBDEV proposes several types of links according to the action of the link on the page controls.

The different types

The type of link is linked to the type of operation performed on the controls. The choice of the operation is performed in the description window of the link ("General" tab).

The available types of operation are as follows:

Send field values to the server (submit):
The link validates all the controls found in the current page and returns the value of the controls to the server. Then, the server performs the specified action.
Reset page fields (reset):
The link clears all the page controls (except for the controls initialized by programming).
None:
The link performs the requested action but it does not return the content of the controls found in the current page to the server.

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

Some types of links automatically trigger an action on the page (link performing the "Send the value of controls to the server" operation, link performing the "None" operation whose action differs from "none").

This function will be ignored if PageSubmit or EmailOpenMail are used in the browser click process of these links (or in a procedure called by this process): only the action of the link 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 link that performs the "Send to server" operation
in the click code of a link that performs the "other" operation whose action differs from "None"
if PageSubmit is followed by EmailOpenMail (in the current process, in a procedure called by the current process or in another process called by Execute).
if EmailOpenMail is followed by PageSubmit (in the current process, in a procedure called by the current process or in another process called by Execute).

To use the PageSubmit or EmailOpenMail functions from a link (browser click code of the button), this link must have the following characteristics ("General" tab of the description window):

Operation on the controls: "None"
Action: "None"

Choosing a type of link

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

Action to perform	Example	Operation on the controls

Send data of the current page to the server to be processed	Registration form. The link is used to check the validity of the information entered and it displays a confirmation page.	Send value of controls to server (submit)
Perform processing on the server, without retrieving data from the current page	Menu page with buttons. Each link is used to display a page of the site	None
Perform processing 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 page fields	Clear the controls of the current page	Reinitialize page controls (reset)