ControlExecuteClosing (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing controls

ControlExecuteClosing

ControlExecuteClosing

ControlExecuteModification

CoordinateEditorToScreen

CoordinateScreenToEditor

Functions for managing controls

InvalidInputShowTooltip

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

ControlExecuteClosing (Function)

In french: ChampExécuteFermeture

Runs the closing process of an office control and displays its confirmation dialog if necessary.

Example

// Click the VALIDATE button
IF NOT ControlExecuteClosing(PSHEET_Spreadsheet) THEN
RETURN
END
Close()

Syntax

<Result> = ControlExecuteClosing(<Office control>)

<Result>: Boolean

If the closing process of control returns a value (True or False), <Result> corresponds to this value.
If the closing process of control returns no value:
if ..Modified on the control is set to True, a confirmation dialog is displayed: <Result> is set to False if the user asks not to close the document, True otherwise.
if ..Modified on the control is set to False, the function returns True.

<Office control>: Control name

Name of office control to use. This control can correspond to:
a Spreadsheet control,
a Word Processing control,
an Image Editor control,
a PDF Reader control.

Remarks

This function is automatically called by the ribbon of office controls (Spreadsheet, Word Processing, Image Editor or PDF Reader controls) on the following user actions:
- New.
- Open.
- Drag and Drop a document to the control.
This function performs the following operations:
- Running the "Before closing the document" process.
- If this process returns a value (True or False), the function stops and returns this value.
- If this process returns no value:
  - if ..Modified on the control is set to True, the function displays a confirmation dialog to the user and it returns False if the user asks not to close the document.
  - if ..Modified on the control is set to False, the function returns True.
This function can be called for example when closing a window or before a new content is assigned to the control.
The following code allows you to display the confirmation dialog only:

bCloseOK = AAFExecute(PSHEET_Spreadsheet, aafClosingDialog)
The following code allows you to run the closing code of document only:

ExecuteProcess(PSHEET_Spreadsheet, trtBeforeClosingDocument)

Component : wd250obj.dll