Property Settings -- IToolBar

Use the following properties to define initial characteristics of an IToolBar* part.

IToolBar properties

activeColor
The active color of the tool bar. This is defined as a color property.

alignment
Specifies the alignment of controls within decks (rows or columns) of the tool bar. If nothing is specified, topLeft is assumed. Control alignment is indicated by the location of alignment choices within the following table:
topLeft topCenter topRight
centerLeft centerCenter centerRight
bottomLeft bottomCenter bottomRight

allowsDragDrop
Sets the noDragDrop style. If this property is true, the style is set off.

autoDeleteObject
Specifies whether the C++ object is deleted when the user closes the window. The default is false. This property should be true only for objects that are created dynamically using a Factory.

autoDestroyWindow
Specifies whether the system destroys the presentation object when the C++ object is deleted. The default is false. This inherited property is not appropriate for objects created from VisualAge user interface parts. It is applicable when a C++ class is a wrapper for a presentation object that it did not create.

backgroundColor
The background color of the tool bar. This is defined as a color property.

borderColor
The border color of the tool bar. This is defined as a color property.

buttonView
Sets styles for tool bar button bitmaps and text.

deckCount
The number of decks (rows or columns) in the tool bar. If nothing is specified, 1 is assumed.

deckOrientation
Sets styles for the orientation of decks within the tool bar.

defaultGroupPad
The default groupPad value, in pixels, for this and subsequently created tool bars. The shipped defaultGroupPad value is 8.

defaultMargin
Default margin values for decks in this and subsequently created tool bars. This is defined as an ISize property.

defaultMisfitWidth
Default maximum width, in pixels, for displaying controls in vertical tool bars. This value is used to filter wide controls from tool bars when the filterMisfits style is on. The shipped defaultMisfitWidth value is 100.

defaultPad
The default pad value, in pixels, for this and subsequently created tool bars. The shipped defaultPad value is -1.

disabledBackgroundColor
The background color of the tool bar when it is disabled. This is defined as a color property.

disabledForegroundColor
The foreground color of the tool bar when it is disabled. This is defined as a color property.

enabled
Specifies whether the tool bar is enabled for selection.

enabledForNotification
Specifies whether the tool bar is enabled for event notification. The default is true. Visual composition connections depend on event notification.

Fly-over long text
Text that is displayed in a text control when the mouse pointer hovers over the tool bar. To display the fly-over text, you must add an IVBFlyText* part to the composite part for the window and specify a text control for the IVBFlyText* part.

Fly-over short text
Text that is displayed in a pop-up caption box when the mouse pointer hovers over the tool bar. To display the fly-over text, you must add an IVBFlyText* part to the composite part for the window.

floatingTitle
Text for the title of the floating tool bar frame window.

font
Specifies the text font for the tool bar. This is defined as a font property.

foregroundColor
The foreground color of the tool bar. This is defined as a color property.

groupPad
The pad space between control groups. If nothing is specified, the defaultGroupPad value is used.

groupWithPreceding
Specifies whether the tool bar is in the same deck (row or column) as the preceding tool bar. If nothing is specified, false is assumed.

handlers
The list of attached handlers for the tool bar. This is defined as a handlers property.

helpId
The ID of the help panel for the tool bar. To display the help, you must add an IHelpWindow* part to the composite part for the primary application window.

hiliteBackgroundColor
The background color of the tool bar when it is highlighted. This is defined as a color property.

hiliteForegroundColor
The foreground color of the tool bar when it is highlighted. This is defined as a color property.

id
The window ID of the tool bar.

inactiveColor
The inactive color of the tool bar. This is defined as a color property.

itemProvider
Specifies a direct manipulation item provider for drag-drop operations. This is defined as a code property. Enter a pointer to an IDMItemProvider object, or code that produces this pointer. A connection can be used instead of setting the code property.

location
Sets styles for the location of the tool bar relative to the client area of a frame window. If nothing is specified, aboveClient is assumed.

margin
Specifies the height of the top and bottom margins and the width of the left and right margins around the decks in the tool bar. If nothing is specified, the defaultMargin value is used. This is defined as an ISize property.

minimumSize
Specifies the minimum size of the tool bar. Multicell canvases and set canvases use the minimum size to lay out controls. This is defined as an IVBMinSize property.

misfitFilteringEnabled
Sets the filterMisfits style. If this property is true, the style is set to on.

owner
The frame window that owns the tool bar. This is defined as a code property. Enter i, followed by the frame window partName value, followed by (). For example, if you want a frame window named FrameWindow1 to own the tool bar, enter iFrameWindow1(). If no owner is specified, the primary frame window of the composite part is assumed.

packType
The arrangement of controls within a deck. If nothing is specified, horizontal is assumed.

pad
The minimum space between controls in a group.

partName
The composition name of the part. This name is used for the class instance in generated code.

shadowColor
The shadow color of the tool bar. This is defined as a color property.

style
The style settings for the tool bar. This is defined as a style property. The individual styles are described as IToolBar style properties.

text
Text for a group box label. If text is specified, a group box is drawn around the tool bar.

IToolBar style properties

add default bits
Specifies whether the default style settings are used as a base for part styles. The initial value is true. The default style is shipped with the following styles on:

buttonBitmapAndTextVisible
Specifies whether both bitmaps and text are displayed for all tool bar buttons in the tool bar. This style is mutually exclusive with the buttonBitmapVisible and buttonTextVisible styles. Ensure that only one of these styles is on, either explicitly or by default.

buttonBitmapVisible
Specifies whether only bitmaps are displayed for all tool bar buttons in the tool bar. This style is mutually exclusive with the buttonBitmapAndTextVisible and buttonTextVisible styles. Ensure that only one of these styles is on, either explicitly or by default.

buttonTextVisible
Specifies whether only text is displayed for all tool bar buttons in the tool bar. This style is mutually exclusive with the buttonBitmapAndTextVisible and buttonBitmapVisible styles. Ensure that only one of these styles is on, either explicitly or by default.

clipChildren
Specifies whether areas occupied by child windows are painted by this window object. If this style is on, child areas are not painted by this window object. This inherited window style is most useful for frame windows and composer parts.

clipSiblings
Specifies whether areas occupied by sibling windows are painted by this window object. If this style is on, sibling areas are not painted by this window object. This inherited window style is most useful for frame windows.

clipToParent
Specifies whether a window object paints only within the bounds of its parent window. If this style is on, painting is restricted to the bounds of the parent.

filterMisfits
Specifies whether wide controls, exceeding the defaultMisfitWidth value, are filtered from the tool bar when it is oriented vertically on the left or right side of the client area.

group
Specifies whether the tool bar is the first control in a control group.

noDragDrop
Specifies whether the tool bar and tool bar buttons can be moved by dragging and dropping them. If this style is on, drag-drop operations are disabled.

saveBits
Specifies whether the area under the window object is saved as a bitmap to enable faster repainting.

synchPaint
Specifies whether the window object is painted synchronously rather than waiting for other system events to processed.

tabStop
Specifies whether the tool bar is a tab stop.

visible
Specifies whether the tool bar is visible.


Related procedures
Working with IToolBar Parts
Editing Part Properties

Related references
Property Settings -- IVBMinSize
Property Settings -- ISize
Style Properties
Color Properties
Font Properties
Handler Properties
Code Properties
IToolBar
Portability -- IToolBar
VisualAge User Interface Part Properties