Property Settings -- INotebook

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

INotebook properties

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

binding
The type of binding displayed on the notebook.

The default value is solid. This property is ignored if the pmCompatible style is off.

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

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

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

enabled
Specifies whether the notebook is enabled for selection.

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

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

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

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

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

id
The window ID of the notebook.

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

majorTabBackgroundColor
The background color of major notebook page tabs. This is defined as a color property.

majorTabForegroundColor
The foreground color of major notebook page tabs. This is defined as a color property.

Major tab size
The size of major notebook page tabs. This is defined as an ISize property. This property is ignored if the pmCompatible style is off.

minimumSize
Specifies the minimum size of the notebook. Multicell canvases and set canvases use the minimum size to lay out controls. This is defined as an IVBMinSize property.

minorTabBackgroundColor
The background color of minor notebook page tabs. This is defined as a color property.

minorTabForegroundColor
The foreground color of minor notebook page tabs. This is defined as a color property.

Minor tab size
The size of minor notebook page tabs. This is defined as an ISize property. This property is ignored if the pmCompatible style is off.

orientation
The orientation of back pages and major tabs. The default value is backpagesBottomTabsRight. This property is ignored if the pmCompatible style is off.
Value of orientation property Location of back page edges Location of major tabs
backpagesBottomTabsLeft Below and left of the top page Left of pages
backpagesBottomTabsRight Below and right of the top page Right of pages
backpagesLeftTabsBottom Below and left of the top page Below pages
backpagesLeftTabsTop Above and left of the top page Above pages
backpagesRightTabsBottom Below and right of the top page Below pages
backpagesRightTabsTop Above and right of the top page Above pages
backpagesTopTabsLeft Above and left of the top page Left of pages
backpagesTopTabsRight Above and right of the top page Right of pages

pageBackgroundColor
The background color of notebook pages. This is defined as a color property.

Page button size
The size of notebook paging buttons. This is defined as an ISize property. This property is ignored if the pmCompatible style is off.

partName
The composition name of the part. This name is used for the class instance in generated code.

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

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

statusTextAlignment
The alignment of text in the notebook status area. Alignment is indicated by the location of statusTextAlignment choices within the following table:
left center right

The default value is left. This property is ignored if the pmCompatible style is off.

style
The style settings for the notebook. This is defined as a style property. The individual styles are described as INotebook style properties.

tabShape
The shape of notebook page tabs.

The default value is square. This property is ignored if the pmCompatible style is off.

tabTextAlignment
The alignment of text on notebook page tabs. Alignment is indicated by the location of tabTextAlignment choices within the following table:
left center right

The default value is center.

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

allTabsVisible
Specifies whether tabs are drawn in multiple rows, if necessary, to show all tabs without scrolling. This style is ignored if the pmCompatible style is 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 notebook is the first control in a control group.

handleDrawTabs
Specifies whether the application draws notebook page tabs, using INotebookDrawItemEvent system events. To process these events, override IPageHandler::drawTab. This style is ignored if the pmCompatible style is on.

pmCompatible
Specifies whether the notebook is compatible with the OS/2 Presentation Manager (PM) notebook.

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 notebook is a tab stop.

visible
Specifies whether the notebook is visible.


Related procedures
Working with INotebook 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
INotebook
Portability -- INotebook
VisualAge User Interface Part Properties