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.
{{http:www.ecyrious.comcontrolimagestdesignerpanel.jpg?nolink&}}
**Similar Components**
The panel is the basis for all aggregate containers. The [[:trzpanel_pricing_form_object|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_pricing_form_object|TRzPanel Pricing Form Object]].
|~ Property||~ Values||~ Default||~ Description/Notes||
|DisplayedInfo||Any [[:enumerated_types_used_in_pricing_form_objects|]]||pmdText||Determines what text is displayed on the panel||
|DisplayedPrice||Any [[:enumerated_types_used_in_pricing_form_objects|]]||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 [[:enumerated_types_used_in_pricing_form_objects|]]||pmdText||Determines the text displayed in the mouse-over hint.||
|HintDisplayedPrice||Any [[:enumerated_types_used_in_pricing_form_objects|]]||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|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
\\