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