Page History
...
Pos | Name | Type | Description | Default |
---|---|---|---|---|
<1> | Data | Text | The item's data | "" |
<2> | Data Type | |||
<2, 1> | Type | Option | The item's data type, used to make sorting accurate and efficient | Text |
<2, 2> | Format | Formatted String | The item's data format, used to present the data to the user | "" |
<3> | Class | Text | The item's class, an application specific string used for classification purposes | "" |
<4> | Image | Formatted String | The item's image, either a file or a key pointing to a global image | "" |
<5> | Colors | |||
<5, 1> | Text Color | Color | The color of the item's text | WindowText |
<5, 2> | Background | Color Fill | The item's background | Window |
<6> | Font | Font | The font used to render the item's data | Tahoma, 8 pt. |
<7> | Alignment | |||
<7, 1> | Horizontal | Option | The horizontal alignment of the item's data | Left |
<7, 2> | Vertical | Option | The vertical alignment of the item's data | Center |
<8> | Sort | Option | The item's sort setting | None |
<9> | Check Box | Option | The item's check box setting | None |
<10> | Expandable | Boolean | Whether or not the item can be expanded or collapsed by the user | 1 |
<11> | Height | Integer | The item's height | 16 |
<12> | Hyperlink | Boolean | Whether or not the item displays hyperlink feedback to the user | 0 |
<13> | Selectable | Boolean | Whether or not the item can be selected by the user | 1 |
<14> | Swatch Color | Color Fill | A custom colored rectangle that appears at the beginning or end of an item | None |
<15> | Swatch Position | Option | The position of the swatch, if there is one: Left or Right | Left |
<16> | Swatch Size | |||
<16, 1> | Width | Integer | The swatch width, in pixels, if there is one | 13 |
<16, 2> | Height | Integer | The swatch height, in pixels, if there is one | 13 |
<17> | Fields | List of user defined fields and their values: each value has the following format: | "" | |
<17, x, 1> | Field Name | Text | The unique field name | "" |
<17, x, 2> | Field Value | Text | The field's value | "" |
Indices
Description | |
---|---|
Index | key An item's unique key |
...
Swatches are custom colored rectangles that appear before or after an item's content. This little feature can be used in some applications to indicate some kind of status for an item. Perhaps a red swatch indicates an error that needs to be addressed. Three fields define a swatch. Field <14> defines it's color, field <15> sets its position, and field <16> sets it's size. See ItemSwatchColor, ItemSwatchPosition, and ItemSwatchSize for details.
Fields
Each item can have any number of user defined fields added to it. Field <17> allows you to set them all at once. Each value in this field is a key/value pair. Each value has two sub-values: field name and field value. The field name can be any unique string, and the value can be anything you want. See ItemField or ItemFields for details.
...