Property Settings -- IProgressIndicator

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

IProgressIndicator properties

activeColor
The active color of the progress indicator. This is defined as a color property.

armPixelOffset
The initial offset of the progress indicator arm from the home position, in pixels.

armTickOffset
The initial offset of the progress indicator arm from the home position, in tick marks.

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 progress indicator. This is defined as a color property.

borderColor
The border color of the progress indicator. This is defined as a color property.

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

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

drawItemEnabled
Sets the handleDrawItem style. If this property is true, the style is set to on.

enabled
Specifies whether the progress indicator is enabled for selection.

enabledForNotification
Specifies whether the progress indicator 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 progress indicator. 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 progress indicator. 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 progress indicator. This is defined as a font property.

foregroundColor
The foreground color of the progress indicator. This is defined as a color property.

handlers
The list of attached handlers for the progress indicator. This is defined as a handlers property.

helpId
The ID of the help panel for the progress indicator. 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 progress indicator when it is highlighted. This is defined as a color property.

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

homePosition
The end of the progress indicator that represents the beginning of a task. If nothing is specified, homeBottomLeft is assumed.

id
The window ID of the progress indicator.

inactiveColor
The inactive color of the progress indicator. 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.

minimumSize
Specifies the minimum size of the progress indicator. 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.

primaryNumberOfTicks
The number of tick increments for the progress indicator scale.

primaryScale
The end of the progress indicator that represents the beginning of a task. If nothing is specified, homeBottomLeft is assumed.

primaryTickSpacing
The number of pixels between ticks for the progress indicator scale.

ribbonStripEnabled
Sets the ribbonStrip style. If this property is true, the style is set to on.

shadowColor
The shadow color of the progress indicator. This is defined as a color property.

shaftPosition
The origin point of the shaft relative to the origin corner of the progress indicator window. This is defined as an IPoint property.

Size and position
The size and position of the progress indicator. This is defined as a framing property.

snapToTickEnabled
Sets the snapToTickMark style. If this property is true, the style is set to on.

style
The style settings for the progress indicator. This is defined as a style property. The individual styles are described as IProgressIndicator style properties.

IProgressIndicator 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.

group
Specifies whether the progress indicator is the first control in a control group.

handleDrawItem
Specifies whether custom drawing is performed for the progress indicator. To process custom drawing requests, a handler derived from ISliderDrawHandler must be added to the container handlers list. Custom background drawing is not supported for native Windows progress indicators.

horizontal
Specifies whether the progress indicator is horizontal. This style is mutually exclusive with the vertical style. Ensure that only one of these styles is on, either explicitly or by default.

pmCompatible
Specifies whether the progress indicator has the look and feel of the OS/2 Presentation Manager (PM) progress indicator.

ribbonStrip
Specifies whether the progress indicator shaft is colored between the home position and the arm.

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

snapToTickMark
Specifies whether the progress indicator is positioned to the nearest tick mark when it is moved between ticks.

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

tabStop
Specifies whether the progress indicator is a tab stop.

vertical
Specifies whether the progress indicator is vertical. This style is mutually exclusive with the horizontal style. Ensure that only one of these styles is on, either explicitly or by default.

visible
Specifies whether the progress indicator is visible.


Related procedures
Working with IProgressIndicator Parts
Editing Part Properties

Related references
Property Settings -- IVBMinSize
Property Settings -- IPoint
Style Properties
Color Properties
Font Properties
Handler Properties
Size and Position Properties
Code Properties
IProgressIndicator
Portability -- IProgressIndicator
VisualAge User Interface Part Properties