Using Event Handlers To Display Custom Column Content; Using Named Properties To Display Custom Column Content - Adobe GoLive CS2 Programmer's Manual

SDK Programmer's Guide
To create a basic custom column, use the
●
GoLive automatically calls the functions you register in response to events that cause the column to be
redisplayed. See
Getting data through the callback mechanism can be a time-intensive operation. For more efficient
redisplay of the Site window, you can store column data in a siteReference object, so that GoLive does
not need to use the callback mechanism to get the displayed values. A pref-type custom column can
display the value of a named property of the siteReference object. This is more efficient, and has less
impact on the display time for the Site window.
To create a pref-type column, you must first create a named custom siteReference property. Pass
●
the custom property's name to the
Using named properties to display custom column

Using event handlers to display custom column content

To display custom column content by means of the callback mechanism, you must provide handlers for
the following events:
onFileTabContentCallback: Your handler sets the column content.
●
onFileTabCompareCallback: Your handler sorts the column content.
●
The target of this event is a
When you create the column, the
When a user interacts with a custom column, the event object contains this ID information, which allows
your handler to identify the column in which the event occurred.
To facilitate data handling, GoLive sets certain global variables before calling your event-handling
functions:
Before calling your
●
available in the currentReference global variable, which it uses to pass arguments to your
methods.
Before calling the
●
available, in the referenceToCompare1 and referenceToCompare2 global variables.
These values are also accessible through the

Using named properties to display custom column content

Avoiding the use of column callbacks improves the performance of the extended site
column that gets data stored in a
callback mechanism to get the displayed values.
You can store custom column data in named properties of a
strings or numbers this way. Use the siteReference
create JavaScript properties that your custom column can retrieve by name. Pass the property's name to
the website
Using event handlers to display custom column
website
addColumn
onFileTabContentCallback
onFileTabCompareCallback
siteReference Object
Object's addPrefColumn
Adobe GoLive CS2 SDK
website Object's
website Object's addPrefColumn
content.
Object. The handler is passed a siteTabsEvent.
or insertColumn
handler, GoLive makes a siteReference object
function, GoLive makes two siteReference objects
siteTabsEvent
(a pref column), GoLive does not need to use the
setNamedString
or insertPrefColumn method when you create the column.
addColumn or insertColumn
content.
or insertPrefColumn
method returns a unique column identifier.
object that is passed to your handler.
siteReference Object. You can only display
and setNamedLong
Managing Web Sites 140
method.
method. See
tab. For a
Files
methods to