Directory Opus Manual

User Tools

Site Tools

You are here: Introduction » Reference » Scripting Reference » Scripting Objects » BusyIndicator

Sidebar

reference:scripting_reference:scripting_objects:busyindicator

BusyIndicator

A BusyIndicator object lets you control the breadcrumbs bar busy indicator from your script.

By default a busy indicator simply indicates that something is happening; it can also be used to indicate the progress of a job (percentage complete from 0% to 100%). The user can click the spinning circle to see a description of the jobs that are running, and each job can optionally allow the user to abort it by displaying an Abort link they can click.

BusyIndicator objects are created using the DOpusFactory.BusyIndicator method. The basic steps for using one in your script are:

  1. Create the object by calling DOpus.Create.BusyIndicator().
  2. Optionally set the abort property to True to enable user aborting.
  3. Call the Init method to initialize and display the busy indicator.
  4. Call the Update method when needed to update the progress or explanatory text.
  5. Poll the abort property to check for user abort if desired.
  6. Call the Destroy method to remove the busy indicator when the job is complete.

Property Name Return Type Description

abort

bool

Before the Init method has been called, you can set this property to True to enable abort by the user (as shown above).
After Init has been called, this property will return True if the user has clicked the Abort link.
The abort property does not change if the lister or tab your BusyIndicator is associated with closes. If you need to stop when that happens then you must check for it separately, typically by testing the result of the Update method.

Method Name Arguments Return Type Description

Destroy

none

bool

Removes the busy indicator from display and destroys its internal data structures. The BusyIndicator object itself can be re-used by calling the Init method again.
Returns boolean success. Failure usually means the lister or tab was closed.

Hide

none

bool

Removes the busy indicator from display, but does not destroy its internal data. The indicator can be re-displayed by calling the Show method.
Returns boolean success. Failure usually means the lister or tab was closed.

Init

<object:window>
<string:description>
<bool:visible>

bool

Initializes a BusyIndicator object and optionally displays it.
The window parameter specifies the Lister or Tab object that the indicator is to be attached to. Using a Tab is usually best.
The optional description parameter lets you specify a text string that is displayed to the user when they click the spinning circle.
The optional visible parameter lets you make the indicator visible immediately by passing True. Alternatively, call the Show method to make the indicator visible.
Returns boolean success. Failure usually means the lister or tab was closed or invalid.

Show

none

bool

Displays the busy indicator.
Returns boolean success. Failure usually means the lister or tab was closed.

Update

<string:description>
<int:percentage>

bool

Updates the busy indicator.
The description parameter lets you specify a new description string.
The optional percentage parameter lets you specify a new progress bar percentage from 0 to 100. If no percentage is specified, and none was set by a previous call, the progress bar displays an animation indicating something is happening without a known percentage.
Returns boolean success. Failure usually means the lister or tab was closed.