Skip to main content

TdxBarItem.PaintStyle Property

Specifies the look of linked item controls on screen.

Declaration

property PaintStyle: TdxBarPaintStyle read; write; default psStandard;

Property Value

Type Default
TdxBarPaintStyle psStandard

Remarks

This property specifies the button paint style. It works with the non-dropdown buttons only (ButtonStyle is not equal to bsDropDown and bsCheckedDropDown). Paint style can be one of the following:

Value

Description

psStandard

A button contains a text caption or a picture. What is exactly painted on a button depends on the button’s location. If a button is placed on a toolbar, the bar manager paints only the button’s picture, without the caption. If a button is placed on a sub item, the component paints both the button’s picture and caption. The component uses the following order to paint pictures:

  • the glyph, if defined;

  • the picture, specified by the ImageIndex property.

Note

if a button is located on a toolbar and no images are specified, then this button appears as an empty rectangle. In other words, when PaintStyle is psStandard, the caption is not drawn for buttons on toolbars, even if the caption was specified.

psCaption

A button’s caption is used to identify the button to a user.

psCaptionGlyph

A button’s caption and picture are used, the caption appears next to the glyph on the button.

psCaptionInMenu

In submenus, the caption is drawn on a button’s surface. If the button is placed on a toolbar, then the picture is drawn on it.

This property affects all corresponding item controls. To change the paint style of a particular item control, use the UserPaintStyle property of its item link.

See Also