MOA Developer's Guide
MOA Interfaces | MOA Methods | MOA Types and Misc API

IMoaCallback

Interface ID: IID_IMoaCallback
Pointer type: PIMoaCallback
Inheritance: IMoaUnknown
Header file: moaxtra.h

Description

This standard MOA interface is implemented by the application's callback object for the use of Xtras. It provides methods for accessing other interfaces belonging to the application, for acquiring and releasing resources for use by the Xtra, for accessing the application cache, and for creating instances of MOA classes and interfaces. All MOA objects have an instance variable, pCallback, that refers to this interface of the application's callback object.

Methods

Creating an instance

MoaCreateInstance()

Getting a cache

MoaGetCache()

Using Resources

MoaBeginUsingResources()
MoaEndUsingResources()

MoaBeginUsingResources()

Syntax

MoaBeginUsingResources(MoaFileRef fileRef, XtraResourceCookie * pSaveCookie)

Parameters

fileRef
File reference
pSaveCookie
Resource cookie for the file

Returns

XtraResourceCookie

Description

Opens, if necessary, and returns an identifier for the resources in the file represented by fileRef. When it opens your Xtra, MOA creates the global gXtraFileRef to refers to your Xtra's file (global within the namespace of your Xtra). Pass this global as the fileRef parameter. The parameter pSaveCookie returns a reference to the resource file to use in calling the method MoaEndUsingResources().

MoaCreateInstance()

Syntax

MoaCreateInstance(ConstPMoaClassID pClassID, ConstPMoaInterfaceID pInterfaceID, PPMoaVoid ppvOb)

Parameters

pClassID
CLSID for the class being instantiated

pInterfaceID
IID for the interface being instantiated

ppvOb
Pointer to interface of type pInterfaceID

Returns

MoaError

Description

Create and initialize an object of the class with CLSID pClassID, and return a pointer to the interface with IID pInterfaceID. MOA will choose the class and interface from the correct Xtra, and return a pointer to the interface in ppUnknown. In the event of duplicate class ID's, the Xtra containing the most recent version will be used (according to the information provided when the Xtra is loaded).

MoaEndUsingResources()

Syntax

MoaEndUsingResources(MoaFileRef fileRef, XtraResourceCookie saveCookie)

Parameters

fileRef
File reference

saveCookie
Resource cookie for the file

Returns

void

Description

Closes the resource file represented by fileRef and previously opened with the MoaBeginUsingResources() method.

MoaGetCache()

Syntax

MoaGetCache()

Parameters

Returns

Applications interface

Description

Call this method to access the application cache from within your Xtra.

Copyright © 1995-2008 Adobe Macromedia Software LLC, Inc.