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



{{::http:www.ecyrious.comcontrolimagestdesignerpanel.jpg_aligncenter?nolink&|}}



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_pricing_form_object|TRzPanel]].



||~ Property ||~ Values ||~ Default ||~ Description/Notes ||
|| DisplayedInfo || Any [[enumerated_types_used_in_pricing_form_objects|pmdValue]] || pmdText || Determines what text is displayed on the panel ||
|| DisplayedPrice || Any [[enumerated_types_used_in_pricing_form_objects|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 [[enumerated_types_used_in_pricing_form_objects|pmdValue]] || pmdText || Determines the text displayed in the mouse-over hint. ||
|| HintDisplayedPrice || Any [[enumerated_types_used_in_pricing_form_objects|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]]