PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Which page should be displayed?
  • Where should the page be displayed?
  • Choosing a target
  • Current browser (_top)
  • Current frame (_self)
  • Parent frame (_parent)
  • New browser (_blank)
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
24. Displaying and sequencing pages
Previous pageTable of contentsNext page
In most cases, a site includes a set of pages. These pages are linked together via buttons (or links). A click performed on a button is used to display a new page.
Two questions must be asked before a new page is displayed:
  1. which page should be displayed?
  2. where should the page be displayed (new browser, frame, etc.)?
Which page should be displayed?
The page to display can be defined:
  • in the page editor (no programming is required).
  • in the code editor, in a process of the button (or link or clickable image, etc.).
Selecting the page to display in the page editor (most common method)
To define the page to display:
  • Display the description window of control ("Description" from the popup menu of control).
  • In the type of action, select "Display a page of the site".
  • Select the page to display.

Selecting the page to display by programming
The page to display must be selected by programming when:
  • several pages can be displayed (an error page if the password is not entered or the next site page for example).
  • a specific action must be performed on the server (calculation, read a record, etc.).
Where should the page be displayed?
A page is displayed in a specific "target": current page, new browser, etc.
The target can be defined:
  • in the page editor: no programming is required.
  • in the code editor, in a process of the button (or link).
Several WLanguage functions allow you to open a new page (or frameset). The main functions are:
Selecting the target in the page editor (most common method)
In a button, to define the target of the page to display:
  • Display the description of button or link ("Description" from the popup menu of control).
  • In the list of targets, select a preset target or a frame (in the case of a frameset).

Note: The preset targets will be presented later in this manual.
Selecting the target in the code editor
When the target depends on a choice made by the Web user, this target must be selected by programming. For example, if the Web user does not enter his password, an error page is displayed in a new browser ; otherwise, the next page is displayed in the current browser.
The ChangeTarget WLanguage function is used to modify the target of an action by programming. This function must be used in browser code.
Choosing a target
When choosing the target for a button, a link, a clickable image, a menu option, ... you can select:
  • a preset target: four preset targets are proposed:
    • Current browser (_top)
    • Current frame (_self)
    • Parent frame (_parent)
    • New browser (_blank). In this case, the new browser can correspond to a new tab or a new browser with specific characteristics (menu bar, message bar, etc.)..
  • a frame in the current frameset.
Note: in the diagrams below, the grayed area represents the area where the page is displayed during the click on button.

Current browser (_top)

Current frame (_self)

Parent frame (_parent)

New browser (_blank)

Previous pageTable of contentsNext page
Minimum version required
  • Version 23
Comments
Click [Add] to post a comment