- 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 site by passing parameters
- Retrieving the parameters sent to the page from a WINDEV or WINDEV Mobile application
- Pre-launched sessions
- PHP4
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).
// 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, ",")
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 if it has no value.
<Parameter name>: Character string Name of the parameter whose value must 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  Versions 21 and laterMode for managing the encoding of parameter value: | | paramWithDecoding
(Default value) | The parameter value is automatically decoded by WEBDEV according to the encoding/decoding standard of URLs. | | paramNoDecoding | The raw value of the parameter is returned. No decoding is performed by WEBDEV. This constant can be used when the URL encoding does not respect the standard used by WEBDEV (problem for managing the + sign, etc.) |
 New in version 21Mode for managing the encoding of parameter value: | | paramWithDecoding
(Default value) | The parameter value is automatically decoded by WEBDEV according to the encoding/decoding standard of URLs. | | paramNoDecoding | The raw value of the parameter is returned. No decoding is performed by WEBDEV. This constant can be used when the URL encoding does not respect the standard used by WEBDEV (problem for managing the + sign, etc.) |
| | paramWithDecoding
(Default value) | The parameter value is automatically decoded by WEBDEV according to the encoding/decoding standard of URLs. | | paramNoDecoding | The raw value of the parameter is returned. No decoding is performed by WEBDEV. This constant can be used when the URL encoding does not respect the standard used by WEBDEV (problem for managing the + sign, etc.) |
Versions 16 and later New in version 16 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. The PageParameter function allows you to obtain a value that is not linked to an control. Example: The PageParameter function is used to retrieve a position in a clickable Image. For the click areas, during a mouse click, you have the ability to retrieve the horizontal and vertical position of the mouse in the click area via a specific parameter: "POS" (see the example). Retrieving the parameters passed to an AWP or PHP page The PageParameter function is used to retrieve the value of the parameters passed to the. 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 according to the 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: Retrieval according to the parameter indexThe parameter index corresponds to the order in which the parameters were passed in the page URL.
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)
Versions 20 and laterPre-launched sessions If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site". New in version 20Pre-launched sessions If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site". Pre-launched sessions If your project uses pre-launched sessions, this function must not be used in the "Initializing" event of the project. This function must be used in the event "Initializing the project after connection to the site". Versions 21 and later New in version 21
Related Examples:
|
Training (WEBDEV): WW_Organizer
[ + ] The WW_Organizer example is an example for using the Organizer control of WEBDEV.
|
|
|
|