IObjectWindow

The IObjectWindow class represents object windows. Object windows are invisible windows that process window events. Essentially, these windows receive only messages that are explicitly sent to them.

One possible use of this class is to process a set of user-defined messages.

AIX Considerations

IObjectWindow creates an invisible window. The parent of the window is the window returned by the IWindow::objectWindow function.

OS/2 Considerations

These windows have minimal system overhead because they are created with a parent of HWND_OBJECT.

Windows Considerations

IObjectWindow creates an invisible window. The parent of the window is the window returned by the IWindow::objectWindow function.


IObjectWindow - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class. You cannot copy or assign IObjectWindow objects because both the copy constructor and assignment operator are private functions.


[view class]
~IObjectWindow
public:
virtual ~IObjectWindow()

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
IObjectWindow
public:
IObjectWindow( const IObjectWindow::Style& style = defaultStyle ( ) )

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Closing

After you construct an object window, it exists until you close it or you end the thread with its message queue.


[view class]
close
public:
IObjectWindow& close()

Closes the object window.

The Open Class Library considers an IObjectWindow object to represent a primary window, unless you call IWindow::setParent. The Open Class Library automatically ends the message processing for a thread when all of its primary windows are closed.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Styles

These style members provide a set of valid styles for the IObjectWindow class. Use these members to set and query object window styles.


[view class]
defaultStyle
public:
static Style defaultStyle()

Returns the default style for the IObjectWindow class.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
setDefaultStyle
public:
static void setDefaultStyle(const Style& style)

Sets the default style of the IObjectWindow class.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
boundToMessageQueue
public:
static const Style boundToMessageQueue

Style used to bind window to the message queue. If this style is set, the event processing loop will remain active as long as this window exists.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
classDefaultStyle
public:
static const Style classDefaultStyle

Default style of the class, which is IObjectWindow::boundToMessageQueue.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
noStyle
public:
static const Style noStyle

Sets all styles off.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


IObjectWindow - Inherited Member Functions and Data

Inherited Public Functions

INotifier
IWindow

Inherited Public Data

IWindow
INotifier

Inherited Protected Functions

IWindow
INotifier

Inherited Protected Data