4D v16.3Form properties |
||
|
4D v16.3
Form properties
Form properties
Form properties are set in the Property List of the Form editor. You can change the form type, i.e. its destination. For project forms, there are two types available: Detail Form and Detail Form for Printing. For table forms, two additional types are also available: List Form and List Form for Printing. This property determines the options that appear in the Property List for the form. It also allows you to restrict the number of forms displayed in the current Input and Output form selection lists (the List of tables window, see Browsing different tables and forms): only forms whose type corresponds to the list are displayed. The Form Type property is found at the top of the Property List. When the form type is None, it is displayed in both menus of the List of tables. Note: You can also set the form type using the Form Properties window specific to the Explorer (see Form Properties (Explorer)). These properties are described in Using inherited forms. The default window title is used when the form is opened using the Open window and Open form window functions in the Application environment. The default window title appears in the Title bar of the window. To set the default window title, enter it in the Window Title entry area of the Property List. You can use dynamic references to set the window titles for forms, i.e.:
Notes:
The Editable by user property is used to indicate that the form can be customized by the users via the user form editor in the Application mode (see User forms). Implementing this mechanism requires additional settings as well, which are described in User Forms of the 4D Language Reference manual. Note: You can set the Editable by user property using the Form Properties window specific to the Explorer (see Form Properties (Explorer)). When the Editable by user property is checked, the form is locked. When you open a form with this property, a padlock icon appears in the toolbar and it is not possible to make any modifications. You must click on this icon to unlock the form — in this case, any user forms become obsolete and must be regenerated. When the Editable by user property is checked, the Property List also has padlocks indicating the locked properties. You can click on these icons to “open” the padlocks and thus make the corresponding properties editable in the user form editor . You can also use the context menu available in the theme bar (64-bit versions only): When the Save Geometry option is checked, if the window is opened using the Open form window command with the * parameter, several form parameters are automatically saved by 4D when the window is closed, regardless of how they were modified during the session:
Note: This option does not take into account objects generated using the OBJECT DUPLICATE command. In order for a user to recover their environment when using this command, the developer must repeat the sequence of creation, definition and positioning of the objects. When this option is checked, the Save Value option is also available for certain objects. For more information and several examples of use, refer to Memorization of window geometry. The Do not invert objects option disables the “right-to-left” mode for the form. The “right-to-left” mode (Windows only) causes the database form objects and titles to be inverted. It is used in the context of languages that are read from right to left (such as Arabic). For more information about activating this mode, refer to the “Right-to-left Languages” section in Interface page . When the Do not invert objects option is checked for a form, the right-to-left mode is never applied to this form in Application mode, regardless of the database configuration. This option can be used, for example, to set “international” forms within a database configured in right-to-left mode. This option is found in the Property List, as well as in the Form Properties (Explorer) dialog box. Note: This property can also be managed by programming using the FORM GET PARAMETER command. A form is always displayed in a window. 4D lets you set the size of both the form and the window, as well as their respective behavior when resized. You set the form size properties using the “Form Size” theme of the Property List. The following choices are available:
When an input form is displayed in a custom application, you ordinarily open the form using the Open window or Open form window functions. Open window lets you specify the top, left, bottom, and right coordinates of the window as well as the window type. In this case, the size of the window does not depend on that of the form. On the other hand, the resizing possibilities will depend on the options set in the “Form Size” theme and on the window type. Open form window creates a new window based on the sizing and resizing properties of the form passed as parameter. You can set form window resizing in the Property List.The following options are available:
As a general rule, it is necessary to prevent the user from hiding enterable areas and control buttons. The platform interface property sets the appearance of a form according to the context of its execution. This property can also be set individually for each form object (see the “Platform” section in Setting object display properties). Two interface properties are available: System and Printing. They are used as follows: When displayed on screen, a form must respect the current operating system interface (System). When it is set to be printed, the appearance of objects must be adapted (Printing), regardless of the platform.
This form property activates the textured look for the form when it is displayed using the Open form window command on Mac OS. This look is found throughout the Mac OS X interface: If the form is displayed in a window that was not created by Open form window (for example in the Design mode), the property will not be taken into account. Under Mac OS, the metal look is previewed in the Form editor when the Textured option is checked and when the form limits are displayed. When the form is executed under Windows, this option has no effect. Checking this option hides the grow box in a form window. This option is taken into account when you call the form using the DIALOG command for example. The print properties are described in Printing a form. When you create an application, you can create custom menus. Custom menus allow you to add menu commands for automating specific tasks in the database, such as, for example, creating a report. Custom menus are created in the Menu Bar editor. Each menu bar that you create includes at least one menu and is assigned a unique ID number and name. For more information on creating menu bars, menus and menu commands, refer to the chapter Menus and menu bars. To assign a menu bar to a form, select a menu bar from the “Associated Menu Bar” List in the Property List. The [...] button lets you access the menu bar editor directly (see Menus and menu bars). In the Application environment, a menu bar that is assigned to a form is added to the right of the current menu bar. If the menu bar of the form is identical to the current menu bar, it is not added. The form menu bar will operate for both input and output forms.
Note: You can also associate a menu bar with a form in the Form Properties (Explorer) dialog box. You can control access to a form by setting Access and Owner privileges for groups of users. A single group can be assigned for each privilege using the Access and Owner drop-down lists. For information about creating a password access system with users and groups, see the chapter Users and groups. The Access drop-down list controls which group can use the form in the records display window or in custom applications. If a user that is not in this group attempts to use the form, 4D displays a message saying that the user’s password does not allow him or her to use the form. The Owner drop-down list controls which group can edit the form in the Design environment. If a user who is not in this group attempts to open the form in the Design environment, 4D displays a message saying that the user does not have the access privileges needed to edit the form. Users who are assigned to both groups can use the form in both the Design environment and in custom applications. To set access privileges for a form:
You can also assign access groups to a form in the Form Properties (Explorer) dialog box. 4D allows you to associate a custom on-line help file with each database. The creation of help files is described in Appendix A: Assigning a custom help file. Help files can be contextual, which means that they can display information related to the context from which they were called. To do so, you can associate a Help Topic Number to a form. Make sure you assign help topic numbers that match numbers defined in the help file. This is done in the “Help” theme of the Property List . The Edit... button lets you access the Form method. This is covered in Editing methods. This area lets you specify the precise location of markers on the vertical ruler of the form. Markers are mainly used in output forms. They control the information that is listed and set header, breaks, detail and footer areas of the form. For more information about the use of control markers, see Using output control lines. Note: The label width triangle on the horizontal ruler controls the width of a label when you create a form for printing mailing labels using the PRINT LABEL command. This area sets the events that can lead to the execution of the form method. When the form is used, only the events that you select will actually occur. If you do not select any events, the form method will never be called. To select or deselect all events, hold down Ctrl (under Windows) or Command (under Mac OS) and click an event.
See also
|
PROPERTIES
Product: 4D
HISTORY
ARTICLE USAGE
4D Design Reference ( 4D v16) |