MM Developer's Guide
MM Interfaces | MM Methods | MM Types and Misc API
IMoaMmAssetCallback2
Interface ID: IID_IMoaMmAssetCallback2
Pointer type: PIMoaMmAssetCallback2
Inheritance: IMoaMmAssetCallback
Header file: mmiservc.h
Description
- Callback interface for asset Xtras, supplied to an asset when
the host application calls the IMoaMmXAsset::SetCallback() method, soon after the asset has been instantiated. This interface
supercedes the IMoaMmAssetCallback interface from which it inherits.
Director supplies the IMoaDrAssetCallback interface
to support application-specific callback
through the object providing the IMoaDrAssetCallback2 interface. Call QueryInterface() on this interface, using the interface identifier IID_IMoaDrAssetCallback to get this asset callback.
Methods
Change notification
- GetModified()
SetModified()
InvalDefaultRectValue()
Actor notification
- NotifySprites()
Media management
- ForceMediaLoad()
ForceMediaUnload()
Syntax
- ForceMediaLoad()
Parameters
Returns
- MoaError
Syntax
- ForceMediaUnload()
Parameters
Returns
- MoaError
Syntax
- GetModified(PMoaMmModifyFlags pModifyFlags)
Parameters
- pModifyFlags
- PMoaMmModifyFlags
Returns
-
- MoaError
Description
-
- Gets the modifyFlags value
for the asset, which lets you see if the asset has been marked
as dirty or not. See the description of MoaMmModifyFlags later in this chapter for details on specific entries in the flag.
Syntax
- InvalDefaultRectValue()
Parameters
Returns
- MoaError
Description
- To change your asset's default rectangle, you must notify
the host application using this asset callback method. After calling
this method, the host application calls your GetDefaultRect() method again to get the updated rectangle the next
time the default rectangle is needed.
Syntax
- NotifySprites(MoaLong msgCode, PMoaVoid refCon )
Parameters
- msgCode
- MoaLong
- refCon
- PMoaVoid
Returns
-
- MoaError
Description
-
Sends an arbitrary message to all currently instantiated sprite
actors. You can make up your own message code constants; refCon is used to supply any additional data.
This will result with each
of your SpriteActor's Notify() methods being called with
the msgCode and refCon you supply.
Note: Xtra developers may specify values in the range of
0 to 65535 for their notification codes. Higher values are reserved
by Adobe for future use.
Syntax
- SetModified(MoaMmModifyFlags modifyFlags)
Parameters
- modifyFlags
- MoaMmModifyFlags
Returns
- MoaError
Description
- Sets the modifyFlags for
the asset. For example, if SetProp() is called and you successfully change a property that you want
saved to disk, call this method to notify the application that
your properties need to be written out at save time.
Copyright © 1995-2008 Adobe Macromedia Software LLC, Inc.