A list of products available on this site
Documentation for XtraMania's xtras
Prices and links to the online store
Xtras, PDFs, samples
Have a question? Ask us!
Contacts
Logo. www.xtramaina.com  
Home Search E-mail
ActiveCompanion Usage/Wrapper objects

ActiveCompanionSet xtras for Macromedia Director

Wrapper objects

VbScriptXtra provides its basic functionality via so-called wrapper objects. Wrapper objects allow using the wrapped contents from Lingo. Wrapper object provides methods and properties accessing wrapped contents or provided by wrapped contents.

Automation object wrapper is a key component of VbScriptXtra. Wrapper object keeps the pointer to the real Automation object. When Lingo calls any method or property from wrapper object it passes it to the wrapped Automation object providing necessary type casting and error checking support. Automation object wrapper is created automatically by typecasting routines when IDispatch value is detected.
To explicitly create this wrapper use xtra-level CreateObject or GetObject method:
objAuto = xtra("VbScriptXtra").CreateObject( strProgId )

Binary data wrapper is provided by VbScriptXtra for handling binary data and Unicode texts. It is a kind of array of bytes or wide chars that could be handled by Lingo. Binary wrapper is created automatically by typecasting routines when BLOB value is detected.
To explicitly create this wrapper use xtra-level CreateWrapper method:
binaryWrapper = xtra("VbScriptXtra").CreateWrapper( #Binary )

Image wrapper is provided by VbScriptXtra as a helper to exchange image data between Director and COM applications.
To explicitly create this wrapper use xtra-level CreateWrapper method:
imageWrapper = xtra("VbScriptXtra").CreateWrapper( #Image )

Date/Time wrapper is provided by VbScriptXtra for handling date/time data. It is created automatically by typecasting routines when VB date/time value is detected. This wrapper provides standard for VB functionality for formatting date/time values and other features.
To explicitly create this wrapper use xtra-level CreateWrapper method:
dateWrapper = xtra("VbScriptXtra").CreateWrapper( #Date )

Registry key wrapper is provided by VbScriptXtra for handling operations with system Registry. It allows browsing Registry keys checking for values and subordinate keys.
To create this wrapper use xtra-level CreateWrapper method:
registryKeyWrapper = xtra("VbScriptXtra").CreateWrapper( #RegistryKey )

System helper object is provided by VbScriptXtra starting with version 2.2. It support several system-level routines.
To create this object use xtra-level CreateWrapper method:
systemObject = xtra("VbScriptXtra").CreateWrapper( #System )
It can switch keyboard layouts right in Director. It may be useful for multilingual applications when user is expected to type something in specific language.

Note: Binary, Date/Time, Registry and System wrappers are free. You may freely use them. See license agreement for details.

Further versions of VbScriptXtra might include other wrapper types as well.

Site homeSearchContact author © Eugene Shoustrov. www.xtramania.com