CResourceItems

Heritage

Description

Usage

Protected Data Members

Public Methods

Constructor and Destructor

Copy and Assignment

Resource Item Methods

Heritage

Subclasses: None

Description

To use this convenience class, a resource must already be registered with CResourceMgr. If the resource has not been created (therefore registered with CResourceMgr), CResourceItems constructor will assert.

Usage

// Get resource (will hold and release accordingly):
CResourceItems theRes(theMenu);
theRes.First();  // reset iteratation
 
// Traverse through menubar and add submenu
// accordingly:
long theMenuId;
while (theMenuId = theRes.Next()) {
	CSubmenu theSubmenu;
	theRes.IObject(theMenuId, &theSubmenu); 
// creates nested items/submenus
	AppendSubmenu(theSubmenu);
}

Public Methods

CResourceItems(long theId);

The constructor. Given the resource ID, the constructor finds the resource in the CResourceMgr list of resources and calls the resource's Hold method (see the CResource description). When you destroy the resource, it releases it automatically by calling the resource Release method.

virtual ~CResourceItems(void);

The destructor. Calls Release on its associated resource (itsResource).

CResourceItems(const CResourceItems &theResource);

A copy constructor, which copies one CResourceItem into another. It also calls Hold on the associated resource.

CResourceItems & operator = (
		const CResourceItems &theResource);

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

virtual long First(void);

Calls itsResource FirstItem method and returns the resource ID.

virtual long Next(void);

Calls itsResource NextItem method and returns the resource ID.

virtual long GetType(long theId);

Calls itsResource GetItemType method and returns the type.

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

Calls itsResource IObject method and returns TRUE if the initialization succeeds.