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

IMoaMmXValueUtils

Interface ID: IID_IMoaMmXValueUtils
Pointer type: PIMoaMmXValueUtils
Inheritance: IMoaUnknown
Header file: mmixval.h
Description
The IMoaMmXValueUtils interface provides conversion utilities for IMoaMmXValue elements so they can be referenced as standard objects in lingo and Javascript code.

Methods

Standard Methods
The following methods handle the conversion. s
ValueToIXValue()
IXValueToValue()
valueIsIXValue()

ValueToIXValue()

Syntax
ValueToIXValue(ConstPMoaMmValue pValue, PIMoaMmXValue * ppPropRef)
Parameters
pValue
Pointer to a standard MoaMmvalue that has an associated XValue interface.
ppPropRef
Place that will receive the interface reference if the call succeeds.
Returns
MoaError

kMoaMmErr_NotIMoaMmXValue The value passed in is not an XValue.
Description
Convert from a value containing a Lingo/Javascript reference to the actual IMoaMmXValue interface.

IXValueToValue()

Syntax
IXValueToValue(PIMoaMmXValue pPropRef, PMoaMmValue pValue)
Parameters
pPropRef
Interface associated with the XValue object.
pValue
Memory location that will receive the standard MoaMmValue for the object.
Returns
MoaError

(pValue->it==0)
means memory failure
The error result may not be properly assigned from this function, so check this field - it will be NULL for memory error.
Description
Converts an IMoaMmXValue to a Lingo value, the caller must ValueRelease() when done with it.

valueIsIXValue()

Syntax
valueIsIXValue(PMoaMmValue pValue)
Parameters
pValue
Pointer to a standard MoaMmvalue.
Returns
MoaLong

0 The value is not an IMoaMmXValue.
1 The value is an IMoaMmXValue.
Description
This method lets you find out if a lingo value is an XValue or not.

Copyright © 2004-2007 Adobe Macromedia Software LLC, Inc.