OWLNext 6.32
Public Member Functions | Protected Member Functions
ocf::TOleMDIFrame Class Reference

Decorated MDI frame that supports OLE 2 using OCF. More...

#include <olemdifr.h>

Inheritance diagram for ocf::TOleMDIFrame:
ocf::TOleFrame owl::TMDIFrame owl::TDecoratedFrame owl::TFrameWindow owl::TFrameWindow owl::TLayoutWindow owl::TWindow owl::TWindow owl::TWindow owl::TEventHandler owl::TStreamableBase owl::TEventHandler owl::TStreamableBase owl::TEventHandler owl::TStreamableBase

List of all members.

Public Member Functions

 TOleMDIFrame (LPCTSTR title, owl::TResId menuResId, owl::TMDIClient &clientWnd=*new owl::TMDIClient, bool trackMenuSelection=false, owl::TModule *module=0)
 ~TOleMDIFrame ()

Protected Member Functions

virtual owl::TResult DefWindowProc (owl::uint message, owl::TParam1 param1, owl::TParam2 param2)
bool EvOcAppInsMenus (TOcMenuDescr &sharedMenu)
void EvActivateApp (bool active, HTASK hTask)
 DECLARE_RESPONSE_TABLE (TOleMDIFrame)

Detailed Description

Decorated MDI frame that supports OLE 2 using OCF.

Derived from TMDIFrame and TOleFrame, TOleMDIFrame provides OLE user-interface support for the main window of a Multiple Document Interface (MDI) application. TOleMDIFrame also talks directly to the ObjectComponents classes through the use of a pointer to the OcApp object.

TOleMDIFrame inherits functionality from TMDIFrame that supports the use of MDI frame windows designed to serve as the main windows of an MDI-compliant application. It also inherits decorated frame window functionality that supports the addition of decorations (such as toolbars and status lines) to the frame window. In addition, TOleMDIFrame inherits the ability to

TOleMDIFrame also inherits from TOleFrame the ability to talk directly to the ObjectComponents classes through the use of a pointer to the OcApp object.

See Step 14 of the ObjectWindows tutorial for an example of a program that uses TOleMDIFrame to create an OLE-enabled decorated MDI frame window.


Constructor & Destructor Documentation

ocf::TOleMDIFrame::TOleMDIFrame ( LPCTSTR  title,
owl::TResId  menuResId,
owl::TMDIClient clientWnd = *new owl::TMDIClient,
bool  trackMenuSelection = false,
owl::TModule module = 0 
)

Constructs a TOleMDIFrame object with the indicated title, menu resource ID, client window, and module instance. By default, because trackMenuSelection is false, menu hint text is not displayed. (These parameters coincide with those of TMDIFrame's constructor.)

ocf::TOleMDIFrame::~TOleMDIFrame ( )

Destroys the OLE MDI frame window object.


Member Function Documentation

TResult ocf::TOleMDIFrame::DefWindowProc ( owl::uint  message,
owl::TParam1  param1,
owl::TParam2  param2 
) [protected, virtual]

Allows default processing for all messages except for a resizing message concerning the frame window, in which case, DefWindowProc returns nothing.

Reimplemented from owl::TMDIFrame.

References owl::TMDIFrame::DefWindowProc().

void ocf::TOleMDIFrame::EvActivateApp ( bool  active,
HTASK  hTask 
) [protected]

Responds to a message indicating that the frame window of this application (hTask) is going to be either activated (active is true) or deactivated (active is false), and forwards this information to the TOcApp object.

Reimplemented from ocf::TOleFrame.

References owl::TWindow::EvActivateApp().

bool ocf::TOleMDIFrame::EvOcAppInsMenus ( TOcMenuDescr sharedMenu) [protected]

Inserts menus into a provided menu bar, or merges them with a child window and servers. To do this, EvOcAppInsMenus creates a temporary composite menu for the frame and MDI child windows, then copies the shared menu widths to the ObjectComponents structure. It saves the container popups so they can be destroyed later.

Reimplemented from ocf::TOleFrame.

References owl::TMDIClient::GetActiveMDIChild(), owl::TMenuDescr::GetGroupCount(), owl::TFrameWindow::GetMenuDescr(), and owl::TMenuDescr::Merge().


The documentation for this class was generated from the following files: