Property Settings -- IVBContainerControl

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

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:
left centered right

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.

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.


Related procedures
Working with IVBContainerControl Parts
Editing Part Properties

Related references
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