Use the following properties to define initial characteristics
of an IViewPort* part.
- Part properties are displayed in the part property sheet.
- Style properties are displayed in the Part style
property sheet.
IViewPort properties
-
- activeColor
- The active color of the view port. 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 view port. This is defined as
a color property.
- borderColor
- The border color of the view port. This is defined as a
color property.
- disabledBackgroundColor
- The background color of the view port when it is
disabled. This is defined as a color property.
- disabledForegroundColor
- The foreground color of the view port when it is
disabled. This is defined as a color property.
- enabled
- Specifies whether the view port is enabled for selection.
- enabledForNotification
- Specifies whether the view port 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 view port. 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 view port. 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 view port. This is
defined as a font property.
- foregroundColor
- The foreground color of the view port. This is defined as
a color property.
- handlers
- The list of attached handlers for the view port. This is
defined as a handlers property.
- helpId
- The ID of the help panel for the view port. 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 view port when it is
highlighted. This is defined as a color property.
- hiliteForegroundColor
- The foreground color of the view port when it is
highlighted. This is defined as a color property.
- id
- The window ID of the view port.
- inactiveColor
- The inactive color of the view port. 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 view port. 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.
- shadowColor
- The shadow color of the view port. This is defined as a
color property.
- Size and position
- The size and position of the view port. This is defined
as a framing property.
- style
- The style settings for the view port. This is defined as
a style property. The individual styles are described as
IViewPort style properties.
- viewWindowSize
- The size of the window being scrolled. If nothing is
specified, the actual size of the window is used. If you
define a logical size, you are responsible for scroll
painting. This is defined as an ISize property.
IViewPort 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:
- asNeededHorizontalScrollBar
- asNeededVerticalScrollBar
- visible
- alwaysHorizontalScrollBar
- Specifies whether the view port always displays a
horizontal scroll bar. This style is mutually exclusive
with the asNeededHorizontalScrollBar and noHorizontalScrollBar
styles. Ensure that only one of these styles is on,
either explicitly or by default.
- alwaysVerticalScrollBar
- Specifies whether the view port always displays a
vertical scroll bar. This style is mutually exclusive
with the asNeededVerticalScrollBar and noVerticalScrollBar
styles. Ensure that only one of these styles is on,
either explicitly or by default.
- asNeededHorizontalScrollBar
- Specifies whether the view port displays a horizontal
scroll bar only when necessary. If this style is on,
a horzontal scroll bar is displayed when the width of the
view window contents is greater than the width of the
view port.
This style is mutually exclusive with the alwaysHorizontalScrollBar
and noHorizontalScrollBar styles. Ensure that only
one of these styles is on, either explicitly or by
default.
- asNeededVerticalScrollBar
- Specifies whether the view port displays a vertical
scroll bar only when necessary. If this style is on,
a horzontal scroll bar is displayed when the height of
the view window contents is greater than the height of
the view port.
This style is mutually exclusive with
the alwaysVerticalScrollBar and noVerticalScrollBar
styles. Ensure that only one of these styles is on,
either explicitly or by default.
- 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.
- expandableViewWindow
- Specifies whether the view port sizes the view window, if
necessary, to fill the view port. This is useful if the
view window is a multicell canvas with expandable rows or
columns.
- group
- Specifies whether the view port is the first control in a
control group.
- noHorizontalScrollBar
- Specifies whether the view port never displays a
horizontal scroll bar. This style is mutually exclusive
with the alwaysHorizontalScrollBar and asNeededHorizontalScrollBar
styles. Ensure that only one of these styles is on,
either explicitly or by default.
- noVerticalScrollBar
- Specifies whether the view port never displays a vertical
scroll bar. This style is mutually exclusive with the alwaysVerticalScrollBar
and asNeededVerticalScrollBar styles. Ensure that
only one of these styles is on, either explicitly
or by default.
- noViewWindowFill
- Specifies whether the view port paints the portion of the
view rectangle occupied by the view window. If the view
window paints its entire rectangle, overall painting is
optimized by setting this style on. If this style
is on, the view window is responsible for clearing
and painting its view rectangle for scrolling.
- 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 view port is a tab stop.
- visible
- Specifies whether the view port is visible.
Working with IViewPort
Parts
Editing Part Properties
Property Settings -- IVBMinSize
Property Settings -- ISize
Style Properties
Color Properties
Font Properties
Handler Properties
Size and Position Properties
Code Properties
IViewPort
Portability -- IViewPort
VisualAge User Interface Part
Properties