UPDATE Function (Dialog)
Updates the value of a '#'-or '@' field in the active window.
Dialog.UPDATE([Number] [, Value1])
Parameters
- Dialog
Type: Dialog The dialog box that you want to update.
- Number
Type: Integer Each '#' or '@' field has a specific number. The Number argument tells into which field the Value should be inserted. If you omit this parameter, then all '#' or '@' fields in the active window are updated.
- Value
Type: Any This value or expression can be any simple C/AL data type such as Boolean, Option, Integer, Decimal, Date, Time, Text, and Code. If you omit this value, then the value from the variable in the OPEN Function (Dialog) call is used.
Remarks
This function is not supported by Microsoft Dynamics NAV Web client or Microsoft Dynamics NAV Portal Framework for Microsoft SharePoint 2010.
When you have a function that contains Dialog.UPDATE(Number,Value) and the value is a variant, you must format the text constant to make sure that the variant type can consume the text constant.
In Microsoft Dynamics NAV, the text constant is read as type AL_TEXTCONST, which cannot be interpreted by the variant.
You can use the FORMAT Function (Code, Text) to convert the text constant to a string type, which can be interpreted and displayed by the variant.
Example
The following example shows how to update '#' fields in a window.
This code example requires that you create the following variables and text constants in the C/AL Globals window.
| Variable name | DataType | Length |
|---|---|---|
AccountInfo |
Text |
1024 |
AccountNo |
Integer |
Not applicable |
TotalSum |
Decimal |
Not applicable |
MyDialog |
Dialog |
Not applicable |
| Text constant name | Constant value |
|---|---|
Text000 |
Account no. #1######\ |
Text001 |
shows a total of $ #2###### |
AccountInfo := Text000 + Text001;
AccountNo := 5634;
TotalSum := 1000;
MyDialog.OPEN(AccountInfo); // Opens a window with '#'-fields.
SLEEP(5000);
MyDialog.UPDATE(1, AccountNo); // Fills in field 1.
SLEEP(5000);
MyDialog.UPDATE(2, TotalSum); // Fills in field 2.
SLEEP(5000);
When the dialog box first opens, the following information is displayed:
Account no. . . . . shows a total of $. . . . . . .
After the first SLEEP call, the value of the AccountNo variable is inserted. After the second SLEEP call, the value of the TotalSum variable is inserted.