View source for WpAddSystem256ColorPage

{{DISPLAYTITLE:wpAddSystem256ColorPage}}
This method is specific to Version 4, or higher, of the OS/2 operating system.

This instance method adds the 256 Color page to the System Settings notebook.

==Syntax==
 _wpAddSystem256ColorPage(somSelf, hwndNotebook);

==Parameters==
;''somSelf'' ([[WPSystem]] *) - input
:Pointer to the object on which the method is being invoked.
:Points to an object of class [[WPSystem]].

;''hwndNotebook'' ([[HWND]]) - input
:Window handle for the Settings notebook.

==Returns==
;''rc'' ([[ULONG]]) - returns
:Page identifier.
:A return value of 0 indicates that an error occurred.
:PageId: Identifier for the inserted page.

==Usage==
This method must be called only from within an override of the [[wpAddSettingsPages]] method.

==How to Override==
This method should always be overridden in order to replace or remove the 256 Color page from the object's Settings notebook. To remove the page from the Settings notebook, the override method should return SETTINGS_PAGE_REMOVED without calling the parent method. To replace the page with another page, the override method should call the [[wpInsertSettingsPage]] method without calling the parent method.

==Example Code==
This example overrides the method to eliminate this page from the object's Settings notebook.
<PRE>
SOM_Scope ULONG SOMLINK MyObj_wpAddSystem256ColorPage(MyObj somSelf,
                 HWND hwndNotebook)
{
     / MyObjData *somThis = MyObjGetData(somSelf); */
     MyObjMethodDebug("MyObj","MyObj_wpAddSystem256ColorPage");

 /*  return (parent_wpAddSystem256ColorPage(somSelf,hwndNotebook)); */

     return ( SETTINGS_PAGE_REMOVED );
}
</PRE>

==Related Methods==
* [[wpAddSettingsPages]]
* [[wpInsertSettingsPage]]

[[Category:Workplace Instance Methods]]