The means to initially configure and display the property panel. (Note: to use the Date-type dropdown requires the NDW_DATEPICKER form and associated routines).
Usage
Errors = SRP_PropertyPanel(PanelCtrl, "Init", ItemList, ColWidth, Colors, FontArray)
Parameters
ItemList
Pos | Name | Description | Default |
---|---|---|---|
<x, 1> | Level | The item's level in the panel - 1 is the group, 2 is the property. | |
<x, 2> | PropertyKey | The key to each property - must be unique. | |
<x, 3> | PropertyName | (Optional) The text label to use as the property name. | Key |
<x, 4> | Type | (Optional) The type of entry / type of cell (see below). | V |
<x, 5> | Conversion | (Optional) Oconv :SVM: Iconv | |
<x, 6> | Params | (Optional) dropdown list or parameters depending on Type (see below). | |
<x, 7> | Value | (Optional) Any value to pre-fill into the data section. | |
<x, 8> | Visible | (Optional) show or hide a specific property. | True |
<x, 9> | Fields | (Optional) User defined value pairs associated with a property. | |
<x,10> | Force Update | (Optional) Forces update to a cell after dropdown selection. | False |
ColWidth
The width of each of the two columns, @FM delimited. Can be a number or "Auto" (default is Auto).
Colors
The default colors of the property panel:
Field | Description | Default |
---|---|---|
<1> | Headers & Gridlines | defaults to a light grays, RGB(240,240,240) |
<2> | Selection | defaults to "Select" |
<3> | Background | defaults to "White" |
FontArray
Field | Name | Value |
---|---|---|
<1> | Group | Standard font parameter |
<2> | Property | Standard font parameter |
<3> | Value | Standard font parameter |
Types
(B)oolean
Position | Description |
---|---|
<x,6,1> | Value to be considered as true / yes / 1 |
<x,6,2> | Value to be considered as false / no / 0 |
(COL)or
Call the color picker dialog. Returns the color value formatted based on user requirement
Position | Description | Default |
---|---|---|
<x,6,1> | How the resulting color should be returned: DEC : decimal format HEX : # hex color number RGB : R, G, B | DEC |
<x,6,2> | Prevent the cell background from displaying the selected color | No |
(C)ustom
Position | Description |
---|---|
<x,6,x> | SVM list of items to appear in the dropdown |
(D)ate
Requires the window NDW_DATEPICKER. Default button will be Segoe MDL2 Assets #E787, which is a calendar image.
(O)ption
Position | Description |
---|---|
<x,6,1> | Name of window to launch when the button is clicked. Button image defaults to the 3-dots "...". |
<x,6,2> | (Optional) For custom button images, the font to use. "GM" for Google Material Icons (requires download and install), "SA" for Segoe MDL2 Assets |
<x,6,3> | (Optional) The hex code to use to display the appropriate font image reference. |
(V)archar
This is the default and does not have to be specified. This is for standard, plain text entries.
CheckBo(X)
This will add a checkbox to the cell, which operates like a standard OI checkbox which returns a 1 or 0 depending on its checked state.
Errors
If there are and duplicate keys, they will be noted and returned in the service's response.