SET FIELD TITLES

version 11 (Modified)

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

SET FIELD TITLES enables you to mask, rename, and reorder the fields of the table or subtable 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 via the 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 will 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 lets you indicate 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.

• If the * parameter is passed, the names defined by this command can be 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: At the formula editor level, the execution of this command without the * parameter does not modify any settings made previously with the * parameter. In other words, the formula editor always displays the custom name set via the last call of the command with the * parameter.

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 via 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 is that several 4D Client 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.

• Each call to SET FIELD TITLES must be followed or preceded by a call to SET TABLE TITLES — even though you do not want to modify the table title — otherwise the command will have no effect.

• Plug-ins always access the "virtual" structure as specified by this command.

See example for the SET TABLE TITLES command.

Field name, Get last field number, SET TABLE TITLES.