# GraffitiPropertyList
Class Inherits GraffitiListBox
## About
GraffitiPropertyList emulates the PropertyList control seen in many software development IDEs.Features:
*
Boolean Properties
*
Single-line String Properties
*
Multi-line String Properties
*
Integer Properties
*
Image Properties
*
Color Properties
*
Read-only Properties
*
Fully customizable list properties
*
Custom Value Modification Buttons
*
Categorization
*
Cell AutoComplete
*
Save to XML
*
Load from XML
## Preview
Previous
Next
## Compatibility
### Framework API Version
| 1.0 | 2.0 |
| :---: | :---: |
| True | True |
### Console
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
### Desktop
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
### iOS
| 32-Bit | 64-Bit |
| :---: | :---: |
| False | True |
### Web
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
## Attributes
| Name | Value |
| --- | --- |
| DefaultEvent | "ValueChange" |
## Event Definitions
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| Closing | (None) | (None) | (None) |
| CollapseHeader | currHeader as PropertyListheader | (None) | Fired when a header is collapsed. |
| ColorEdit | Node as PropertyListChild | Boolean | Fired when the user attempts to edit a color cell. |
| CustomCellClick | Node as PropertyListChild <br> X as Integer <br> Y as Integer | (None) | Fired when a cell of type kChildCustom is clicked. |
| CustomIconPaint | g as Graphics <br> Node as PropertyListChild | (None) | Fired when the icon is being painted for a cell of type of kChildCustom. |
| ExpandHeader | currHeader as propertyListheader | (None) | Fired when a header is expanded. |
| HeaderBackgroundPaint | g as graphics | Boolean | Fired before any background painting is carried out on headers. Return true if you draw to the graphics context. |
| MouseOver | currHeader as PropertyListheader <br> currChild as propertyListchild | (None) | Raised when the user mouses over a head or child. |
| NameBackgroundPaint | g as graphics <br> IsSelected as Boolean | Boolean | Raised before drawing is carried on child name backgrounds. Return true if you modify the graphics context. |
| Open | (None) | (None) | (None) |
| UnusedBackgroundPaint | g as Graphics | Boolean | Triggered when the class is about to draw empty rows. Return True if you modify the graphics context. |
| ValueBackgroundPaint | g as Graphics <br> IsSelected as Boolean | Boolean | Raised when the background of a value cell is being drawn. |
| ValueChange | Node as PropertyListChild <br> Tag as String = "" | (None) | Fired when the value of a PropertyListChild has changed. |
## Methods
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| FindChild | ChildText as String <br> ChildValue as String | PropertyListChild | Find the child matching the specified criteria. |
| FindChildInHeader | HeaderText as String <br> ChildName as String | PropertyListChild | Finds the child matching the specified criteria within a certain header. |
| FindHeader | HeaderText as String | PropertyListHeader | Find the header matching the specified criteria. |
| FindHeaderByChild | SearchChild as PropertyListChild | PropertyListheader | Returns the header of the specified child. |
| FromJSON | data as String | (None) | Reloads the PropertyList instance using the JSON data provided. |
| FromXML | XMLString as String | (None) | Populates the propertylist from an XML string. |
| LockUpdate | (None) | (None) | Prevents the UI from updating until UnlockUpdate is called. |
| Reload | (None) | (None) | Clears and rebuild the component's display. |
| RemoveHeader | HeaderText as String | Boolean | Removes a header from the display. |
| Reset | (None) | (None) | Resets the PropertyList to its default state without content. |
| ToJSON | preserveWhitespace as Boolean = True | String | Exports all contained data as a JSON string. |
| ToXML | (None) | String | Exports the current state to an XML string. |
| UnlockUpdate | (None) | (None) | Updates the UI of any changes carried out during the LockUpdate period. |
## Properties
| Name | Type | Default Value | Description |
| --- | :---: | :---: | --- |
| AutoEdit | Boolean | (None) | If True, clicking a value cell automatically begins editing. |
| CustomStyle | Boolean | (None) | If true, will use custom color properties for drawing. |
| ExpanderColor | Color | (None) | Color applied to the row tree expanders. |
| HeaderBGColor | Color | (None) | Background color for header items. |
| HeaderBold | Boolean | (None) | Font weight of header item text. |
| HeaderItalic | Boolean | (None) | Text decoration of header text. |
| Headers() | PropertyListHeader | (None) | Array of header items. Changes to this property will not be propagated unless you call Reload(). |
| HeaderTextColor | Color | (None) | Text color of header items. |
| HeaderTextFont | String | (None) | Text font of header items. |
| HeaderTextSize | Integer | (None) | Font size of header items. |
| HeaderUnderline | Boolean | (None) | Text decoration of header text. |
| HeadingName | String | (None) | Text displayed in the header for the name column. |
| HeadingValue | String | (None) | Text displayed in the header for the value column. |
| IconColor | Color | (None) | Color applied to the edit icons for rows' values. |
| NameBGColor | Color | (None) | Background color of child names. |
| NameBGHighlight | Color | (None) | Background highlight color of child names. |
| NameBold | Boolean | (None) | Font weight of child names. |
| NameItalic | Boolean | (None) | Italicize child names. |
| NameTextColor | Color | (None) | Text color of child names. |
| NameTextFont | String | (None) | Text font of child names. |
| NameTextSize | Integer | (None) | Font size of child names. |
| NameUnderline | Boolean | (None) | Text decoration of child names. |
| ResizeColumns | Boolean | (None) | Allow users to resize columns. |
| RowHeight | Integer | (None) | The height of each row. |
| UnusedBGColor | Color | (None) | Color used to fill unused area of the control. |
| ValueBGColor | Color | (None) | Background color of child values. |
| ValueBGHighlight | Color | (None) | Background highlight color of child values. |
| ValueBold | Boolean | (None) | Font weight of child values. |
| ValueItalic | Boolean | (None) | Italicize child values. |
| ValueTextColor | Color | (None) | Text color of child values. |
| ValueTextFont | String | (None) | Text font of child values. |
| ValueTextSize | Integer | (None) | Font size of child values. |
| ValueUnderline | Boolean | (None) | Text decoration of child values. |
