ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Web-specific functions / Page functions
  • Characteristics of Cell controls
  • Special cases
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
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
CellDisplayDialog(CELL_Question, cellCenter, True, 50)
Syntax
CellDisplayDialog(<Cell control> [, <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:
cellBottomLeftThe Cell control is at the bottom left of the visible part of the current page.
cellBottomRightThe 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.
cellPositionXYThe Cell control remains at its current position.
cellTopLeftThe Cell control is at the top left of the visible part of the current page.
cellTopRightThe 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 Cell controls

  • The Cell control must be overlayable ("UI" tab of the Cell control description window).
  • To avoid displaying unnecessary scrollbars in the browser, check the "Force position at the top left of the page when loading" option ("Advanced" 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 CellDisplayDialog is taken into account.
Remark: To run server code from a Cell control, use AJAXExecute or AJAXExecuteAsynchronous.

Special cases

  • CellDisplayDialog 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 CellCloseDialog.
  • Browsers do not refresh pages in the middle of JavaScript code: CellDisplayDialog and CellCloseDialog 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 CellDisplayDialog.
Component: WDJS.DLL
Minimum version required
  • Version 12
Comments
Click [Add] to post a comment

Last update: 04/17/2024

Send a report | Local help