piColumnSpan - cWebBaseControl

Determines the control's width in the containing object's column layout

Type: Property (Web Property)

Access: Read/Write

Data Type: Integer

Parameters: None

 { WebProperty=Client }
 Property Integer piColumnSpan

Web Property Read Access: WebGet piColumnSpan to IntegerVariable
Web Property Write Access: WebSet piColumnSpan to IntegerVariable/Value

Read Access: Get piColumnSpan to IntegerVariable
Write Access: Set piColumnSpan to IntegerVariable/Value


Container objects, such as cWebView or cWebPanel, support a column layout system to position any child controls. A control's X coordinate placement and width is determined by its piColumnIndex and piColumnSpan properties and its parent's piColumnCount property. The parent piColumnCount property determines how many equally spaced columns are created. piColumnIndex determines which column the control starts in and piColumnSpan determines how many columns the control will span. The actual width is determined by the number of columns and the width of the panel.

The default piColumnSpan is 1, which means that each control spans one column. A setting of 0 causes the control to span from the current position to last column.

Controls cannot be positioned (or span) to a column that exceeds the container's column count. If indexes and spans are out of range, the framework will adjust the best it can by trying to fit within the container.

For more information see Positioning and Layout of Controls.

About Web Properties
Each web property maintains two values: The regular property value is set during object creation and should not be changed during the lifetime of that object. To access that value, use the standard property Get and Set syntax.
The web property value is the local value stored at each client. This is synchronized to the client's local value whenever a server call is being processed. To access the web property value, use the WebGet and WebSet syntax above instead of the standard Get and Set syntax.
See Also

piHeight | pbFillHeight