4D v13.4
OPEN SETTINGS WINDOW
- 4D Language Reference
-
- 4D Environment
-
- ADD DATA SEGMENT
- Application file
- Application type
- Application version
- BUILD APPLICATION
- Compact data fileUpd
- COMPONENT LIST
- CREATE DATA FILEUpd
- Data file
- DATA SEGMENT LIST
- FLUSH BUFFERS
- Get 4D folderUpd
- Get database localization
- Get database parameterUpd
- GET MEMORY STATISTICS
- GET SERIAL INFORMATION
- Get table fragmentation
- Is compiled mode
- Is data file locked
- NOTIFY RESOURCES FOLDER MODIFICATION
- OPEN ADMINISTRATION WINDOW
- OPEN DATA FILEUpd
- OPEN SECURITY CENTER
- OPEN SETTINGS WINDOWUpd
- PLUGIN LIST
- QUIT 4D
- SET DATABASE LOCALIZATION
- SET DATABASE PARAMETERUpd
- Structure file
- VERIFY CURRENT DATA FILE
- VERIFY DATA FILE
- Version typeUpd
OPEN SETTINGS WINDOW
| OPEN SETTINGS WINDOW ( selector {; access}{; settingsType} ) | ||||||||
| Parameter | Type | Description | ||||||
| selector | String |
|
Key designating a theme or a page or a group of parameters in the Preferences or Settings dialog box | |||||
| access | Boolean |
|
True=Lock the other pages of the dialog box False or omitted=Leave the other pages of the dialog box active | |||||
| settingsType | Longint |
|
0 or omitted = Structure settings, 1 = User settings | |||||
The OPEN SETTINGS WINDOW command opens the Preferences dialog box of 4D or the Database Settings of the current 4D application and displays the parameters or the page corresponding to the key passed in selector.
The selector parameter must contain a “key” indicating the dialog box and the page to opened. This key is constructed as follows: /Dialog{/Page{/Parameters}}. Dialog indicates the dialog box to be displayed: you can pass "4D" (for the Preferences) or "Database" (for Database Settings). For example, to indicate the Compiler page of the Database Settings, selector should contain "/Database/Compiler". The list of keys that can be used is provided below. If you just pass a slash ("/") in selector, the command displays the first page of the Database Settings dialog box.
The access parameter lets you control user actions in the Preferences or Database Settings dialog box by locking the other pages. Typically, you may want for the user to be able to customize certain parameters while preventing others from being modified. In this case, passing True in the access parameter means that only the page specified by the selector parameter will be active and modifiable, while access to all other pages will be locked (clicking on the buttons in the navigation bar will have no effect). If you pass False or omit the access parameter, all the pages of the dialog box will be accessible with no restriction.
The settingsType parameter is taken into account in databases configured in "User settings" mode only (in this mode, custom "User settings" are generated in an external file and used instead of the standard settings, see the Design Reference manual). In this context, this parameter lets you indicate whether you want to access the "Structure settings" or the "User settings" dialog box. You pass one of the following constants, found in the "4D Environment" theme:
| Constant | Type | Value | Comment |
| Structure Settings | Longint | 0 | Access to "Structure settings" (default value if parameter omitted). In this mode, values used for selector are identical to those in standard mode. |
| User Settings | Longint | 1 | Access to "User settings". In this mode, only certain keys can be used in the selector parameter |
If you pass an invalid key, the first page of the Database Settings dialog box is displayed.
Here are the keys that can be used in the selector parameter in standard mode, in other words with the "Structure settings":
/4D
/4D/General
/4D/Structure
/4D/Form editor
/4D/Method editor
/4D/Client-Server
/4D/Shortcuts
/Database
/Database/General
/Database/Mover
/Database/Interface
/Database/Interface/Developper
/Database/Interface/User
/Database/Interface/Shortcuts
/Database/Compiler
/Database/Database
/Database/Database/Data storage
/Database/Database/Memory and cpu
/Database/Database/International
/Database/Backup
/Database/Backup/Scheduler
/Database/Backup/Configuration
/Database/Backup/Backup and restore
/Database/Client-Server
/Database/Client-Server/Network
/Database/Client-Server/IP configuration
/Database/Web
/Database/Web/Config
/Database/Web/Options 1
/Database/Web/Options 2
/Database/Web/Log format
/Database/Web/Log scheduler
/Database/Web/Webservices
/Database/SQL
/Database/php
/Database/Compatibility
/Database/Security
Compatibility note: You can still use keys defined for previous versions of 4D with this command; 4D automatically establishes the correspondence. However, we recommend that you replace the former calls with the keys listed above.
Here are the keys that can be used in the selector parameter in "User settings" mode:
/Database
/Database/Interface
/Database/Database/Memory and cpu
/Database/Client-Server
/Database/Client-Server/Network
/Database/Client-Server/IP configuration
/Database/Web
/Database/Web/Config
/Database/Web/Options 1
/Database/Web/Options 2
/Database/Web/Log format
/Database/Web/Log scheduler
/Database/Web/Webservices
/Database/SQL
/Database/php
Open the “Methods” page of the 4D Preferences:
OPEN 4D PREFERENCES("/4D/Method editor")Open the “Shortcuts” parameters in the Database Settings while locking the other settings:
OPEN 4D PREFERENCES("/Database/Interface/Shortcuts";True)Open Database Settings on the first page:
OPEN 4D PREFERENCES("/")Access to the Interface page of the Database settings in "User settings" mode:
OPEN 4D PREFERENCES("/Database/Interface";1)If the Preferences/Settings dialog box is validated, the system variable OK returns 1. Otherwise, it returns 0.
Product: 4D
Theme: 4D Environment
Number:
903
Modified: 4D v11 SQL
Modified: 4D v12
Modified: 4D v13
Renamed: 4D v13
Settings, Preferences, Database parameters, Database settings***
