Methods Index

CResourceMenu

Heritage

Superclass: CResource

Description

This class provides the mechanism for XVT-Power++ to read in a menu description from the URL file.

Usage

CMenuBar theMenuBar(theWin, MENU_ID);
const short kResErrBase = 5150;                                                    
CResource *theRes = new CResourceMenu(MENU_BAR_RID);
PwrAssert(theRes, kResErrBase + 1,
	"Unable to bake resource.");
 
theRes->Hold();
theRes->FirstItem();  // reset iterator
 
long theId;     
while (theId = theRes->NextItem()) {
	CSubmenu theSubmenu;
	theRes->IObject(theId, &theSubmenu); 
	theMenuBar.AppendSubmenu(theSubmenu);
}
theRes->Release();
delete theRes;

Enums

PwrResourceMenuType

The following are the possible types returned by GetItemType:

PwrSubMenu
PwrMenuItem


`PwrSubMenu`
`PwrMenuItem`

Protected Data Members

long itsCurrIndex; An index to the current menu in the list of menu resources (CResource::itsResources)
MENU_ITEM* itsMenuDef; The associated XVT MENU_ITEM array of structures, see the XVT Portability Toolkit Guide.


`long`	`itsCurrIndex;`	An index to the current menu in the list of menu resources (`CResource::itsResources`)
`MENU_ITEM*`	`itsMenuDef;`	The associated XVT `MENU_ITEM` array of structures, see the XVT Portability Toolkit Guide.

Public Methods

Constructor and Destructor

CResourceMenu(long theId);

The constructor. theId is the URL resource ID for the menu.

virtual ~CResourceMenu(void);

The destructor.

Resource State Methods

virtual BOOLEAN Hold(void);

Overrides the CResource abstract method to specify how to load a menu resource from a URL file. Returns TRUE upon success (FALSE if the resource could not be loaded from URL). See

CResource

virtual void Release(void);

Overrides the CResource abstract method to specify how to free the internal memory associated with a menu resource and which pointers to reset. See

CResource

Resource Item Methods

virtual BOOLEAN IObject(long theId, 
	CObjectRWC *theObject);

Overrides the CResource abstract method to specify the initializer for a CResourceMenu. Initializes a top-level CSubmenu. It returns TRUE if the initialization succeeds.

virtual long FirstItem(void);

Overrides the CResource abstract method to specify the resource ID for the menubar itself. This is also a way to reset the resource iterator to return the ID of the first top-level submenu.

virtual long NextItem(void);

Overrides the CResource abstract method to specify how to move forward in the internal representation of menu resources (menu and associated menu items and submenus).

virtual long GetItemType(long theId);

Overrides the CResource abstract method to return the object type given a resource ID (see "Enums"

Protected Methods

Copy and Assignment

CResourceMenu(const CResourceMenu &theResource);

A copy constructor, which copies one resource menu into another.

CResourceMenu & operator=(
	const CResourceMenu &theResource);

An assignment operator, which allows you to set one resource menu equal to another.

Utility Methods

void BuildSubmenu(MENU_ITEM *theXVTMenu, 
	CSubmenu *theSubMenu, CMenu *theMenu);

Builds a CSubMenu XVT-Power++ object from an array of MENU_ITEM structures. theSubMenu is the CSubmenu object being built. theXVTMenu is the array of MENU_ITEM structures, and theMenu is the menu to attach this submenu with.

void InitMenu(MENU_ITEM* theXVTMenu, CMenu *theMenu);

Initializes a CMenu object from an array of MENU_ITEM structures, theXVTMenu is the array of MENU_ITEM structures and theMenu is the CMenu to build.

[Classes] [Prev] [Next] [Methods]

support@xvt.com