peLabelPosition - cWebBaseControl

Determines whether the label will be positioned to the left, right or above the control

Type: Property (Web Property)

Access: Read/Write

Data Type: Integer

Parameters: None

 { WebProperty=Client }
 Property Integer peLabelPosition

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

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


Normally, the width of each control includes a special area reserved for its label (psLabel). Set peLabelPosition to determine whether the label area is positioned to the left, right or above the control.

Valid values are:

lpFloatLabel positioned inside control if blank, then floats to a position above the control as soon as the user navigates inside the control
lpLeftLabel positioned to left of control
lpRightLabel positioned to right of control
lpTopLabel positioned on top of control

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

If you want to override the theme's label position for a control, then you should set this property.

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

piLabelOffset | peLabelAlign