4D Doc Center : SET FIELD TITLES

4D v13.4

SET FIELD TITLES


SET FIELD TITLES ( aTable ; fieldTitles ; fieldNumbers {; *} )

aTable	Table	Table for which to set the field titles
fieldTitles	String array	Field names as they must appear in dialog boxes
fieldNumbers	Longint array	Actual field numbers
*		Use the custom names in the formula editor

Description

SET FIELD TITLES lets you mask, rename, and reorder the fields of the table passed in aTable or aSubtable when they appear in standard 4D dialog boxes, such as the Query editor, within the Application environment (more specifically, when the editors are called using 4D language commands).

Using this command, you can also rename on the fly the labels of the fields in your forms, if you used dynamic names. For more information about inserting dynamic field and table names in forms, refer to the 4D Design Reference manual.

The fieldTitles and fieldNumbers arrays must be synchronized. In the fieldTitles array, you pass the name of the fields as you would like them to appear. If you do not want to show a particular field, do not include its name or new title in the array. The fields appear in the order you specify in this array. In each element of the fieldNumbers array, you pass the actual field number corresponding to the field name or new title passed in the same element number in the fieldTitles array.

For example, you have a table or subtable composed of the fields F, G, and H, created in that order. You want these fields to appear as M, N, and O. In addition you do not want to show field N. Finally, you want to show O and M in that order. To do so, pass O and M in a two-element fieldTitles array and pass 3 and 1 in a two-element fieldNumbers array.

The optional * parameter indicates whether or not custom names defined using this command can be used in 4D formulas.

By default, when this parameter is omitted, formulas executed in 4D cannot use these custom names; it is necessary to use the real table names. Using custom names gives you greater freedom for naming fields since the language interpreter does not process custom names
If the * parameter is passed, the names defined by this command are used in the formulas executed by 4D. Be careful in this case, the custom names must not contain characters that are “forbidden” by the 4D language interpreter, like -?*! (for more information, refer to the “Identifiers” section).

Note: If your application provides access to the formula editor (for example via the Quick report editor), you must pass the * parameter in order to ensure interface consistency.

SET FIELD TITLES does NOT change the actual structure of your table. It only affects subsequent uses of the standard 4D dialog boxes and forms using dynamic names when they are called using language commands (the real structure of the database is displayed when the editor or form is called from a menu command in Design mode). The scope of the SET FIELD TITLES command is the worksession. One benefit in Client/Server mode is that several remote 4D stations can simultaneously “see” your table in different ways. You can call SET FIELD TITLES as many times as you want.

Use the SET FIELD TITLES command for:

Dynamically localizing a table.
Showing fields the way you want, independent of the actual definition of your table.
Showing fields in a way that depends on the identity or custom privileges of a user.

WARNING:

SET FIELD TITLES does NOT override the Invisible property of a field. When a field is set to be invisible at the Design level of your database, even though it is included in a call to SET FIELD TITLES, it will not appear in Application mode.
Plug-ins always access the "virtual" structure as specified by this command.

Example

See example for the SET TABLE TITLES command.