Property Settings -- IFrameWindow

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

IFrameWindow properties

activeColor
The active color of the frame window. 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 frame window. This is defined as a color property.

borderColor
The border color of the frame window. This is defined as a color property.

borderHeight
The height of the top and bottom borders.

borderSize
The height of the top and bottom borders and the width of the left and right borders. This is defined as an ISize property.

borderWidth
The width of the left and right borders.

defaultOrdering
The depth order of the window relative to existing sibling windows

If nothing is specified, behindSiblings is assumed. Typically, a frame window is invisible when it is created. The setFocus action is used to position the window in front of sibling windows before the window is made visible.

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

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

enabled
Specifies whether the frame window is enabled for selection.

enabledForNotification
Specifies whether the frame window 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 frame window. To display the fly-over text, you must add an IFrameWindow* part to the composite part for the window and specify a text control for the IFrameWindow* part.

Fly-over short text
Text that is displayed in a pop-up caption box when the mouse pointer hovers over the frame window. To display the fly-over text, you must add an IFrameWindow* part to the composite part for the window.

font
Specifies the text font for the frame window. This is defined as a font property.

foregroundColor
The foreground color of the frame window. This is defined as a color property.

handlers
The list of attached handlers for the frame window. This is defined as a handlers property.

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

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

icon
Specifies a minimized icon for the frame window. This is defined as a resource property.

id
The window ID of the frame window.

inactiveColor
The inactive color of the frame window. 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 frame window. 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 frame window. This is defined as a color property.

Size and position
The size and position of the frame window. This is defined as a framing property.

style
The style settings for the frame window. This is defined as a style property. The individual styles are described as IFrameWindow style properties.

title
Text for the frame window title.

toolBarList
Specifies a list of tool bars for the frame window. This is defined as a code property. Enter a pointer to an IToolBarList object, or code that produces this pointer. This property is defined automatically in generated code, based on the tool bars you add to the frame window.

IFrameWindow 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:

accelerator
Specifies whether an accelerator key table is loaded from the resource library.

animated
Specifies whether animation is displayed when the window is opened, closed, or restored.

appDBCSStatus
Specifies whether a double-byte character set (DBCS) status area is added when the window is displayed in a DBCS environment.

border
Specifies whether the frame window has a border.

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.

dialogBackground
Specifies whether the frame window uses the system dialog background color.

dialogBorder
Specifies whether the frame window has a dialog border.

group
Specifies whether the frame window is the first control in a control group.

hideButton
Specifies whether the frame window has a hide button. This style is mutually exclusive with the minimizeButton style. Ensure that only one of these styles is on, either explicitly or by default. For Windows, this style has the same effect as the minimizeButton style.

horizontalScroll
Specifies whether the frame window has a horizontal scroll bar.

maximizeButton
Specifies whether the frame window has a maximize button. If this style is set on for a Windows 95 desktop, the systemMenu style is automatically set on.

maximized
Specifies whether frame window is initially maximized.

menuBar
Specifies whether the frame window has a menu bar loaded from the resource library.

minimizeButton
Specifies whether the frame window has a minimize button. this style is mutually exclusive with the hideButton style. Ensure that only one of these styles is on, either explicitly or by default. If this style is set on for a Windows 95 desktop, the systemMenu style is automatically set on.

minimized
Specifies whether frame window is initially minimized.

noMoveWithOwner
Specifies whether the window is moved when its owner is moved. If this style is off, the window is moved with its owner. For Windows, a frame window is never moved with its owner.

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

shellPosition
Specifies whether the initial position of the window is determined by the system shell.

sizingBorder
Specifies whether the frame window has a sizing border.

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

systemMenu
Specifies whether the frame window has a system menu.

systemModal
Specifies whether text in the frame window is system modal. If this style is on, no other window on the system can receive focus until this window is closed.

tabStop
Specifies whether the frame window is a tab stop.

titleBar
Specifies whether the frame window has a title bar.

verticalScroll
Specifies whether the frame window has a vertical scroll bar.

visible
Specifies whether the frame window is visible. Typically, a frame window is invisible when it is created. The show or showModally action is used make the window visible after it is initialized.

windowList
Specifies whether the frame window is added to the window list when it is created.


Related procedures
Working with IFrameWindow Parts
Editing Part Properties

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