<Cell>.DisplayDialog (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Characteristics of the Cell control
Special cases

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Cell>.DisplayDialog (Function)

In french: <Cellule>.AfficheDialogue

Displays a Cell control in a page with a DDW effect (Dim Disabled Windows). This function is used to easily simulate a dialog box in browser code, by using a Cell control in a page.

For more details, see Communicating with the Web user.

Example

// Display a Cell control containing a question
CELL_Question.DisplayDialog(cellCenter, True, 50)

Syntax

<Cell control>.DisplayDialog([<Display position> [, <Take DDW into account> [, <Dimming rate>]]])

<Cell control>: Control name

Name of the Cell control that will be displayed.

<Display position>: Optional Integer constant

Display position of cell:
cellBottomLeft The Cell control is at the bottom left of the visible part of the current page.
cellBottomRight The Cell control is at the bottom right of the visible part of the current page.
cellCenter
(Default value) The Cell control is centered in the visible part of the current page.
cellPositionXY The Cell control remains at its current position.
cellTopLeft The Cell control is at the top left of the visible part of the current page.
cellTopRight The Cell control is at the top right of the visible part of the current page.

<Take DDW into account>: Optional boolean

True (default) to display the Cell control with a DDW effect (the page displayed behind the Cell control is grayed)
False to disable the DDW effect.

<Dimming rate>: Integer

Rate of gray (included between 0 and 100) used by the DDW.
The maximum value (100) will be used if the specified value is greater than 100.
The DDW is ignored if the specified value is less than 0. The default rate of gray is set to 18%.

Remarks

Characteristics of the Cell control

The Cell control must be overlayable ("Details" tab of the Cell control description window).
To avoid displaying unnecessary scrollbars in the browser, check the option "Automatic positioning when loading to avoid the scrollbars" ("Details" tab of the Cell control description window). This option is used to automatically position the Cell control at position (0,0) when loading the page. Then, the display position defined by <Cell>.DisplayDialog is taken into account.

Remark: To run server code from a Cell control, use AJAXExecute or AJAXExecuteAsynchronous.

Special cases

<Cell>.DisplayDialog must be used to display the Cell control:
- in a "None" button. In this case, only the browser code of the button will be executed.
- in a "Submit" button and activate AJAX in the code of this button. In this case, the browser and server codes of the button will be executed.
The Cell control displayed can be hidden with <Cell>.CloseDialog.
The browsers do not refresh the display in the middle of a JavaScript code: <Cell>.DisplayDialog and <Cell>.CloseDialog must be used in different events/processes. If these functions are used in the same event/process, the Cell control is not displayed.
It is not possible to display two different Cell controls at the same time using <Cell>.DisplayDialog.

Component: WDJS.DLL