piLabelOffset - cWebBaseControl

Determines the width of the area occupied by the control's label

Type: Property (Web Property)

Access: Read/Write

Data Type: Integer

Parameters: None

 { WebProperty=Client }
 Property Integer piLabelOffset

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

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


Normally, the width of each control includes a special area reserved for its label (psLabel). Set piLabelOffset to change the amount of space (in pixels) that is consumed by the control's label.

The default value of this property is C_WebDefault. When piLabelOffset is set to this value, it means that the width of the label area is not pre-determined. Instead it is the selected theme (psTheme) that will decide the label width, i.e. the theme's default label width will be applied. Usually, the theme's label width is 120px but, depending on the theme, can be any valid value.

When you reduce the value of piLabelOffset, then the space released by the label area will be consumed by the control, i.e. the control width grows as the label width decreases.

If the label area is too narrow to accommodate the label text, then the label text will wrap. This may cause the overall height of the control to increase.
Make sure pbShowLabel is set to True for this property to take effect.

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

peLabelPosition | peLabelAlign