Use the following properties to define initial characteristics
of an ISetCanvas* part.
- Part properties are displayed in the part property sheet.
- Style properties are displayed in the Part style
property sheet.
ISetCanvas properties
-
- activeColor
- The active color of the canvas. This is defined as a
color property.
- alignment
- Specifies the alignment of controls within decks (rows or
columns) of the canvas. If nothing is specified, topLeft
is assumed. Control alignment is indicated by the
location of alignment choices within the following
table:
| topLeft |
topCenter |
topRight |
| centerLeft |
centerCenter
|
centerRight |
| bottomLeft |
bottomCenter
|
bottomRight |
- 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 canvas. This is defined as a
color property.
- borderColor
- The border color of the canvas. This is defined as a
color property.
- deckCount
- The number of decks (rows or columns) in the canvas. If
nothing is specified, 1 is assumed.
- deckOrientation
- The orientation of decks within the canvas.
- horizontal--sets the horizontalDecks
style on and the verticalDecks
style off.
- vertical--sets the verticalDecks
style on and the horizontalDecks
style off.
- disabledBackgroundColor
- The background color of the canvas when it is disabled.
This is defined as a color property.
- disabledForegroundColor
- The foreground color of the canvas when it is disabled.
This is defined as a color property.
- enabled
- Specifies whether the canvas is enabled for selection.
- enabledForNotification
- Specifies whether the canvas 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 canvas. 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 canvas. 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 canvas. This is defined
as a font property.
- foregroundColor
- The foreground color of the canvas. This is defined as a
color property.
- groupPad
- The pad space between control groups. If nothing is
specified, 0 is assumed.
- handlers
- The list of attached handlers for the canvas. This is
defined as a handlers property.
- helpId
- The ID of the help panel for the canvas. 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 canvas when it is
highlighted. This is defined as a color property.
- hiliteForegroundColor
- The foreground color of the canvas when it is
highlighted. This is defined as a color property.
- id
- The window ID of the canvas.
- inactiveColor
- The inactive color of the canvas. 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.
- margin
- Specifies the height of the top and bottom margins and
the width of the left and right margins around the decks
in the canvas. If nothing is specified, the average
character width and maximum character height for the
initial font are used to determine the margin size. This
is defined as an ISize property.
- minimumSize
- Specifies the minimum size of the canvas. Multicell
canvases and set canvases use the minimum size to lay out
controls. This is defined as an IVBMinSize property.
- packType
- The arrangement of controls within a deck. If nothing is
specified, horizontal is assumed.
- even--controls are evenly distributed,
with varying space between them if their sizes
vary
- expanded--controls are resized to a
uniform size, with minimum space between controls
in a group
- tight--controls are packed tightly, with
minimum space between controls in a group
- pad
- The minimum space between controls in a group.
- partName
- The composition name of the part. This name is used for
the class instance in generated code.
- shadowColor
- The shadow color of the canvas. This is defined as a
color property.
- Size and position
- The size and position of the canvas. This is defined as a
framing property.
- style
- The style settings for the canvas. This is defined as a
style property. The individual styles are described as
ISetCanvas style properties.
- text
- Text for a group box label. If text is specified, a group
box is drawn around the canvas.
ISetCanvas 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 canvas is the first control in a
control group.
- horizontalDecks
- Specifies whether controls are arranged in rows, from
left to right in each row. This style is mutually
exclusive with the verticalDecks style. 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.
- synchPaint
- Specifies whether the window object is painted
synchronously rather than waiting for other system events
to processed.
- tabStop
- Specifies whether the canvas is a tab stop.
- verticalDecks
- Specifies whether controls are arranged in columns, from
top to bottom in each column. This style is mutually
exclusive with the horizontalDecks style. Ensure
that only one of these styles is on, either
explicitly or by default.
- visible
- Specifies whether the canvas is visible.
Working with
ISetCanvas Parts
Editing Part Properties
Property Settings -- IVBMinSize
Property Settings -- ISize
Style Properties
Color Properties
Font Properties
Handler Properties
Size and Position Properties
Code Properties
ISetCanvas
Portability -- ISetCanvas
VisualAge User Interface Part
Properties