Edit Configuration Parameter Dialog

This dialog allows you to create or edit a configuration parameter.

Edit Configuration Parameter Dialog

Parameter

Name

This field defines the name of the configurable item.

Display Name

A short description of this item the authoring tool may use in the user interface. You can localize this string.

Description

A description of this item the authoring tool may use in UI elements. You can localize this string.

Type

Specifies the type for the data being changed. This type is used to provide a context for any user-interface and is not used in the merge process.

Default Value

A default value for the item in this record if the merge tool declines to provide a value. You can localize this string.

Attributes

Not nullable

At merge time, a value must be specified for this item. It cannot be null.

Do not merge unreferenced rows.

This attribute only applies to records that list a foreign key to a module table in their Default Value field. The merge tool does not merge the row referenced by the Default Value column into the target database if the following conditions are satisfied after completing all configuration options:

  • Every row in the Module Configuration table with the same Default Value has this attribute set.
  • No rows use the Default Value because the authoring tool declined to provide a value.

The merge tool incorporates the row if any of the following conditions are satisfied:

  • The merge tool finds any row that does not have this attribute set.
  • If the merge tool finds any row using Default Value because the authoring tool declined to provide a value.

Bitfield

NoteThis section of the dialog is displayed only if you select Bitfield as the data type.

Mask

An integer value indicating the bits of interest from the bitfield.

Adding a new bit to the bitfield

Use the [ Add... ] button to the “Add...” context menu option.

Editing a bit from the bitfield

Use the [ Edit... ] button, the “Edit...” context menu item or press the Space key while an element is selected.

Removing a bit from the bitfield

Use the [ Remove ] button, the “Remove” context menu option or press the Delete key while an item from the list is selected.

ImportantThe “Value” attribute indicates the position of the bit in the bitfield. It should be a power of two integer number in order for the configuration to work properly.

Enumeration

NoteThis section of the dialog is displayed only if you select Enumeration as the data type.

Adding an item to the enumeration

Use the [ Add... ] button or the “Add...” context menu option.

Editing an item from the enumeration

Use the [ Edit... ] button, the “Edit...” context menu item or press the Space key on a selected element.

Removing an item from the enumeration

Use the [ Remove ] button, the “Remove” context menu option or press the Delete key while an item from the list is selected.

Ordering items

Use the [ Up ] / [ Down ] buttons, the “Move Up” / “Move Down” context menu options or press the Page Up / Page Down keys while an element from the list is selected.