Specifies the arrangement of bitmap and text, on a pushButton, when both exists.

Property of

PushButton

Description

Supported options include:

0

Default.

1

Left

2

Top

3

Right

4

Bottom

When the bitmapAlignment property is set to 0, Default, the bitmap is positioned as follows:

If the pushButton does not contain text, the bitmap is centered.

If the pushButton contains both text and a bitmap, the text is positioned according to the setting of the textLeft property.

If the textLeft property is set to false, the text is positioned to the right, and the bitmap to the left.

If the textLeft property is set to true, the text is positioned to the left, and the bitmap to the right.

When the bitmapAlignment property is set to 1, 2, 3, or 4,  it overrides the textLeft property's setting as follows:

1

Left

Positions the bitmap to the left, and any text to the right.

2

Top

Positions the bitmap at the top, and any text at the bottom.

3

Right

Positions the bitmap to the right, and any text to the left.

4

Bottom

Positions the bitmap at the bottom, and any text at the top.

Additional considerations:

When the textLeft property is overridden, by setting the bitmapAlignment property to 1, 2, 3, or 4, it will still affect the alignment when the text occupies more than one line, as follows:

When the textLeft property is set to true, the text lines are left aligned

When the textLeft property is set to false, the text lines are centered.

The text and bitmap may overlap when using a setting other than 0 – Default.