PageParameter (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Web-specific functions / Page functions

Retrieving a value that is not linked to a control
Retrieving the parameters passed to an AWP or PHP page
Example of URL used to run a WEBDEV website by passing parameters
Retrieving the parameters sent to the page from a WINDEV or WINDEV Mobile application
Pre-launched sessions
PHP4

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

PageParameter (Function)

In french: PageParamètre

Returns the value of a parameter passed to the current page. Used to retrieve:

the parameters of a command line.
a value that is not linked to a control (position of the mouse in a clickable image).

Example

See additional examples

// Code d'initialisation du projet
SWITCH Upper(PageParameter("PAGEDEMARRAGE"))
	CASE "LOGIN" : PageDisplay(PAGE_Identification)
	CASE "PRODUITS" : PageDisplay(PAGE_GestProd)
	OTHER CASE : // Ne rien faire
END

// Récupération de la position de la souris dans une image cliquable
Paramètre is string = PageParameter("POS") 
// Ex : Paramètre ="15,23"
x,y are int
x = ExtractString(Paramètre, 1, ",")
y = ExtractString(Paramètre, 2, ",")

// Récupération de la position de la souris dans une image cliquable
Paramètre is string = PageParameter(1) 
// Ex : Paramètre = "POS=15,23"

Syntax

Retrieving the value of a parameter identified by its name Hide the details

<Result> = PageParameter(<Parameter name> [, <Encoding>])

<Result>: Character string

Value of specified parameter,
Empty string ("") if the parameter does not exist or has no value.

<Parameter name>: Character string

Name of the parameter whose value is to be returned. For an Active WEBDEV Page, the parameters are automatically named by WEBDEV (P1, P2, ..., P256). In this case, no controls named P1, P2, ..., P256 must be found in the page.

<Encoding>: Optional Integer constant

Parameter value encoding mode:
paramNoDecoding The raw value of the parameter is returned. No decoding is performed by WEBDEV. This constant can be used when the encoding of the URL does not comply with the standards used by WEBDEV (e.g., "+" sign not supported, etc.)
paramWithDecoding
(Default value) The parameter value is automatically decoded by WEBDEV according to the URL encoding/decoding standard.

Retrieving the value of a parameter identified by its index Hide the details

<Result> = PageParameter(<Parameter index> [, <Encoding>])

<Result>: Character string

Value of the specified parameter. This value has the following format: <Parameter name> = <Value>.
Empty string ("") if the parameter does not exist.

<Parameter index>: Integer

Index of the parameter whose value is to be returned.

<Encoding>: Optional Integer constant

Parameter value encoding mode:
paramNoDecoding The raw value of the parameter is returned. No decoding is performed by WEBDEV. This constant can be used when the encoding of the URL does not comply with the standards used by WEBDEV (e.g., "+" sign not supported, etc.)
paramWithDecoding
(Default value) The parameter value is automatically decoded by WEBDEV according to the URL encoding/decoding standard.

Retrieving specific data Hide the details

<Result> = PageParameter(<Type of message>)

<Result>: Character string

Data sent by HTTPRequest.
Empty string ("") if no data.

<Type of message>: Integer constant

Type of data to retrieve:
paramBuffer Retrieves raw data received (sent by a POST method). The data received must use one of the following MIME types:
"application/octet-stream".
"text/xml".
Remark: If this constant is used, the page can only be tested by using the HTTPRequest function to transmit the message. A simple GO of the page does not work.

Remarks

Retrieving a value that is not linked to a control

By default, the parameters sent by the browser are usually assigned to the controls found in the context, before any process is run. PageParameter gets a value that is not linked to a control.

Example The function PageParameter function is used to retrieve a position in a clickable image.

For click zones, when the mouse is clicked, you can retrieve the horizontal and vertical position of the mouse in the click zone, with a specific parameter: "POS" (see example).

Retrieving the parameters passed to an AWP or PHP page

PageParameter retrieves the value of the parameters passed to the page. Several possibilities exist according to the type of page:

Retrieval according to the name of the parameter
Retrieval according to the parameter index

Case 1: Retrieval based on parameter name
The name of the parameter was specified in the URL of the page.
For an AWP or PHP page, the parameters are automatically renamed by WEBDEV (P1, P2, ..., P256). In this case, no controls named P1, P2, ..., P256 must be found in the page.

1. Code used to display the page by passing parameters:

// Affiche dans la page "MaPage.AWP", le 350ème élément 
// de la catégorie "Instruments"
PageDisplay(PAGE_MaPage, "Instruments", 350)

2. Code used to retrieve the parameters:

// Récupération des paramètres
CategorieRecherchée is string = PageParameter("P1")
IDRecherché is int = PageParameter("P2")

Case 2: Indexed recovery ofparameter
The index of the parameter corresponds to the order in which the parameters were passed in the URL of the page.

This syntax is not available in this version.

1. Code used to display the page by passing parameters:

// Affiche dans la page "MaPage.AWP", le 350ème élément 
// de la catégorie "Instruments"
PageDisplay(PAGE_MaPage, "Instruments", 350)

2. Code used to retrieve the parameters:

// Récupération des paramètres
CategorieRecherchée is string = PageParameter(1) 
// CategorieRecherchée = "P1=Instruments"
CategorieRecherchée = Right(Length(CategorieRecherchée)-3)
IDRecherché is int = PageParameter(2)
// IDRecherché = "P2=350"
IDRecherché = Right(Length(IDRecherché)-3)

Example of URL used to run a WEBDEV website by passing parameters

http://Server/WD300AWP/WD300AWP.EXE/CONNECT/APPLI?PARAM1=VAL1&PARAM2=VAL2&PARAM3=VAL3

In this code:

server corresponds to the server address,
APP corresponds to the name of the WEBDEV site,
PARAM1, PARAM2 and PARAM3 correspond to the names of the parameters,
VAL1, VAL2 and VAL3 correspond to the values of the different parameters.

Each parameter is retrieved in WLanguage, in the project initialization code. For each parameter, use PageParameter and specify the name of the parameter to retrieve.

For example:

// Récupération du paramètre ayant pour nom PARAM1
PageParameter("PARAM1")

Retrieving the parameters sent to the page from a WINDEV or WINDEV Mobile application

If the value of a received parameter was sent by a WINDEV or WINDEV Mobile application with HTTPRequest and if it was encoded by URLEncode, there is no need to decode this value. PageParameter will automatically perform the decode operation (call to URLDecode).

Pre-launched sessions

If your project uses pre-launched sessions, this function must not be used in the project initialization event. This function must be used in the "Initialization in pre-launched session mode" event.

PHP4

In PHP4, to retrieve the rough value of parameters (paramBuffer constant or paramNoDecoding constant), the "always_populate_raw_post_data" directive must be set to "on" in the configuration file of PHP (php.ini file).

Related Examples:

Training (WEBDEV): WW_Organizer

[ + ] The WW_Organizer example is an example for using the Organizer control of WEBDEV.

Component: wd300page.dll