Jump to content

wpRegisterView

From EDM2

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