Kinetic Control Compendium

hmwillett · October 26, 2023, 4:50pm

Selection List

Allows a user to select and sort a collection of data items.

This control has a few different flavors to it and can be changed up visually in a number of different ways.

Property Group	Property	Description
Basic	Id	Unique identifier for the control
Basic	Label Text	Sets the label within the control. (Fig. A)
Behavior	On Blur	Click this to create an OnBlur event for the control. On Blur is triggered when the control loses focus.
Behavior	On Create	Click this to create an OnCreate event for the control On Create is triggered when the control is painted to the GUI.
Comments	Comments	Add some developer notes to the control. These are not customer-facing and are only visible in App Studio (Fig. B)
Data	Key Field	Indicates that a bound component is a key field. If true, the field is enabled if there is no current record, allowing the user to select an existing record or create a new one. Not relevant to this control.
Data	EpBinding	Bind the control to a DataView.Column. This is used to store the delimited list of items. Can be used to apply row rules to the control.
Data	List	This can be used to define hard coded items for the list instead of a dataview.
Data > List	Id	Unique ID for the item. (Fig. C)
Data > List	Text	Set the text value for the item (Fig. C)
Data > List	Id Name	Obsolete
Data > List	Description	Set the detailed description for the item (Fig. C)
Data > List	SubText	Set the sub-text value for the item. Doesn’t seem to do anything.
Data > List	LeftIcon	Set the icon for the list item. Doesn’t seem to do anything.
Data > List	Command	Set the command string for the list item. No clue here.
Data > List	Selected	Set the flag to indicated if the item is selected by default. (Fig. C)
Data > List	Checkmark Hidden	Set the flag to indicate if the selected item has a hidden checkmark. Seems weird, but okay. (Fig. C)
Data > List	Toggle Disabled	Set the flag to indicate if the item is disabled. This works, as in you cannot select it, but there’s no visual indicator to indicate that. (Fig. C)
Data > List	Required	Set the flag to require this list item. (Fig. C)
Data > List	Bookmark	Set the flag indicating the list item has a bookmark. #Shrug
Dataviews	Source View Name	Set the view name used to populated the source list. Format: DataView
Dataviews	Source Table Name	Set the table name used to populate the source list. Unsure on this one. It’s not clear what a table is within the context of App Studio.
Dataviews	Source Code Col	Column name used to populate the source list item ID. Format: ColumnName
Dataviews	Source Desc Col	Column name used to populate the source list item description. Format: ColumnName
Dataviews	Target View Name	Set the view name used to populated the targetlist. Format: DataView
Dataviews	Target Table Name	Set the table name used to populate the target list. Unsure on this one. It’s not clear what a table is within the context of App Studio.
Dataviews	Target Code Col	Column name used to populate the target list item ID. Format: ColumnName
Dataviews	Target Desc Col	Column name used to populate the target list item description. It yells at you in Dev Tools if you populate this. Format: ColumnName
Dataviews	Table Name	Set the table name used with source AND target codes and descriptions
Dataviews	Parent Related Col	Set the name of the column on the parent table. Used when binding to parent/child related tables.
Dataviews	Child Related Col	Set the name of the column on the child table. Used when binding to parent/child related tables.
Dataviews	Related Col	Set the shared name of the column on both the parent and child tables. Used when binding to parent/child related tables.
Layout	Alignment	Sets the alignment of the control. (Fig. D)
Layout	Width	Sets the specific width (pixels) for the control. (Fig. E)
State	Personalizable	If true, a user can personalize this component(hide/show)
State	Customizable	If true, a user can customize this component in child layers
State	Hidden	Hides the control from view.
State	Disabled	Disables the control. The control will not allow editing or focus.
State	Read Only	Makes the control read only so that it will not allow editing. The control can still be focused.
State	Auto Focus	When enabled, the control is automatically focused on creation.
Advanced	Target Label Text	Set the label text for the target list. (Fig. F)
Advanced	Mode Type	Set the display mode. Valid options include: Single and Dual. (Fig. G)
Advanced	UI Mode	Set the selection mode. Valid options include: Select, Switch, SingleSelect (Doesn’t really stop you), Checkbox. (Fig. H)
Advanced	Position Mode	Set the position of the text. Valid Options Include: Left or Right (Fig. I)
Advanced	Reorder	Set the reorder mode. Valid Options Include: Select or All (Fig. J)
Advanced	Header	Sets the label text for the list. Only used on Panel Mode. Not sure what panel mode is, but it ain’t this!
Advanced	Limit	Sets the limit of the items to be displayed. Only used on Panel Mode. Not sure what panel mode is, but it ain’t this!
Advanced	Rows	Sets the number of items to be displayed (can scroll for more). Used in all modes except Panel. (Fig. K)
Advanced	Manual Sort	Sets the flag indicating if a sort button should be shown. Doesn’t do anything. Might be only for “Panel Mode”
Advanced	Show Edit	Set the flag indicating if an edit button should be shown. Only for Panel Mode. WTF IS PANEL MODE??
Advanced	Enable Edit	Set the flag indicating if editing of list items is allowed. Only used on… you guess it… Panel Mode.
Advanced	Enable Header Edit	Sets the flag indicating if the edit button should be presented at the top of the list. OnLy UsEd In PaNeL mOdE.
Advanced	Value Primitive	Specify the type of the selected value. If set to true, the selected value has to be of a primitive value.
Advanced	Delimited	Set the flag indicating if the multi-select value for binding is delimited. This is required for multi select.
Advanced	Delimiter	Set the delimiter character. Valid options include: ~ , ` (tilde, comma, tick).
Advanced	EpiLabel	Obsolete
Advanced	Draggable	Obsolete