SET FIELD TITLES

version 2004.2 (Modified)

SET FIELD TITLES (table | subtable; fieldTitles; fieldNumbers{; *})

SET FIELD TITLES enables you to mask, rename, and reorder the fields of the table or subtable passed in table or subtable when they appear in standard 4th Dimension dialog boxes, such as the Query editor, within the User or Custom Menus environments.

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 4th Dimension 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 4th Dimension. 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 4th Dimension dialog boxes and forms using dynamic names within the User or Custom Menus environments. 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.

• 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.

See example for the SET TABLE TITLES command.

Count fields, Field name, SET TABLE TITLES.