original_pages:tdesignerpanel_pricing_form

{$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