Changes the target of a button action.
By default, the target is defined in the "General" tab of the button run or current page
|
Caution: ChangeTarget can be directly used in the browser process corresponding to the server action of control: - browser click code for a Button, Link or Image control.
- "Whenever modifying" code for Radio Button, Check Box, List Box or Combo Box controls.
ChangeTarget has no effect in the other browser processes or in a local browser procedure even if this procedure is called by one of the above-mentioned processes. |
// -- Browser click code of the Button control
// The target of the button defined in the description window (current frame)
ChangeTarget(CurrentBrowser)
// -- Server click code of the Button control
IF CheckUserName(EDT_UserName) = False THEN
// Refreshes the PAGE_Identification page
PageRefresh(PAGE_Identification)
ELSE
// Displays the home page
PageDisplay(PAGE_Welcome)
END
Syntax
ChangeTarget(<Target> [, <Window name> [, <Options> [, <Width> [, <Height> [, <Horizontal position> [, <Vertical position> [, <JavaScript parameters>]]]]]]])
<Target>: Character string or constant
Name of target frame or alias of target iFrame control.<Target> can also take the following values:
| |
| CurrentBrowser | The target is the current browser.
This parameter can also correspond to the "_top" string (compatibility with WEBDEV 1.5). |
| CurrentFrame | The target is the current frame (default value)
This parameter can also correspond to the "_self" string (compatibility with WEBDEV 1.5). |
| NewBrowser | The target is a new browser (a new browser window is opened). The following parameters of ChangeTarget are used to configure the browser window.
This parameter can also correspond to the "_blank" string (compatibility with WEBDEV 1.5). |
| ParentFrame | The target is the container of the current page (parent frameset, parent browser).
This parameter can also correspond to the "_parent" string (compatibility with WEBDEV 1.5). |
<Window name>: : Optional character string
Name of the window of the new browser if <Target> is equal to the NewBrowser constant (or to "_blank"). This parameter allows you to redisplay a page in a browser with the same name (if several browsers are opened on the computer of the Web user). This name is a unique name (equivalent to the name of a JavaScript variable).
Caution: This name must contain no space character, no accented character and no special character.
<Options>: Optional Integer constant (or combination of constants)
Parameters of the new browser window if <Target> is equal to the NewBrowser constant (or to "_blank"): | |
ONFull
(Default value) | The window of the new browser will include an address bar and scrollbars (equivalent to the combination of all the previous constants) |
| ONLink | The link bar will be displayed |
| ONLocation | The address bar will be displayed |
| ONMenuBar | The menu bar will be displayed |
| ONResizable | The window of new browser will be resizable |
| ONSatusBar | The status bar will be displayed |
| ONScrollbar | The scrollbars will be displayed |
| ONSimple | The window of the new browser will be a simple window (no combination of constants). |
| ONToolbar | The toolbar will be displayed |
<Width>: Optional integer
Width of window in the new browser (in pixels).
<Height>: Optional integer
Height of window in the new browser (in pixels).
<Horizontal position>: Optional integer
Horizontal position (in pixels) of the window in the new browser (in relation to the upper-left corner of the screen).
<Vertical position>: Optional integer
Vertical position (in pixels) of the window in the new browser (in relation to the upper-left corner of the screen).
<JavaScript parameters>: Optional character string
Other JavaScript parameters to use when opening a new browser if <Target> is equal to the NewBrowser constant (or to "_blank").
Remarks
Tip: optimize the size of your HTML files