Container

From Morfik Wiki

The Container control is used mainly for aggregating other visual controls.

	Key properties:	Border Style, Border Color, Border width, Color, Shrink On Hide
	Key events:
	Server Code:	Container = Class(TWebControlContainer)
	Browser Code:	Container = Class(TWebControl)

Graphical States

States	Appearance	Description
Normal		The default state for the control when no other state is active.
Mouseover		This view is displayed when the user moves the cursor over the control
Disabled		This view is displayed when the control's ability to receive input is disabled.

Learn more about Morfik Styles and Themes.

Layout

It is requested that a screenshot or screenshots be included in this article to improve its quality. () ()

'

Properties

Property	Description
BackgndImage	The BackgndImage property may be used to specify a picture to be displayed by the Container.
Border Color	The BorderColor property specifies the color that should be used for drawing a rectangular border around the Control. Note: the border will not be visible unless the BorderStyle and BorderWidth properties are also set.
Border Sides	The BorderSides property specifies the parts of a control's border that are displayed.
Border Style	The BorderStyle property of the control defines how and if a border will be drawn around the control.
Border width	The Border Width property specifies the line width used to draw the rectangular border around the Control. Note: the border will not be visible unless the BorderColor and BorderStyle properties are also set.
Can Grow	The CanGrow property determines the behavior when the Caption text is too large to fit into the Control: if CanGrow=No, the Control retains its design-time height if CanGrow=Scroll, the Control retains its design-time height, but allows the end user to scroll through the text if CanGrow=Yes, the Control increases its height to accommodate the text
Can Shrink	The CanShrink property determines the behavior when the Caption text is too small to completely fill the Control: if CanShrink=False, the Control maintains its design-time height if CanShrink=True, the Control decreases its height to accommodate the text Note: enabling CanShrink has no effect unless CanGrow is also enabled. Using this property only makes sense if the control will contain data bound controls. If there is only a small amount of content to be displayed within the control, its height will be reduced so that it elegantly displays the content without leaving large blank areas in the page. More information on how controls can grow and shrink at runtime is available under the topic Plastic Layout.
Color	The Color property specifies the background color of the Control.
Cursor	The Cursor property, if set, causes the appearance of the mouse cursor to change as it moves over the Control.
Enabled	If the Enabled property is set to false, the Control's state (ticked or unticked) cannot be changed by the user. Note For Timer Control: This property controls whether the Timer event will be triggered at the time interval specified in the Interval property. If the Enabled property is set to false, the Timer event will not be triggered.
Font	The Font property (and its sub-properties Color and Name) is used to indicate which font should be used for drawing the text in the Control.
Height	The Height property specifies the vertical extent of the Control. Note: if the CanGrow or CanShrink properties are set, the actual height of the Control at run time may be different.
Hint	The Hint property, if set, specifies the text of a tooltip that is displayed when the user moves the cursor over the control.
Horizontal Placement	The HorizontalPlacement property, if set, governs how the Control adjusts its size and position in response to changes in the horizontal dimensions of its parent.
Hyperlink	The IsHyperlink property, when set to true, turns the Caption of the Control into a hyperlink. This is most often used when the Control is bound to a hyperlink field.
Layout	The Layout property determines the way child controls are arranged inside the container.
Left	The Left property specifies the horizontal position of the Control in the form.
Margins	The Margins property clears an area around control (outside its border).
Name	The Name property specifies the identifier used to reference the control from browser- or server-side code.
Opacity	The Opacity property determines the extent to which the Control obscures any controls placed in its background. A value of 0 means that background controls are fully visible, whereas a value of 100 means that background controls are completely obscured.
Shared Style	The SharedStyle property can be used to force several controls always have the same appearance.
Shrink On Hide	The ShrinkOnHide property specifies how Morfik's Layout engine repositions other controls when the container's visibility is changed at runtime.
Tab Order	The TabOrder property allows the developer to specify the order in which controls should receive input focus when the user steps through them using the tab key.
Tag	The Tag property is used to store user data that is associated with the control.
Top	The Top property specifies the vertical position of the Control in the form.
Vertical Placement	The VerticalPlacement property, if set, governs how the Rectangle adjusts its size and position in response to changes in the vertical dimensions of its parent.
Visible	The visible property is used to make controls visible or invisible. Invisible controls are frequently used to allow for easy access to information from a database table field, if the control is bound to one.
Width	The Width property specifies the horizontal extent of the Form/control.

Events (browser-side)

Event	Description
On After Grow Or Shrink	This event is fired within the browser after the height of a control is adjusted in order to fit its new content.
On Before Grow Or Shrink	This event is fired within the browser before the height of a control is adjusted in order to fit its new content.
On Blur Event	This event is fired within the browser when a control loses focus either by the pointing device or by tabbing navigation.
On Click	The most commonly used event for a TextLabel control is the OnClick event, which should be handled to execute whatever action is intended when a control is clicked.
On Double Click	This event is fired when the user clicks on a control within the browser.
On Focus	This event is fired within the browser when a control receives focus either by the pointing device or by tabbing navigation.
On Hyperlink Click	This event is fired in the browser just after a hyperlink is clicked and before the requested navigation is carried out.
On Mouse Down	This event is fired within the browser when the mouse button, or any other pointing device button, is pressed while it is over a control. On a PC-based mouse, it specifically relates to the left-hand mouse button being depressed.
On Mouse Out	This event is fired when the mouse pointer, or any other pointing device button, is moved out of the region defined by a control.
On Mouse Over	This event is fired when the mouse pointer or any other pointing device is over (within the region defined by) a control.
On Mouse Up	This event is fired within the browser when the mouse button, or any other pointing device button, is released over a control. On a PC-based mouse, it specifically relates to when the left-hand mouse button is being released.
On After Pushed Or Pulled	This event is fired within the browser after the position of a control has changed in response to a change in the content of a sibling control.
On Before Pushed Or Pulled	This event is fired within the browser before the position of a control is changed in response to a change in the content of a sibling control.

Events (server-side)

Event	Description
On After Print	This event is fired on the server by a Control after its HTML (or in the case of Report generation, PDF) content is generated.
On Before Print	This event is fired by a control on the server before control’s HTML (or in the case of Report generation, PDF) content is generated.
On Print Style	This event is fired on the server to allow for CSS style changes when the HTML representation of a control is being constructed.

Remarks

Run-time behavior

Container supports growing and shrinking at run-time in vertical direction, making it possible to adjust Container height when space allocated by it contents changes. Set Can Grow property to enable expanding of a Container when its contents requires more space and Can Shrink to enable collapsing when its contents requires less space. Set Shrink On Hide to perform height adjustment of the parent Form and realigning sibling controls when container is shown or hidden. Refer to Plastic Layout page to learn more.

Graphical effects

If there is a graphical effects associated with Containers supporting growing and shrinking, Morfik compiler generates sliced images to enable resizing of a background image at run-time. If Container having graphical effects is not supposed to be resized at run-time, it's the best to set its Can Grow to No and Can Shrink to False - then no slices will be generated resulting in less amount of images to be downloaded which leads to a better performance.

Search

Navigation

SEARCH

TOOLBOX

LANGUAGES