Use the following properties to define initial characteristics
of an IToolBar* part.
- Part properties are displayed in the part property sheet.
- Style properties are displayed in the Part style
property sheet.
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.
- bitmapAndTextView--sets the buttonBitmapAndTextVisible
style on and the buttonBitmapVisible
and buttonTextVisible styles off.
- bitmapView--sets the buttonBitmapVisible
style on and the buttonBitmapAndTextVisible
and buttonTextVisible styles off.
- textView--sets the buttonTextVisible
style on and the buttonBitmapAndTextVisible
and buttonBitmapVisible styles off.
- 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.
- horizontal--sets the horizontalDecks
style on and the verticalDecks
style off.
- vertical--sets the verticalDecks
style on and the horizontalDecks
style off.
- 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.
- aboveClient--above the client area
- belowClient--below the client area
- floating--in the client area of a floating
tool bar frame window
- hidden--no visible location
- leftOfClient--left of the client area
- rightOfClient--right of the client area
- 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.
- even--controls are evenly distributed,
with varying space between them if their sizes
vary
- expanded--controls are resized to a
uniform size, with minimum space between controls
in a group
- tight--controls are packed tightly, with
minimum space between controls in a group
- 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:
- buttonBitmapVisible
- filterMisfits
- visible
- 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.
Working with IToolBar
Parts
Editing Part Properties
Property Settings -- IVBMinSize
Property Settings -- ISize
Style Properties
Color Properties
Font Properties
Handler Properties
Code Properties
IToolBar
Portability -- IToolBar
VisualAge User Interface Part
Properties