User Guide

734
xtraList
Syntax
the xtraList
Description
System property; displays a linear property list of all available Xtra extensions and their file versions.
This property is useful when the functionality of a movie depends on a certain version of an Xtra.
There are two possible properties that can appear in
XtraList:
Examples
This statement displays the xtraList in the Message window:
put the xtraList
This handler checks the version of a given Xtra:
-- This handler checks all the available Xtra extensions to return the version
of the requested Xtra
-- The XtraFileName may be only a partial match if desired
-- Use the full filename for more exact usage
-- The string returned is either the version property for the Xtra or an empty
string
-- It may be empty if either the version property doesn’t exist or the Xtra is
not found in the available list
on GetXtraVersion XtraFileName
-- Get the entire list of Xtra extensions and their information
listOfXtras = the xtraList
-- Initialize the local variable to contain the version
theVersion = ""
-- Iterate through all the Xtra extensions listed
repeat with currentXtra in listOfXtras
-- If the current Xtra’s name contains the Xtra passed in, then check for
the version
if currentXtra.name contains XtraFileName then
-- First determine if the version property exists for that Xtra
versionFlag = getaProp(currentXtra, #version)
-- If the version property is not VOID, then set the local variable
to
-- the string contained in that property value
if not voidP(versionFlag) then
theVersion = currentXtra.version
end if
end if
end repeat
-- Return the version information found or an empty string
return theVersion
end
See also
movieXtraList, getaProp
#name Specifies the filename of the Xtra on the current platform. It is possible to have a list without
a #name entry, such as when the Xtra exists only on one platform.
#version Specifies the same version number that appears in the Properties dialog box (Windows) or
Info window (Macintosh) when the file is selected on the desktop. An Xtra may not
necessarily have a version number.