Use the following properties to define initial characteristics
of an IVBContainerControl* part.
- Part properties are displayed in the part property sheet.
- Attribute properties are displayed in the Part attribute
property sheet. Container attributes are similar to
styles.
- Style properties are displayed in the Part style
property sheet.
IVBContainerControl properties
-
- activeColor
- The active color of the container. This is defined as a
color property.
- attribute
- Container attribute settings. This is defined as an
attribute property. The individual attributes are
described as IVBContainerControl attribute properties.
Container attributes are similar to styles.
- Attribute for icon
- The attribute from the item type class to use as the
object icon.
- Attribute for icon text
- The attribute from the item type class to use as the
object icon text.
- 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 container. This is defined as
a color property.
- borderColor
- The border color of the container. This is defined as a
color property.
- cachingEnabled
- Specifies whether record caching is used for a subset of
all container objects. This enhances performance for
opening a container with a large number of objects. To
load records for additional objects when the user scrolls
outside the bounds of loaded records, a handler derived
from ICnrHandler must be added to the container handlers
list. Record caching is not supported for objects in
native Windows containers.
- detailsViewSplit
- Specifies the split bar position for the details view.
This is defined as a code property. Enter a pointer to
the IContainerColumn object that is to precede the split
bar, or code that produces this pointer. If no value is
specified, the details view has no split bar. A
connection can be used instead of setting the code
property.
- disabledBackgroundColor
- The background color of the container when it is
disabled. This is defined as a color property.
- disabledForegroundColor
- The foreground color of the container when it is
disabled. This is defined as a color property.
- drawBackgroundEnabled
- Specifies whether custom drawing is performed for the
container. To process custom drawing requests, a handler
derived from ICnrDrawHandler must be added to the
container handlers list. Custom background drawing
is not supported for native Windows containers.
- drawItemEnabled
- Specifies whether custom drawing is performed for
container objects. To process custom drawing requests, a
handler derived from ICnrDrawHandler must be added to the
container handlers list. Custom background drawing
is not supported for objects in native Windows
containers.
- enabled
- Specifies whether the container is enabled for selection.
- enabledForNotification
- Specifies whether the container 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 container. 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 container. To display the
fly-over text, you must add an IVBFlyText* part to the
composite part for the window.
- font
- Specifies the text font for the container. This is
defined as a font property.
- foregroundColor
- The foreground color of the container. This is defined as
a color property.
- handlers
- The list of attached handlers for the container. This is
defined as a handlers property.
- helpId
- The ID of the help panel for the container. 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 container when it is
highlighted. This is defined as a color property.
- hiliteForegroundColor
- The foreground color of the container when it is
highlighted. This is defined as a color property.
- iconSize
- The size of icons for container objects. This is defined
as an ISize property.
- id
- The window ID of the container.
- inactiveColor
- The inactive color of the container. 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.
- items
- Specifies a collection that provides objects for the
container. This is defined as a code property. Enter a
pointer to a collection object, or code that produces
this pointer. A connection can be used instead of setting
the code property.
- lineSpacing
- The vertical distance between objects in the container.
- minimumSize
- Specifies the minimum size of the container. Multicell
canvases and set canvases use the minimum size to lay out
controls. This is defined as an IVBMinSize property.
- partName
- The composition name of the part. This name is used for
the class instance in generated code.
- refreshOn
- Specifies whether the container can be refreshed after
changes. If this property is true, the refresh
action can refresh the container.
- selectedCollectionPosition
- The collection index of the object selected in the
container.
- shadowColor
- The shadow color of the container. This is defined as a
color property.
- Size and position
- The size and position of the container. This is defined
as a framing property.
- style
- The style settings for the container. This is defined as
a style property. The individual styles are described as
IVBContainerControl style properties.
- title
- Text for the container title.
- titleAlignment
- Specifies the alignment of title text. Alignment is
indicated by the location of titleAlignment
choices within the following table:
- titleWriteable
- Specifies whether the the user can edit the container
title. Title editing is not supported for native Windows
containers.
- viewType
- The container object view. View choices are based on the
following attributes:
| Primary
view attribute |
Secondary
view attribute |
|
Flowed |
Tree |
| Details |
showDetailsView
|
|
|
| Icon |
showIconView
|
|
showTreeIconView
|
| Name |
showNameView
|
showFlowedNameView
|
showTreeNameView
|
| Text |
showTextView
|
showFlowedTextView
|
showTreeTextView
|
IVBContainerControl attribute properties
-
- add default bits
- Specifies whether the default attribute settings are used
as a base for part attributes. The initial value is true.
The default attribute is shipped with the following
attributes on:
- detailsViewTitles
- Specifies whether container column titles are visible in
the details view.
- titleSeparator
- Specifies whether a horizontal separator is drawn beneath
the container title.
- visibleTitle
- Specifies whether the container title is visible.
IVBContainerControl 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:
- autoPosition
- Specifies whether objects are automatically positioned
when added in the icon view.
- 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.
- extendedSelection
- Specifies whether the user can select multiple objects by
dragging the mouse over them or by pressing either the
Shift key or the Ctrl key during selection. This style is
mutually exclusive with the multipleSelection and singleSelection
styles. Ensure that only one of these styles is on,
either explicitly or by default.
- group
- Specifies whether the container is the first control in a
control group.
- multipleSelection
- Specifies whether the user can individually select
multiple objects. This style is mutually exclusive with
the extendedSelection and singleSelection
styles. Ensure that only one of these styles is on,
either explicitly or by default.
- noSharedObjects
- Specifies whether the container can be optimized based on
the assumption that an object cannot be added to more
than one container.
- pmCompatible
- Specifies whether the container is compatible with the
Presentation Manager (PM) container.
- on--the container is PM-compatible.
- off--the native system container is used.
- readOnly
- Specifies whether the user can edit text for container
objects and columns. If this style is on, the user
cannot modify text.
- saveBits
- Specifies whether the area under the window object is
saved as a bitmap to enable faster repainting.
- singleSelection
- Specifies whether the user can select only one object at
a time. This style is mutually exclusive with the extendedSelection
and multipleSelection styles. Ensure that only one
of these styles is on, either explicitly or by
default.
- synchPaint
- Specifies whether the window object is painted
synchronously rather than waiting for other system events
to processed.
- tabStop
- Specifies whether the container is a tab stop.
- verifyPointers
- Specifies whether the the presentation verifies that an
object exists before attempting to use it.
- visible
- Specifies whether the container is visible.
Working with
IVBContainerControl Parts
Editing Part Properties
Property Settings -- IVBMinSize
Property Settings -- ISize
Style Properties
Color Properties
Font Properties
Handler Properties
Size and Position Properties
Code Properties
IVBContainerControl
Portability --
IVBContainerControl
VisualAge User Interface Part
Properties