piColumnIndex - cWebBaseControl

Determines the control's X-coordinate placement in the containing object's column layout

Type: Property (Web Property)

Access: Read/Write

Data Type: Integer

Parameters: None

 { WebProperty=Client }
 Property Integer piColumnIndex

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

Read Access: Get piColumnIndex to IntegerVariable
Write Access: Set piColumnIndex 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 piColumnIndex is 0, which means that each control is located in the first column in the current panel.

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.

Grid Layout

Grid Layout applies if peLayoutType = ltGrid.

Positions the control at the set column index on the grid. If not specifically set, CSS grid will attempt to fill any "gaps" in your grid. How this is done exactly also depends on whether piRowIndex is explicitly set or not.

Note that CSS Grid is 1-based, but the DataFlex Grid Layout implementation is 0-based.

Default in grid layout is -1.

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.