Init
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)
Errors = SRP_PropertyPanel(PanelCtrl, "Init", ItemList, ColWidth, Colors)
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: "B" - two boolean values | V |
<x, 5> | Conversion | (Optional) Oconv during panel entry SVM Iconv for get/set value. | |
<x, 6> | DropList | (Optional) SVM list for boolean or custom dropdowns. | |
<x, 7> | Value | Any value to pre-fill into the data section. |
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" |
Dropdown Image Reference
| Frame | Abbrev. | Description |
|---|---|---|
| 1 | CAL | Calendar |
Errors
If there are and duplicate keys, they will be noted and returned in the service's response.
SetValue
Sets a value into the property panel, based on the property key and value provided.
SRP_PropertyPanel(PanelCtrl, "SetValues", PropertyKey, Value)
PropertyKey
A property currently assigned in the property panel; referenced by its key.
Value
The value to assign to the above property (conversion settings apply).
SetValues
Sets a group of values into the property panel, based on the property keys and values provided in a list format.
SRP_PropertyPanel(PanelCtrl, "SetValues", Values)
Values
| Pos | Name | Description |
|---|---|---|
<x, 1> | PropertyKey | One of the properties currently in the panel; referenced by its key name. |
<x, 2> | Value | The value to assign to the above property (conversion settings apply). |
GetValue
Gets a property value based on the provided key.
rv = SRP_PropertyPanel(PanelCtrl, "GetValue", PropertyKey)
PropertyKey
A key to the property value to retrieve.
GetKeys
Gets an field-marked list of all the keys/properties associated with the current panel.
List = SRP_PropertyPanel(PanelCtrl, "GetKeys")
GroupExpanded
Used to programmatically control the expand / collapse display of a single group.
SRP_PropertyPanel(PanelCtrl, "GroupExpanded", GroupKey, Boolean)
GroupKey
The key to the group to expand or collapse.
Boolean
1 to expand, 0 to collapse.
CollapseAll
Collapses all the groups and properties in the panel.
SRP_PropertyPanel(PanelCtrl, "CollapseAll")
ExpandAll
Expands all the groups and properties in the panel.
SRP_PropertyPanel(PanelCtrl, "ExpandAll")
Examples
Init
ItemList = ""
ItemList<-1> = 1 :@VM: "Load"
ItemList<-1> = 2 :@VM: "Status"
ItemList<-1> = 2 :@VM: "Entered" :@VM: "" :@VM: "D" :@VM: "D4/":@SVM:"D"
ItemList<-1> = 2 :@VM: "Agent"
ItemList<-1> = 1 :@VM: "Carrier"
ItemList<-1> = 2 :@VM: "No."
ItemList<-1> = 2 :@VM: "NameCar" :@VM: "Name"
ItemList<-1> = 2 :@VM: "MC No."
ItemList<-1> = 2 :@VM: "DOT No."
ItemList<-1> = 1 :@VM: "Shipper"
ItemList<-1> = 2 :@VM: "NameShip" :@VM: "Name"
ItemList<-1> = 2 :@VM: "PhoneShip" :@VM: "Phone" :@VM: "" :@VM: "[PHONE_FORMAT]":@SVM:"[PHONE_FORMAT]"
ItemList<-1> = 1 :@VM: "Cosignee"
ItemList<-1> = 2 :@VM: "NameCon" :@VM: "Name"
ItemList<-1> = 2 :@VM: "PhoneCon" :@VM: "Phone" :@VM: "" :@VM: "[PHONE_FORMAT]":@SVM:"[PHONE_FORMAT]"
ColWidth = 100 :@FM: "A"
Errors = SRP_PropertyPanel(Panel$, "Init", ItemList, ColWidth)
Init - Result
SetValues
Rec = Xlate("LOADS", KeyId, "", "X")
Values = ""
Values<-1> = "Status" :@VM: Rec<063>
Values<-1> = "Entered" :@VM: Rec<001>
Values<-1> = "Agent" :@VM: Rec<004>
Values<-1> = "No." :@VM: Rec<003>
Values<-1> = "NameCar" :@VM: Xlate("LOADS", KeyId, "CARRIER_NAME", "X")
Values<-1> = "MC No." :@VM: Rec<064>
Values<-1> = "DOT No." :@VM: Rec<104>
Values<-1> = "NameShip" :@VM: Rec<013>
Values<-1> = "PhoneShip" :@VM: Rec<101>
Values<-1> = "NameCon" :@VM: Rec<018>
Values<-1> = "PhoneCon" :@VM: Rec<102>
SRP_PropertyPanel(Panel$, "SetValues", Values)
SetValues - Result
GetValue
rv = SRP_PropertyPanel(Panel$, "GetValue", "PhoneCon")
GetValue - Result
RollUpAll - Result
