AP SET PARAM

version 11 (Modified)

Compatibility Note: This command is now obsolete; it is kept only for compatibility reasons and will be removed in future versions of the plug-in. It is strongly recommended to use the SET DATABASE PARAMETER command of 4D.

AP SET PARAM (option; value)

The AP SET PARAM command allows you to set the internal 4D options usually set with 4D Customizer Plus. These options are stored in the CUST ID=0 resource which consists in a table of integer values numbered from 0 to n.

The integer values are as follows:

• 0 - If the value is 0, it is not possible to open a desk accessory while a 4D printing progress window is displayed. If the value is 1, it is possible to open a desk accessory when such a window is displayed. The default value is 0.

• 1 - If the value is 0, it is not possible to open a desk accessory while a sequential operation (search, sort...) progress window is displayed. If the value is 1, opening a desk accessory is possible while such a window is displayed. In the Windows version, the value -3 signifies that 4D does not use an offscreen bitmap to perform graphical updates to the screen. All drawing operations are directly performed on the screen. If the value is -4, at start-up 4D allocates a permanent offscreen buffer corresponding to the size and depth of your screen; it then uses this buffer to perform offscreen bitmap-based graphical updates. The default value is 0.

Values other than those described specify that for each screen update 4D tries to allocate a corresponding buffer (provided there is enough memory to do so). If this is successful, 4D performs an offscreen bitmap-based update and then disposes of the buffer. Activating the offscreen bitmap-based updates allows you to eliminate screen blinking when many objects have to be redrawn.

A permanent offscreen buffer may take some space (i.e., 300K for a 640 x 480, 256 color screen), so for low memory configurations you may want to set this option to a value other than -3 or -4. Setting this option to -4 when memory is not an issue allows you to accelerate drawing operations. Deactivating offscreen bitmap-based updates (setting the option to -3) to take the screen updating scheme into account may solve incompatibility issues with 4D plug-ins that have not been updated under Windows.

• 2 - Sets the speed of rotation of the spinning cursor when 4D executes formulas. If the value is 0, the spinning cursor does not appear. A positive or negative value sets the speed of rotation to modulo 32. The average value to pass is 16. The default value is 0.

• 3 - Contains the ASCII code for the shortcut generating a new subrecord or record in the active included area of a data entry. The default value is 47 ([/] Key).

• 4 - Contains the value of the modifier key associated with option 3. The default value is 256 (Command Key). Possible values include: 256 for the Command (Ctrl) Key, 512 for Shift Key, 1024 for the Caps Lock Key, 2048 for the Option (Alt) Key.

• 5 - Contains the ASCII code for the shortcut generating the validation of a data entry. The default value is 3 (Enter Key).

• 6 - Contains the value indicating the modifier key associated with the character indicated by option 5. The default value is 0 (no modifier key).

• 7 - Contains the ASCII code for the shortcut generating the cancellation of a data entry. The default value is 46 ([.] Key).

• 8 - Contains the value indicating the modifier key associated with option 7. The default value is 256 (Command Key).

• 9 - Contains the ASCII code for the validation shortcut. The default value is 3 (Enter Key).

• 10 - Contains the value indicating the modifier key associated with option 9. The default value is 0 (no modifier key).

• 11 - Contains the ASCII code for the shortcut generating the cancellation of a dialog box. The default value is 46 ([.] Key).

• 12 - Contains the value indicating the modifier key associated with option 11. The default value is 256 (Command Key).

• 13 - Indicates the default positioning of the main 4D window. If the value is 0, the window is set to the size of the screen with its title bar visible under the menu bar. If the value is 1, the window is set to the size of the screen with its title bar hidden under the menu bar. If it is 2, the window is sized with the coordinates specified by options 14, 15, 16 and 17. If it is 3, the window is sized with the coordinates specified by options 14,15,16, and 17, but is centered in the middle of the screen. Finally, if the value is 4, the window appears with the size and location it had in the previous working session. The default value is 4.

The next four options have a default value equal to -1 and are only used if option 13 contains 2 or 3:

• 14 - Indicates the top coordinate of the 4D window.

• 15 - Indicates the left coordinate of the 4D window.

• 16 - Indicates the bottom coordinate of the 4D window.

• 17 - Indicates the right coordinate of the 4D window.

• 18 - Indicates if the main 4D window is resized when you switch to the Runtime environment. If the value is 0, the window is not resized. If it is 1, the window is resized according to option 13. The default value is 0.

• 19 - Indicates if the main 4D window is resized after the execution of a 4D method called from a custom menu. If the value is 0, the window is not resized. If it is 1, the window is resized according to option 13. The default value is 0.

• 20 - Reserved. Do not modify this option.

• 21 - Reserved. Do not modify this option.

• 22 - Reserved. Do not modify this option.

• 23 - Reserved. Do not modify this option.

• 24 - Reserved. Do not modify this option.

• 25 - Indicates if the During phase of a form method is called when you cancel a data entry. If the value is 0, the During phase is not triggered, otherwise it is triggered. The default value is 0.

• 26 - Indicates if the automatic switch of the read only/read write status of the tables is performed by operations such as display or printing of a selection. If the value is 0, the automatic switch is performed. If it is 1, the automatic switch is not performed. The default value is 0.

Options beyond 26 are reserved. Do not modify them.

If you want the cursor to be a spinning wheel when it executes your commands, call:

   AP SET PARAM(2;16)

AP GET PARAM.