sys_upd_confirm()

Purpose

Obtains confirmation for current changes

Old name

#define upd_confirm sys_upd_confirm

Syntax

int sys_upd_confirm(void);

Description

The sys_upd_confirm() function provides a standard method of confirming changes.

The function map_choose() is called to select an option from map 185 of the system mapset of the SYSTEM database:

1 Save changes
2 Rekey changes
3 Abandon changes

Return values

Returns the option chosen. Escaping from the menu selects option2 "Rekey changes".

This function is used by map_get_inputs() and QAB programs to confirm changes. You can replace this function with your own version if required.

This function is always automatically returns 1 "Save Changes" if you have a Windows or SAA userdata.sys file. The reasoning behind this is that a program will normally only arrive in the routine after the user has already pressed Enter or clicked an OK button to confirm changes. Without SAA Pressing Enter on the last field of a dialog usually prompts a call to sys_upd_confirm(), but with SAA or Windows pressing Tab on the last field of a dialog will either wrap around to the first field, or stick on the last field, but not attempt to exit the dialog.