Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxBarItem.PaintStyle Property

Specifies the look of linked item controls on screen.

#Declaration

Delphi
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