Legacy Mac OS X Reference Library Apple Developer Connection

WOCompletionBar

The WOCompletionBar component displays a progress bar on a page. You might use WOCompletionBar in the status page of your long-running action (see the WOLongResponsePage Class).

Synopsis

WOCompletionBar { valueMin=aNumber; valueMax=aNumber; [value=aNumber;]

[numberformat=numberFormatString;] [barColor=hexString;]

[backgroundColor=hexString;] [width=aNumber;] [border=aString;] [align=aString;] };

Bindings

valueMin

Minimum value for the bar or value at which the bar begins.

valueMax

Maximum value for the bar or value at which the bar ends.

value

The current amount completed. The bar sizes to this number and displays the number inside itself. The value must be between valueMin and valueMax.

numberformat

A format string that specifies how value should be formatted as a number. If a number format is used, value must be assigned an NSNumber object. If the value can’t be interpreted according to the format you specify, the value is set to null. See the NSNumberFormatter class specification for a description of the number format syntax.

barColor

Color for showing the value. That is, this color shows the amount completed.

backgroundColor

Color for the uncompleted portion.

width

Width of the bar. This attribute is passed directly to the HTML TABLE that makes up the bar.

border

Thickness of the bar’s border in pixels. This attribute is passed directly to the HTML TABLE that makes up the bar.

align

Alignment of the displayed number within the completed portion of the bar. This attribute is passed directly to the HTML FONT specification for the number.



Last updated: 2004-12-02

Did this document help you? Yes It's good, but... Not helpful...