4D v13.4

OPEN SETTINGS WINDOW

Home

 
4D v13.4
OPEN SETTINGS WINDOW

OPEN SETTINGS WINDOW 


 

OPEN SETTINGS WINDOW ( selector {; access}{; settingsType} ) 
Parameter Type   Description
selector  String in Key designating a theme or a page or a group of parameters in the Preferences or Settings dialog box
access  Boolean in True=Lock the other pages of the dialog box False or omitted=Leave the other pages of the dialog box active
settingsType  Longint in 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.

 
PROPERTIES 

Product: 4D
Theme: 4D Environment
Number: 903

The OK variable is changed by the command

 
INDEX

Alphabetical list of commands

 
HISTORY 

New
Modified: 4D v11 SQL
Modified: 4D v12
Modified: 4D v13
Renamed: 4D v13

 
TAGS 

Settings, Preferences, Database parameters, Database settings***