WpRegisterView

This instance method is called to allow the object to register a new open view.

Syntax

_wpRegisterView(somSelf, hwndFrame, pszViewTitle)

Parameters

somSelf (WPObject *) - input

Pointer to the object on which the method is being invoked.

Points to an object of class WPObject.

hwndFrame (HWND) - input

Handle to the frame window containing the new view.

pszViewTitle (PSZ) - input

Pointer to a string containing the name of the view.

Returns

rc (BOOL) - returns

Success indicator.

• TRUE Successful completion.
• FALSE Error occurred.

How to Override

This method is generally not overridden.

Usage

This method should be called anytime a new view of an object is created.

Example Code

#define INCL_WINWORKPLACE
#include <os2.h>

WPObject *somSelf; /* Pointer to the object on which the method is being invoked. */
HWND hwndFrame; /* Handle to the frame window containing the new view. */
PSZ pszViewTitle; /* Pointer to a string containing the name of the view. */
BOOL rc; /* Success indicator. */

rc = _wpRegisterView(somSelf, hwndFrame, pszViewTitle);

Remarks

Registering a view sets the object title of the frame window to the object's title and adds a view title as the current view in the window list and title bar. In-use emphasis is managed by the wpAddToObjUseList method.

Related Methods

• wpAddToObjUseList
• wpOpen