{$page}
The DesignerPanel object (TDesignerPanel) is a component used in the pricing form designer. It is a “container” component located on the Group Boxes tab in designer.
www.ecyrious.comcontrolimagestdesignerpanel.jpg_aligncenter
Similar Components
The panel is the basis for all aggregate containers. The trzpanel_pricing_form_object is the basic panel used in the pricing form designer.
Key Properties
This object adds several new properties not found in TRzPanel.
| ~ Property | ~ Values | ~ Default | ~ Description/Notes | ||||
| DisplayedInfo | Any pmdValue | pmdText | Determines what text is displayed on the panel | ||||
| DisplayedPrice | Any pmpValue | pmpPrice | Determines what price is displayed on the panel. Ignored when DisplayedInfopmdText | ||||
| DisplayedFormula | any CFL string expression | (blank) | Changed the caption to the value of this formula. Ignored except when DisplayedInfopmdFormula | ||||
| HintDisplayedInfo | Any pmdValue | pmdText | Determines the text displayed in the mouse-over hint. | ||||
| HintDisplayedPrice | Any pmpValue | pmpPrice | Determines what price is displayed in the mouse-over hint. Ignored when HintDisplayedInfopmdText | ||||
| ModifierCode | Any Modifier | (none) | Specifies the modifier used by certain pmd Types in the DisplayedInfo and HintDisplayedInfo | ||||
| VariableName | Any Variable | (none) | Specifies the variable used by certain pmd Types in the DisplayedInfo and HintDisplayedInfo | ||||
| VisibilityFormula | any CFL boolean expression | (blank) | Hides the panel if the formula returns False (zero), otherwise the panel is visible. |
Other Properties
Most objects share common properties that behave similarly. See common_pricing_form_object_properties for more information.
There are no other properties introduced in TDesignerPanel that are not found in TRzPanel.
Notes about Usage
- Hiding a panel makes everything on the panel hidden as well.
- Components on a panel maintain their own hidden status. Showing a panel does not change the Visibility property of the children, but does show them if they should be visible.
- Refreshing visibility fields requires complex calculations every time any variable or modifier is changed. Having lots (> 25) of different visibility formulas can impact the refresh speed. It is better in these cases to put the common items on a panel and hide or show the entire panel.
- Two panels can exist in the same place. You can toggle what is displayed by changing the two visibility formula using negative logic.
Examples
Displaying the SubTotal Price as a Panel Caption
Situation: You want to display the total price (including child items) as the caption for the form.
Properties to Set
- DisplayedInfo pmdPrice
- DisplayedPrice pmpMeAndSonsPrice
To move the displayed information to the top-left of the panel, you'll need to set some of the “Advanced” properties by clicking on the “Advanced” button and reselecting the panel:
* Alignment taLeftJustify
- AlignmentVertical avTop
Hiding a Panel Based on a Formula
Situation: You have a number of components that you want to hide or show in a particular situation (when the Complexity is “High”). Rather than set the visibility formula on each component, put all the components on a TDesignerPanel and use the panels visibility formula. (You can even hide the panel borders so it doesn't look like a panel.)
Properties to Set
- VisibleFormula Complexity “High”
To hide the borders, you'll need to set some of the “Advanced” properties by clicking on the “Advanced” button and reselecting the panel:
* BorderInner fsNone
- BorderOuter fsNone
Source
Contributor: Cyrious Software
Date: 8/1/2009
Version: Control 4.4
See Also
- Backlinks include_pagepage_componentbacklinks