IShResourceUtilities Struct Reference
[Shell Utilities]

Utilities for getting and handling resources. More...

Inheritance diagram for IShResourceUtilities:

IMCUnknown List of all members.

Public Member Functions

virtual MCCOMErr MCCOMAPI GetIndString (TMCString &ioString, int16 inResID, int16 inIndex)=0
virtual MCCOMErr MCCOMAPI GetIndString (IDType inCompFamilyID, IDType inCompClassID, TMCString &ioString, int16 inResID, int16 inIndex)=0
virtual MCCOMErr MCCOMAPI GetResource (const FourCharT inType, const int32 inResID, int8 *&outResource, uint32 &outSize)=0
virtual MCCOMErr MCCOMAPI GetIndResource (const IDType type, const int32 index, int8 *&outResource, uint32 &outSize)=0
virtual MCCOMErr MCCOMAPI SetupComponentResources (IDType inCompFamilyID, IDType inCompClassID, void **outOldResources)=0
virtual MCCOMErr MCCOMAPI RestoreComponentResources (void *inOldResources)=0
virtual void MCCOMAPI ReleaseResource (int8 *resourcePtr)=0

Detailed Description

Utilities for getting and handling resources.

Member Function Documentation

virtual MCCOMErr MCCOMAPI IShResourceUtilities::GetIndResource (  const IDType  type,
const int32  index,
int8 *&  outResource,
uint32 &  outSize
)  [pure virtual]
 

Gets a resource by index from the current resource file. Generally used when you want to operate on every resource of a given type in the resource file.

See also:
CWhileInCompResFile
Parameters:
type Resource type to get
index Index of resource to get
outResource A pointer to a memory location where the resource has been allocated
outSize returns the size of the resource

virtual MCCOMErr MCCOMAPI IShResourceUtilities::GetIndString (  IDType  inCompFamilyID,
IDType  inCompClassID,
TMCString &  ioString,
int16  inResID,
int16  inIndex
)  [pure virtual]
 

Gets a string from a STR# resource by index. Looks in the resource corresponding to the specified family and class IDs.

Parameters:
inCompFamilyID Component family ID for resource
inCompClassID Component class ID for resource
ioString Returns the string found
inResID Resource ID of the STR# resource
inIndex Index of the string to get within the resource

virtual MCCOMErr MCCOMAPI IShResourceUtilities::GetIndString (  TMCString &  ioString,
int16  inResID,
int16  inIndex
)  [pure virtual]
 

Gets a string from a STR# resource by index. This is the most common way to get a string for display. Looks in the current resource file.

See also:
CWhileInCompResFile
Parameters:
ioString Returns the string found
inResID Resource ID of the STR# resource
inIndex Index of the string to get within the resource

virtual MCCOMErr MCCOMAPI IShResourceUtilities::GetResource (  const FourCharT  inType,
const int32  inResID,
int8 *&  outResource,
uint32 &  outSize
)  [pure virtual]
 

Gets a resource from the current resource file. You must call ReleaseResource() to release the memory allocated in outResource

See also:
CWhileInCompResFile
Parameters:
inType Resource type to get
inResID Resource ID of the resource to get
outResource A pointer to a memory location where the resource has been allocated
outSize Returns the size of the resource

virtual void MCCOMAPI IShResourceUtilities::ReleaseResource (  int8 *  resourcePtr  )  [pure virtual]
 

Releases a resource returned by GetResource

Parameters:
resourcePtr The pointer returned by GetResource

virtual MCCOMErr MCCOMAPI IShResourceUtilities::RestoreComponentResources (  void *  inOldResources  )  [pure virtual]
 

Do not use. You should use CWhileInCompResFile instead of RestoreComponentResources in extensions.

Parameters:
inOldResources 

virtual MCCOMErr MCCOMAPI IShResourceUtilities::SetupComponentResources (  IDType  inCompFamilyID,
IDType  inCompClassID,
void **  outOldResources
)  [pure virtual]
 

Do not use. You should use CWhileInCompResFile instead of SetupComponentResources in extensions.

Parameters:
inCompFamilyID 
inCompClassID 
outOldResources 

The documentation for this struct was generated from the following file:
Generated on Mon Mar 14 12:29:05 2005 for Carrara SDK Doc by  doxygen 1.3.9.1