Use the following properties to define initial characteristics
of an IAnimatedButton* part.
- Part properties are displayed in the part property sheet.
- Style properties are displayed in the Part style
property sheet.
IAnimatedButton properties
-
- activeColor
- The active color of the button. This is defined as a
color property.
- allowsMouseClickFocus
- Sets the noPointerFocus style. If this property is
true, the style is set to off.
- animatedWhenLatched
- Sets the animateWhenLatched style. If this
property is true, the style is set to on.
- animationRate
- The frequency with which animation bitmaps are displayed
for the button. The default is one per second.
- 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.
- autoLatchEnabled
- Sets the autoLatch style. If this property is true,
the style is set to on.
- backgroundColor
- The background color of the button. This is defined as a
color property.
- borderColor
- The border color of the button. This is defined as a
color property.
- currentBitmapIndex
- The index in the sequence of bitmaps of the currently
displayed bitmap.
- disabledBackgroundColor
- The background color of the button when it is disabled.
This is defined as a color property.
- disabledForegroundColor
- The foreground color of the button when it is disabled.
This is defined as a color property.
- enabled
- Specifies whether the button is enabled for selection.
- enabledForNotification
- Specifies whether the button 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 button. 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 button. 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 button. This is defined
as a font property.
- foregroundColor
- The foreground color of the button. This is defined as a
color property.
- handlers
- The list of attached handlers for the button. This is
defined as a handlers property.
- helpId
- The ID of the help panel for the button. 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 button when it is
highlighted. This is defined as a color property.
- hiliteForegroundColor
- The foreground color of the button when it is
highlighted. This is defined as a color property.
- id
- The window ID of the button.
- inactiveColor
- The inactive color of the button. 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.
- latched
- Specifies whether the button is latched down. If this is true,
the button appears to be locked in a pushed state.
- latchedBackgroundColor
- The background color of the button when it is latched.
This is defined as a color property.
- latchedForegroundColor
- The foreground color of the button when it is latched.
This is defined as a color property.
- latchingEnabled
- Sets the latchable style. If this property is true,
the style is set to on.
- minimumSize
- Specifies the minimum size of the button. 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.
- resourceIds
- Specifies animation bitmaps for the button. This is
defined as a resource property.
- shadowColor
- The shadow color of the button. This is defined as a
color property.
- Size and position
- The size and position of the button. This is defined as a
framing property.
- style
- The style settings for the button. This is defined as a
style property. The individual styles are described as
IAnimatedButton style properties.
- text
- Text for the button. If text is specified, it appears
below the bitmap on the button.
- userData
- Program data for the button. This unsigned long property
is generally set by code functions rather than in a
property sheet.
IAnimatedButton 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:
- animateWhenLatched
- Specifies whether animation is tied to the latched state
of the button. If this style is on, animation
starts automatically when the button becomes latched and
and stops when it becomes unlatched.
- autoLatch
- Specifies whether latching is tied to the latched state
of other buttons in a control group. All buttons in the
group must be latchable and have automatic latching
enabled.
- 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 button is the first control in a
control group.
- latchable
- Specifies whether the button is latchable. If this style
is on, the button toggles between the latched and
unlatched state each time the user selects it.
- noPointerFocus
- Specifies whether the button gets the input focus when
the user selects it with a mouse. If this style is on,
the focus does not shift to this button when it is
selected with a mouse.
- 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 button is a tab stop.
- visible
- Specifies whether the button is visible.
Working with
IAnimatedButton Parts
Editing Part Properties
Property Settings -- IVBMinSize
Style Properties
Color Properties
Font Properties
Handler Properties
Size and Position Properties
Code Properties
Resource Properties
IAnimatedButton
Portability -- IAnimatedButton
VisualAge User Interface Part
Properties