<value>

It is the main field to store data. This field allows to define an entry, or a combobox in the window.

It can contain the following fields: <function>, <dependencies>, <edit_command>

The parameters are as follows,

n - Name used to reference the field, especially when writing the .dat file.

pn - Label that will be visualized by the user. It can be translated.

v - The value or default value for a 'value' field

state - Specifies one of the four states for the entry: normal, disabled, hidden or readonly. If the entry is readonly, then the value may not be changed using widget commands and no insertion cursor will be displayed, even if the input focus is in the widget; the contents of the widget may still be selected. If the entry is disabled, the entry may not be changed, no insertion cursor will be displayed and the contents will not be selectable. Note that hidden entry can be used for storing hidden values. It also permits to define a Tcl function, by means of square brackets.

values_tree - Permits to define a TCL function, by means of square brackets, and returns a combobox with a list of strings.

values - Comma-separated list of strings.

For instance, values="mech,therm"

dict - Comma-separated list of key,value. This operation places a mapping from the given key to the given value, which is shown in the GUI. Values can be translated.

For instance, dict="mech,Mechanical,therm,Thermal" shows Mechanical and Thermal.

string_is - Tests the validity of various interpretations of a string, as follows,

integer - To test if a string is an integer value.

integer_or_void - To test if a string is an integer value, or empty (not-filled).

double - To test if a string is a double value.

double_or_void - To test if a string is a double value, or empty (not-filled).

% - To test if a string is a percentage (%)

list_of_double - To test if a string is a list of doubles, representing a data structure of doubles in Tcl.

help - It displays a pop-up window of help information related to the task the user is performing.

actualize_tree - Itupdates the information in the whole data tree, and automatically refresh data shown in the user interface. It is a boolean value as a 1 or 0 that indicates if it is activated or deactivated. If the data source is changed, such as new fields have been added or data values and field have been modified, all the user interface will reflect those changes. Furthermore, all the TCL procedures defined in the data tree will be called and the whole data tree will be refreshed. Therefore, this instruction must be carried out only when necessary.

actualize - This only updates a specified field in data tree. Note that only this specified field will be refreshed in the user interface, and not the whole data tree. It is a boolean value as a 1 or 0 that indicates if it is activated or deactivated.

update_proc - It calls a TCL procedure, when clicking on the 'Ok' button in the window or when changing the value of the entry. Square brackets are not supported.

menu_update - It allows to update the menus.Values can be yes or no. It is necessary to define a <dependencies> field, as follows,

<dependencies node="/*/blockdata[@n='General_Data']/value[@n='analysis_type']" att1="menu_update" v1="[TCL_proc]" actualize="1"/>

fieldtype - It creates a box in the user interface in order to introduce a text. It can be:

longtext - A text box is created.

editable - It is a boolean value as a 1 or 0 that indicates if the entry could be changed or not. If it is activated (1) the entry may not be changed, no insertion cursor will be displayed and the contents will not be selectable.

unit_magnitude - Physical quantity (i.e. L, for Length). For more information about this attribute, see the sectionDescription of the units

units - Unit of the physical quantity (i.e. m). For more information about this attribute, see the sectionDescription of the units

function - Contains a Tcl command, which is executed when is called. It permits to create or edit a function for a determined entry.

function_func - Permits to define a TCL function.

values_check - It allows to handle a Tcl function, by means of square brackets.

min_two_pnts - It is a boolean value as a 1 or 0 and indicates that two points or more are required in a linear interpolation.

unit_definition - The fields <value/> used to choose the default units in the GUI are special. They contain the attribute called unit_definition="magnitude" being magnitude the name 'n' to be used in that field. It is important to note that these kind of fields does not contain dependencies.

show_in_window - Can be 1 or 0 (1 by default). It indicates if the value must be shown in the conditions window. If set to 0, the value will be shown in the tree, but will be hidden in the window.

Example:

<value n='units_length' pn='Length' unit_definition='L'/>

<value n='units_mass' pn='Mass' unit_definition='M'/>

<value n='units_force' pn='Force' unit_definition='F'/>

unit_mesh_definition - The field <value/> used to choose the mesh unit is special. It has the attribute unit_mesh_definition="1", and it does not contain any "v" attribute or dependencies.

Example:

<value n="units_mesh" pn="Geometry units" unit_mesh_definition="1"/>

units_system_definition - The field <value/> used to choose the units system is special. It has the attribute units_system_definition="1", it does not contain any "v" attribute, and it contains a unique dependency related to the units fields.

Example:

<value n='units_system' pn='Units system' units_system_definition='1' icon='units-16'>

<dependencies node="//*[@unit_definition or @unit_mesh_definition='1']" att1='change_units_system' v1='{@v}'/>

</value>