Navigation:  Reference > Form Objects >

TToolBar

Print this Topic Previous pageReturn to chapter overviewNext page

 

This object creates a tool button bar that appears at the top of the form.  The items that make up the bar are actually TToolButton objects.  The icon for this object is on the Additional page.

 

PALETTE ICON & EXAMPLE

 

 

PROPERTIES

The following are the properties that apply to this object.  Some are defined in Common Properties and are linked to their appropriate page.

 

Appearance

 

CaptionEven though this property is available it doesn't show up anywhere on the bar.  You can ignore it.

Color

Ctl3D

Cursor

FlatIf this is checked (set to .True.) the buttons will disappear into the bar and will look like a button when the user passes their mouse over it.  The default value is .False.

ParentColor

TransparentIf this is checked (set to .True.) then anything behind the tool bar itself will be visible.  This only effects the actual tool bar and not the buttons.  The default value is .False.

 

Behavior

 

Enabled

TabOrder

TabStop

Visible

 

Font

 

Font

ParentFont

 

Hint

 

Hint

ParentShowHint

ShowHint

 

Misc

 

HelpContext

Name

PopupMenu

Tag

 

Other

 

Anchors

BorderWidth  

ButtonHeightThe height of each button on the tool bar.

 

ButtonWidthThe default width of each button on the tool bar.

Constraints

DisabledImagesNormally, if you disable a button on a tool bar (set Enabled for that button to .False.) the button image will be 'grayed out.'  If you want a different image to be displayed then place the name of the TImageList object here that contains that image.

 

       NOTE:  This must be different than the TImageList object used in the Images property since the ImageIndex property in the TToolButton is the controlling value here also.

 

EdgeBordersThis option determines which borders of the tool bar will have a distinct edge.  You have the ability to choose any or all of the four bar edges.  The default value is top only.

 

EdgeInnerThis property, along with EdgeOuter below control what the edge of the tool bar will look like.  The options are: Lowered, None and Raised (the default value).

 

EdgeOuterThis property, along with EdgeInner above control what the edge of the tool bar will look like.  The options are: Lowered (the default value), None and Raised.

 

HotImagesNormally, when the mouse passes over the button, the image displayed stays the same.  If you want a different image to be displayed then place the name of the TImageList object here that contains that image.

 

       NOTE:  This must be different than the TImageList object used in the Images property since the ImageIndex property in the TToolButton is the controlling value here also.

 

ImagesThis is the TImageList object that contains the images that will appear on the face of the buttons in normal use.  The particular image used is controlled by the ImageIndex property in the TToolButton.

 

IndentThis will create a margin on the left side of the tool bar before the first tool button is displayed.  The default value is 0.

 

ListNormally, if captions are displayed on the buttons (see ShowCaptions below) they appear under the images centered on the button face.  If you check this option (set to .True.) the captions (if displayed) will show up to the right of the images instead of underneath.

 

ShowCaptionsIf you check this option (set to .True.) the caption for each TToolButton will be displayed on the button face along with (or instead of) the image.  The position of the caption is normally under the image.  However, if you have checked the List property above the caption will appear to the right of the image.

 

WrapableIf this option is checked (set to .True.) the tool bar will automatically wrap to the next line if the buttons don't fit in the space allowed.  This would occur if the user changed the size of the form during runtime, for example.

 

Position

 

Align

AutoSize

Height

Left

Top

Width

 

COMMENTS

This object would only be used during design.  The actual working part of the TToolBar are the TToolButtons.  To add buttons to the bar you would right click on the object and choose either NewButton or NewSeparator.  Either option will put a TToolButton object on the bar that you can modify using the object inspector.  There are no special editors for this type of object.

 

NOTE:  You can have multiple rows of TToolBars on a form.

 

EVENTS

There are no events for this object.

 

 


Page url: http://www.cassoftware.com/tas/manual/ttoolbar.htm