Use the following properties to define initial characteristics
of an ICollectionViewComboBox* part.
- Part properties are displayed in the part property sheet.
- Style properties are displayed in the Part style
property sheet.
ICollectionViewComboBox properties
-
- activeColor
- The active color of the combination box. This is defined
as a color property.
- 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 combination box. This is
defined as a color property.
- borderColor
- The border color of the combination box. This is defined
as a color property.
- charType
- The type of characters accepted by the entry field. This
pertains to the character set types that can define the
characters.
- Double-byte character sets (DBCS)
- Single-byte character sets (SBCS)
If a type is not specified, any is assumed. The
following types are available:
- any--SBCS characters, DBCS characters, or
a mixture. No text limit allowance is made for
potential conversion from ASCII to EBCDIC code
pages.
- dbcs--only DBCS characters.
- mixed--SBCS characters, DBCS characters,
or a mixture. In testing text length against the
limit, allowance is made for potential conversion
from ASCII to EBCDIC code pages. Shift-in and
shift-out characters that would be inserted by
conversion to EBCDIC are added to the text length
in testing the limit.
- sbcs--only SBCS characters.
- cursorPosition
- The offset of the text cursor from the beginning of the
text.
- disabledBackgroundColor
- The background color of the combination box when it is
disabled. This is defined as a color property.
- disabledForegroundColor
- The foreground color of the combination box when it is
disabled. This is defined as a color property.
- enabled
- Specifies whether the combination box is enabled for
selection.
- enabledForNotification
- Specifies whether the combination box 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 combination box. 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 combination box. 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 combination box. This is
defined as a font property.
- foregroundColor
- The foreground color of the combination box. This is
defined as a color property.
- handlers
- The list of attached handlers for the combination box.
This is defined as a handlers property.
- helpId
- The ID of the help panel for the combination box. 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 combination box when it is
highlighted. This is defined as a color property.
- hiliteForegroundColor
- The foreground color of the combination box when it is
highlighted. This is defined as a color property.
- id
- The window ID of the combination box.
- inactiveColor
- The inactive color of the combination box. This is
defined as a color property.
- insertMode
- Specifies the keyboard input mode of the entry field.
- false--overtype mode.
- true--insert mode.
By default, true is assumed.
- 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
combination box. 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.
- leftIndex
- The offset of the first character displayed at the left
of the entry field. If nothing is specified, 0 is
assumed.
- limit
- The maximum number of bytes allowed in the entry field.
The default value is determined by the system.
- minimumRows
- The minimum number of rows displayed in the list box. If
nothing is specified, 4 is assumed. This is used
in the determining the minimum size of the combination
box.
- minimumSize
- Specifies the minimum size of the combination box.
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.
- selectedCollectionPosition
- The collection index of the object selected in the list
box.
- shadowColor
- The shadow color of the combination box. This is defined
as a color property.
- Size and position
- The size and position of the combination box. This is
defined as a framing property.
- stringGenerator
- A string generator class that produces text to represent
objects in the collection. If you implement an asString
function, specify it as follows: IStringGenerator
<itemType> (new IStringGeneratorasString
<itemType>)
- style
- The style settings for the combination box. This is
defined as a style property. The individual styles are
described as ICollectionViewComboBox style properties.
- text
- Text for the entry field. Generally, text should be
provided by the selected object.
- top
- The index of the object displayed at the top of the list
box.
- writeable
- Specifies whether the user can edit the contents of the
entry field. For a read-only drop-down combination box,
the default is false. For other combination box
types, the default is true.
ICollectionViewComboBox 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:
- 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.
- dropDownType
- Specifies whether the list box is hidden until the user
selects the drop-down button. This style is mutually
exclusive with the readOnlyDropDownType and simpleType
styles. Ensure that only one of these styles is on,
either explicitly or by default.
- group
- Specifies whether the combination box is the first
control in a control group.
- horizontalScroll
- Specifies whether the list box can be scrolled
horizontally.
- readOnlyDropDownType
- Specifies whether the list box is hidden until the user
selects the drop-down button and the user cannot enter
information into the entry field. This style is mutually
exclusive with the dropDownType and simpleType
styles. Ensure that only one of these styles is on,
either explicitly or by default.
- saveBits
- Specifies whether the area under the window object is
saved as a bitmap to enable faster repainting.
- simpleType
- Specifies whether the list box is always visible. This
style is mutually exclusive with the dropDownType
and readOnlyDropDownType 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 combination box is a tab stop.
- visible
- Specifies whether the combination box is visible.
Working with
ICollectionViewComboBox Parts
Editing Part Properties
Property Settings -- IVBMinSize
Style Properties
Color Properties
Font Properties
Handler Properties
Size and Position Properties
Code Properties
ICollectionViewComboBox
Portability --
ICollectionViewComboBox
VisualAge User Interface Part
Properties