VerticalAlignment (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Horizontal alignment
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

VerticalAlignment (Property)

In french: CadrageVertical

Vertical alignment determines how the text is positioned relative to the borders of the control. This allows you to center the content of an Edit control in relation to the borders of the input area.

Three types of alignment are available:

Alignment at top
Alignment in the middle
Alignment at bottom

The VerticalAlignment property gets and changes the vertical alignment of a control.

The initial alignment is defined in the control description.

Example

// If the control is aligned to top, align it at bottom
IF STC_Static.VerticalAlignment = vaTop THEN
STC_Static.VerticalAlignment = vaBottom
END

Syntax

Getting the vertical alignment of a control Hide the details

<Current alignment> = <Control used>.VerticalAlignment

<Current alignment>: Integer constant

Current vertical alignment of the control. The possible values are as follows:
vaBottom the text is located at the bottom of the control
vaMiddle the text is located in the middle of the control
vaTop the text is located at the top of the control

Additional alignment options are available:
vaAbove Vertical alignment above the baseline, as superscript (corresponds to the CSS "super" value)
vaAuto Automatic vertical alignment (corresponds to the CSS "auto" value)
vaBaseline Vertical alignment according to the baseline (corresponds to the CSS "baseline" value)
vaBelow Vertical alignment below the baseline, as subscript (corresponds to the CSS "sub" value)
vaNotDefined Vertical alignment inherited from the parent
vaTextBottom Vertical alignment with the bottom of the parent's font (corresponds to the CSS "text-bottom" value)
vaTextTop Vertical alignment with the top of the parent's font (corresponds to the CSS "text-top" value)

<Control used>: Control name

Name of the control to be used.

Changing the vertical alignment of a control Hide the details

<Control used>.VerticalAlignment = <New alignment>

<Control used>: Control name

Name of the control to be used.

<New alignment>: Integer constant

New alignment of the control. The possible values are as follows:
vaBottom the text is located at the bottom of the control
vaMiddle the text is located in the middle of the control
vaTop the text is located at the top of the control

Additional options for the vertical alignment can be specified via the following constants:
vaAbove Vertical alignment above the baseline, as superscript (corresponds to the CSS "super" value)
vaAuto Automatic vertical alignment (corresponds to the CSS "auto" value)
vaBaseline Vertical alignment according to the baseline (corresponds to the CSS "baseline" value)
vaBelow Vertical alignment below the baseline, as subscript (corresponds to the CSS "sub" value)
vaNotDefined Vertical alignment inherited from the parent
vaTextBottom Vertical alignment with the bottom of the parent's font (corresponds to the CSS "text-bottom" value)
vaTextTop Vertical alignment with the top of the parent's font (corresponds to the CSS "text-top" value)

Remarks

Horizontal alignment

To define the horizontal alignment of the control, use the HorizontalAlignment property.

Limitations

In a window, the VerticalAlignment property gets and changes the vertical alignment for the following types of controls:

Static Text control
Check Box or Radio Button control
Image control
Columns of a Table or TreeView Table control
List Box control
Combo Box control
Bar Code control
Chart control
Rating control
Organization Chart control

In a page, the VerticalAlignment property gets and changes the vertical alignment for the following types of controls:

Edit control
Static Text control
Button control
Check Box and Radio Button controls
List Box and Combo Box controls
Table control
Table control cells (read-only)
TreeView Table control and its cells (read-only)
Formatted display control
HTML control
Link control
HTML Static control
Pager control
Breadcrumb control
TreeView control
Progress Bar control
Scheduler control
Rating control

In a page, the VerticalAlignment property gets and changes the vertical alignment for the following types of controls:

Edit control
Static Text control
Button control
Check Box and Radio Button controls
List Box or Combo Box control
Table control
TreeView Table control and its cells
Formatted display control
HTML control
Link control
HTML Static control
Pager control
TreeView control

In a report, the VerticalAlignment property gets and changes the vertical alignment for the following types of controls:

Static Text control.
Calculated control.
Preset control.
Chart control.
Group of controls: This property will only apply to controls that support vertical alignment.

The VerticalAlignment property can only be used in the following controls:

Static Text control.
Image control.
Check Box control.
Radio Button control.
Combo Box control.

The VerticalAlignment property can be used on table columns.

The VerticalAlignment property applies to all types of controls (table columns, static text, etc.).

The VerticalAlignment property can be used on Static Text controls.