Add/Edit Item dialog box

In particular, this check box is taken into consideration for representation of property value.

For example, for Integer type the default representation of value 111 is: VALUE = 111. Inline representation is: VALUE = Integer32:111.

Select a representation in which the property value will be saved in the configuration. Each type has its own specific set of representations. Select the type of representation which is appropriate for you. Only a limited set of types has specific representations. The following table describes the list of additional representations with the corresponding types:

• Edit Binary Data
• Edit Boolean
• Edit Date/Time
• Edit Float Point
• Edit Identifier
• Edit Integer
• Edit Multiline String
• Edit Object

The format of the value definition depends on the value of Representation and Inline type information options.

When specifying an item value the following format should be used:

• For Boolean type strings "true", "yes", "on" and "1" represent a values of true, and strings "false", "no", "off" and "0" represent a value of false.
• For Date/Time type there are two representations: default and Local date/time. For the default representation the following format should be used: yyyy-MM-dd HH:mm:ss (4 digit year and 24 hour time are required). For the local representation, the time should be represented in the user’s locale settings. Inline representation requires inclusion of the value in quotation marks.
• For Floating point type a number can be represented with simple or exponential record using '.' (point) character as decimal point symbol. Special values are represented with strings: "+INF", "-INF" and "NAN". 64 bit float point range is supported.
• For Identifier type a value should be represented as "{8-4-4-4-12}", like {1A589494-AC8A-4FF7-814D-7EEFE306A033}.
• For Integer type a value should be represented in decimal form in 32 bit signed range.
• For String type a value should be represented as is. Since string is not encoded, the special characters (like line separation or Unicode characters which do not belong to the current user language) cannot be stored in the configuration file. However if an RRT of another component is used as the string value, then that component can pass an arbitrary string as an RRT. Empty strings are also supported. Inline representation requires inclusion of the value in quotation marks and encoding content like the C strings do (using backslashes '\’).
• For Binary type the default representation is the sequence of hexadecimal digits and blank separators. All separators are ignored. If required, the value is post-padded with "0" digit to fit into 8-bit bound. For example, the following strings represent the same value: "0d0a5570" , "0d0a 5570", "0 d0a 557".
  • Binary from file. Instead of hexadecimal value specify the file path here in same form as for string value. When the component stores this field it reads the file and place its content into the field value.
  • Binary from UNICODE string. Instead of hexadecimal value specify the string here in same form as for string value. The string content will be passed into the binary value. Each character will be represented with 16 bits of UTF16 encoding. No null-terminator will be appended.
  • Binary from ANSI string. Instead of hexadecimal value specify the string here in same form as for string value. The string content will be passed into the binary value. Each character will be represented with 8 bits of ANSI encoding using the Windows user code page. No null-terminator will be appended.

The above rules describe the format of the simple type. To store values of such fields the component creates VALUE entry which contains the above format.

• Object type in default representation (when Inline type information is OFF) contains additional entry CLASS which contains string value of the object’s class name. It does not have VALUE entry. Instead it has set of subtopics each named FIELD. Each subtopic contains information about one field of the object. Therefore, it’s impossible to replace value of the Object using RRT in default representation. To do that use inline representation (when Inline type information is OFF).

Any type in enumeration and list cardinality in default representation (when inline is OFF) does not have VALUE entry. Instead it has a set of subtopics each named ITEM. Each subtopic contains information about one item of the list (its representation and value). Therefore it’s impossible to replace value of the enumeration or list using RRT in default representation. To do that use inline representation.

Example:

This example demonstrates representation of list of objects. The list contains one item. The item is object with two fields: "f1" and "f2". Other information is omitted for simplicity.

TYPE = Object
CLASS = MyClass
CARDINALITY = LIST
INLINE = NO
ITEM { 
      INLINE = NO
      FIELD {
            NAME = f1
            VALUE = abcd
      }
      FIELD {
            NAME = f2
            VALUE = 123
      }
}

Inline representation of the same example is:

INLINE = YES
VALUE = List Object "MyClass": {{"f1"="abcd", "f2"= 123}}

• Check — Always check value of this item.
• Do not check — Never check value of this item.
• Default — Use parent (list or enumeration) settings.