Docs For Class HTML

$animSpeed =

[line 234]

Delay in millisecond before each progress cells display.

1000 ms === sleep(1) <strong>usleep()</strong> function does not run on Windows platform.

See: HTML_Progress2::setAnimSpeed()
Since: 2.0.0
Access: public

Type:

integer

[ Top ]

$border = array()

[line 432]

Progress bar border properties

 $border = array(

    'class' => 'progressBorder%s',    # css class selector
    'width' => 0,                     # width size in pixel
    'style' => 'solid',               # style (solid, dashed, dotted ...)
    'color' => '#000000'              # color
 );

See: HTML_Progress2::getBorderAttributes(), HTML_Progress2::setBorderAttributes()
Since: 2.0.0
Access: public

Type:

array

[ Top ]

$cell = array()

[line 460]

Progress bar cells properties

 $cell = array(

    'class' => 'cell%s',                   # css class selector
    'active-color' => '#006600',           # active color
    'inactive-color' => '#CCCCCC',         # inactive color
    'font-family' => 'Courier, Verdana',   # font family
    'font-size' => 8,                      # font size
    'color' => '#000000',                  # foreground color
    'background-color' => '#FFFFFF',       # background color
    'background-image' => 'none',          # cell background image
    'background-repeat' => 'no-repeat',    # cell background image repeat option
    'background-position' => 'top left',   # cell background image start position
    'width' => 15,                         # cell width
    'height' => 20,                        # cell height
    'spacing' => 2                         # cell spacing
 );

See: HTML_Progress2::getCellAttributes(), HTML_Progress2::setCellAttributes()
Since: 2.0.0
Access: public

Type:

array

[ Top ]

$cellCount =

[line 334]

The cell count of the progress bar. The default is 10.

See: HTML_Progress2::getCellCount(), HTML_Progress2::setCellCount()
Since: 2.0.0
Access: public

Type:

integer

[ Top ]

$dispatcher =

[line 211]

Stores the event dispatcher which handles notifications

Since: 2.0.0RC2
Access: protected

Type:

array

[ Top ]

$fillWay =

[line 324]

Whether the progress bar is filled in 'natural' or 'reverse' way.

The default fill way is 'natural'.

'way' = bar fill way
- with Progress Bar Horizontal, natural way is : left to right
  reverse way is : right to left
- with Progress Bar Vertical, natural way is : down to up
  reverse way is : up to down
- with Progress Circle or Polygonal, natural way is : clockwise
  reverse way is : anticlockwise

See: HTML_Progress2::getFillWay(), HTML_Progress2::setFillWay()
Since: 2.0.0
Access: public

Type:

string

[ Top ]

$frame = array()

[line 413]

Progress bar frame properties

 $frame = array(

    'show' => false,      # frame show (true/false)
    'left' => 200,        # position from left
    'top' => 100,         # position from top
    'width' => 320,       # width
    'height' => 90,       # height
    'color' => '#C0C0C0', # color
    'border-width' => 2,                                   # border width
    'border-style' => 'solid',                             # border style
                                                           # (solid, dashed, dotted ...)
    'border-color' => '#DFDFDF #404040 #404040 #DFDFDF'    # border color (3dfx)
 );

See: HTML_Progress2::getFrameAttributes(), HTML_Progress2::setFrameAttributes()
Since: 2.0.0
Access: public

Type:

array

[ Top ]

$ident =

[line 202]

The label that uniquely identifies this progress object.

See: HTML_Progress2::getIdent(), HTML_Progress2::setIdent()
Since: 2.0.0
Access: public

Type:

string

[ Top ]

$increment =

[line 277]

The progress bar's increment value.

The default is +1.

See: HTML_Progress2::getIncrement(), HTML_Progress2::setIncrement()
Since: 2.0.0
Access: public

Type:

integer

[ Top ]

$indeterminate =

[line 181]

Whether the progress bar is in determinate or indeterminate mode.

The default is false. An indeterminate progress bar continuously displays animation indicating that an operation of unknown length is occuring.

See: HTML_Progress2::setIndeterminate(), HTML_Progress2::isIndeterminate()
Since: 2.0.0
Access: public

Type:

boolean

[ Top ]

$label = array()

[line 490]

Progress bar labels properties

 $label = array(

    'name' => array(                  # label name
      'type' => 'text',               # label type
                                      # (text,button,step,percent,crossbar)
      'value' => '&nbsp;',            # label value
      'left' => ($left),              # label position from left
      'top' => ($top - 16),           # label position from top
      'width' => 0,                   # label width
      'height' => 0,                  # label height
      'align' => 'left',              # label align
      'background-color' => 'transparent',          # label background color
      'font-family' => 'Verdana, Tahoma, Arial',    # label font family
      'font-size' => 11,                            # label font size
      'font-weight' => 'normal',                    # label font weight
      'color' => '#000000',                         # label font color
      'class' => 'progressPercentLabel%s'           # css class selector
 );

See: HTML_Progress2::getLabelAttributes(), HTML_Progress2::setLabelAttributes()
Since: 2.0.0
Access: public

Type:

array

[ Top ]

$maximum =

[line 266]

The progress bar's maximum value.

The default is 100.

See: HTML_Progress2::getMaximum(), HTML_Progress2::setMaximum()
Since: 2.0.0
Access: public

Type:

integer

[ Top ]

$minimum =

[line 255]

The progress bar's minimum value.

The default is 0.

See: HTML_Progress2::getMinimum(), HTML_Progress2::setMinimum()
Since: 2.0.0
Access: public

Type:

integer

[ Top ]

$orientation =

[line 298]

Whether the progress bar is horizontal, vertical, polygonal or circle.

The default is horizontal.

See: HTML_Progress2::getOrientation(), HTML_Progress2::setOrientation()
Since: 2.0.0
Access: public

Type:

integer

[ Top ]

$script =

[line 500]

External Javascript file to override internal default code

See: HTML_Progress2::getScript(), HTML_Progress2::setScript()
Since: 2.0.0
Access: public

Type:

string

[ Top ]

$value =

[line 287]

The progress bar's current value.

See: HTML_Progress2::getValue(), setvalue(), HTML_Progress2::incValue()
Since: 2.0.0
Access: public

Type:

integer

[ Top ]

__construct (Constructor) [line 602]

HTML_Progress2 __construct(
[array
$errorPrefs = array()], [int
$orient = HTML_PROGRESS2_BAR_HORIZONTAL], [int
$min = 0], [int
$max = 100], [mixed
$percentLabel = 'pct1'])

Constructor (ZE2) Summary

Creates a natural horizontal progress bar that displays ten separated cells with no border and only percent label. The initial and minimum values are 0, and the maximum is 100.

See: HTML_Progress2::setIndeterminate(), HTML_Progress2::setIdent(), HTML_Progress2::setAnimSpeed(), HTML_Progress2::setOrientation(), HTML_Progress2::setMinimum(), HTML_Progress2::setMaximum(), HTML_Progress2::addLabel()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: protected

Parameters:

array	`$errorPrefs`	—	(optional) Hash of params to configure error handler
int	`$orient`	—	(optional) Orientation of progress bar
int	`$min`	—	(optional) Minimum value of progress bar
int	`$max`	—	(optional) Maximum value of progress bar
mixed	`$percentLabel`	—	(optional) Progress bar percent label id.

[ Top ]

HTML_Progress2 (Constructor) [line 576]

HTML_Progress2 HTML_Progress2(
[
$errorPrefs = array()], [
$orient = HTML_PROGRESS2_BAR_HORIZONTAL], [
$min = 0], [
$max = 100], [
$percentLabel = 'pct1'])

Constructor (ZE1)

Since: 2.0.0
Access: public

Parameters:

	`$errorPrefs`	—
	`$orient`	—
	`$min`	—
	`$max`	—
	`$percentLabel`	—

[ Top ]

addLabel [line 1866]

void addLabel(
string
$type, string
$name, [string
$value = '&nbsp;'])

Add a new label to the progress meter.

Defines a new label identifier choosen between five categories:

HTML_PROGRESS2_LABEL_TEXT constant if you want a simple text zone
HTML_PROGRESS2_LABEL_BUTTON constant if you want a form button
HTML_PROGRESS2_LABEL_STEP constant if you want a step resume progress
HTML_PROGRESS2_LABEL_PERCENT constant if you want current progress value
HTML_PROGRESS2_LABEL_CROSSBAR constant if you want a little javascript animation

See: HTML_Progress2::setLabelAttributes(), HTML_Progress2::removeLabel()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

string	`$type`	—	Label type (text,button,step,percent,crossbar)
string	`$name`	—	Label name
string	`$value`	—	(optional) default label value

[ Top ]

addListener [line 3129]

void addListener(
mixed
$callback, [string
$nName = EVENT_DISPATCHER_GLOBAL])

Attachs a new observer.

Adds a new observer to the Event Dispatcher that will listen for all messages emitted by this HTML_Progress2 instance.

See: HTML_Progress2::removeListener()
Throws: HTML_PROGRESS2_ERROR_INVALID_CALLBACK, HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

mixed	`$callback`	—	PHP callback that will act as listener
string	`$nName`	—	Expected notification name, serves as a filter

[ Top ]

apiVersion [line 713]

string apiVersion(
)

Returns the current API version.

This function return a "PHP-standardized" version number string. This is useful if you would like to write programs working only on some versions of HTML_Progress2. See also php version_compare() function.

Link: http://www.php.net/manual/en/function.version-compare.php
Since: 2.0.0
Access: public

[ Top ]

display [line 2935]

void display(
)

Renders the new value of progress meter.

This method should be used only to display initial state of the progress meter. Next steps to refresh display must use either moveStep() or moveNext() methods.

Since: 2.0.0
Access: public

[ Top ]

drawCircleSegments [line 2273]

array drawCircleSegments(
[string
$dir = '.'], [string
$fileMask = 'c%s.png'])

Draw all circle segment pictures.

This function build/prepare all circle segment PNG pictures that will be send to browser output. Requires PEAR::Image_Color and PHP:gd extension.

See: HTML_Progress2::setCellAttributes()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

string	`$dir`	—	(optional) Directory where pictures should be created
string	`$fileMask`	—	(optional) sprintf format for pictures filename

[ Top ]

fileExists [line 3264]

bool fileExists(
string
$fileName)

Checks whether the file exists in the include path

Method used to check if a file (Ajax engine driver) is available and readable.

Since: 2.3.0a1
Access: protected

Parameters:

string $fileName — file name

[ Top ]

getAnimSpeed [line 2349]

integer getAnimSpeed(
)

Returns delay execution of the progress meter.

Given a delay in process of the progress meter is only necessary if you need demonstration or also smooth animation. The default value is zero (no delay).

See: HTML_Progress2::setAnimSpeed()
Since: 2.0.0
Access: public

[ Top ]

getBorderAttributes [line 1610]

mixed getBorderAttributes(
[bool
$asString = false])

Returns progress bar's border attributes values.

Get all border attributes in a associative array with key-value couple (by default). Get the attributes as string is also possible.

See: HTML_Progress2::setBorderAttributes()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

bool $asString — (optional) whether to return the attributes as string

[ Top ]

getCellAttributes [line 1385]

mixed getCellAttributes(
[bool
$asString = false])

Returns cell attributes values.

Get all cell attributes in a associative array with key-value couple (by default). Get the attributes as string is also possible.

See: HTML_Progress2::setCellAttributes()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

bool $asString — (optional) whether to return the attributes as string

[ Top ]

getCellCoordinates [line 1499]

array getCellCoordinates(
)

Returns coordinates of each cell for a polygonal progress meter.

Get array of all cell coordinates (x,y) that define a polygonal progress meter. For example, a 3x3 square as: (0,0) for top left corner, (2,0) for top right corner, (2,2) for bottom right corner, and (0,2) for bottom left corner.

See: HTML_Progress2::setCellCoordinates()
Since: 2.0.0
Access: public

[ Top ]

getCellCount [line 1331]

integer getCellCount(
)

Returns count of cell in the progress meter.

Get the number of cell defined to a progress meter. It must be positive. The default value is 10.

See: HTML_Progress2::setCellCount()
Since: 2.0.0
Access: public

[ Top ]

getError [line 3945]

false|array|PEAR_Error getError(
)

Pop an error off of the HTML_Progress2 stack.

Get all error data (code, message, level, context) from an object (PEAR_Error, ...) or a simple php array.

See: HTML_Progress2::hasErrors(), HTML_Progress2::raiseError()
Since: 2.0.0
Access: public

[ Top ]

getFillWay [line 1281]

string getFillWay(
)

Returns fill option of the progress meter.

Get 'natural' or 'reverse', depending of the fill way of progress meter. For horizontal progress bar, natural way is from left to right, and reverse way is from right to left. For vertical progress bar, natural way is from down to up, and reverse way is from up to down. The default fill way is 'natural'.

See: HTML_Progress2::setFillWay()
Since: 2.0.0
Access: public

[ Top ]

getFrameAttributes [line 1671]

mixed getFrameAttributes(
[bool
$asString = false])

Returns frame attributes values.

Get all frame attributes in a associative array with key-value couple (by default). Get the attributes as string is also possible.

See: HTML_Progress2::setFrameAttributes()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

bool $asString — (optional) whether to return the attributes as string

[ Top ]

getIdent [line 3085]

string getIdent(
)

Returns the progress meter identifier.

Each progress meter has its own identifier. That allows to display more than only once meter at same time on same page.

See: HTML_Progress2::setIdent()
Since: 2.0.0
Access: public

[ Top ]

getIncrement [line 958]

integer getIncrement(
)

Returns the progress meter increment value.

Get step of progress property of a progress meter. The default value is +1.

See: HTML_Progress2::setIncrement()
Since: 2.0.0
Access: public

[ Top ]

getLabelAttributes [line 1769]

mixed getLabelAttributes(
string
$name, [bool
$asString = false])

Returns attributes values of an existing label.

Get all attributes of an existing label identified by $name argument. This identifier must be the same as the one given to addLabel() method. Return attributes values in a associative array with key-value couple (by default). Get the attributes as string is also possible.

See: HTML_Progress2::setLabelAttributes()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

string	`$name`	—	progress label id.
bool	`$asString`	—	(optional) whether to return the attributes as string

[ Top ]

getMaximum [line 890]

integer getMaximum(
)

Returns the progress meter maximum value.

Get the maximum value at which the progress meter will stop. The default value is 100 and can't be less than minimum.

See: HTML_Progress2::setMaximum()
Since: 2.0.0
Access: public

[ Top ]

getMinimum [line 822]

integer getMinimum(
)

Returns the progress meter minimum value.

Get the minimum value at which the progress meter will start. The default value is zero and can't be negative.

See: HTML_Progress2::setMinimum()
Since: 2.0.0
Access: public

[ Top ]

getOrientation [line 1205]

integer getOrientation(
)

Returns orientation of the progress bar.

There are only two distinct orientations for a progress bar: horizontal and vertical, identified by two constants: HTML_PROGRESS2_BAR_HORIZONTAL and HTML_PROGRESS2_BAR_VERTICAL. While circle and other polygonal progress meter are identified by two other constants: HTML_PROGRESS2_CIRCLE and HTML_PROGRESS2_POLYGONAL. The default orientation is horizontal.

See: HTML_Progress2::setOrientation()
Since: 2.0.0
Access: public

[ Top ]

getPercentComplete [line 1167]

float getPercentComplete(
[boolean
$float = true])

Returns the percent complete of the progress meter.

Note that this number is between 0.00 and 1.00 when $float = true. And this number is between 0 and 100 when $float = false.

See: HTML_Progress2::getValue(), HTML_Progress2::getMaximum()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

boolean $float — (optional) float or integer format

[ Top ]

getProgressAttributes [line 2046]

mixed getProgressAttributes(
[bool
$asString = false])

Returns the progress background attributes values.

Get all background attributes in a associative array with key-value couple (by default). Get the attributes as string is also possible.

See: HTML_Progress2::setProgressAttributes()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

bool $asString — (optional) whether to return the attributes as string

[ Top ]

getScript [line 2112]

string getScript(
[boolean
$raw = true])

Returns javascript progress meter handler.

Get the javascript URL or inline code that will handle the progress meter refresh.

See: HTML_Progress2::setScript()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

boolean $raw — (optional) html output with script tags or just raw data

[ Top ]

getStyle [line 2407]

string getStyle(
[boolean
$raw = true])

Returns the cascading style sheet (CSS).

Get the CSS required to display the progress meter in a HTML document.

Since: 2.0.0
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Access: public

Parameters:

boolean $raw — (optional) html output with script tags or just raw data

[ Top ]

getValue [line 1008]

integer getValue(
)

Returns the progress meter current value.

Get the current value of the progress meter that is always between the minimum and maximum values, inclusive. The default value is equal to minimum.

See: HTML_Progress2::setValue(), HTML_Progress2::incValue()
Since: 2.0.0
Access: public

[ Top ]

hasErrors [line 3929]

integer hasErrors(
)

Determine whether there are errors into the HTML_Progress2 stack.

This function gave you ability to be aware of API errors presence in user scripts.

See: HTML_Progress2::getError(), HTML_Progress2::raiseError()
Since: 2.0.0
Access: public

[ Top ]

hide [line 2951]

void hide(
)

Hides the progress meter.

Once the process is over this method provides a solution to remove/hide the progress meter of the browser screen.

Since: 2.0.0
Access: public

[ Top ]

importStyle [line 2517]

void|PEAR_Error importStyle(
mixed
$styles)

Import cascading style sheet (CSS) elements

Set the CSS required to display the progress meter in a HTML document.

Since: 2.2.0
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Access: public

Parameters:

mixed $styles — CSS elements reference to import

[ Top ]

incValue [line 1071]

void incValue(
)

Updates the internal progress meter current value.

The new current value is equal to previous value increase by increment value. All listeners are notified. See also moveNext() method if you want a refresh display too.

See: HTML_Progress2::getValue(), HTML_Progress2::setValue(), HTML_Progress2::moveNext()
Since: 2.0.0
Access: public

[ Top ]

isBorderPainted [line 779]

boolean isBorderPainted(
)

Determines whether the progress bar border is painted or not.

By default, each progress bar (horizontal, vertical) has no border. This function gave ability to know if you've already set a border (return TRUE), or not (return FALSE).

See: HTML_Progress2::setBorderPainted()
Since: 2.0.0
Access: public

[ Top ]

isIndeterminate [line 736]

boolean isIndeterminate(
)

Returns mode of the progress meter.

There are two types of progress meters: determinate and undeterminate.

Determinate progress meters are used when you know the length of time that an operation will take. The progress meter will fill up and, once full, the operation should be finished.

Undeterminate progress meters are used when you do not know the length of time of an operation. The progress meter will have an animation such a sliding box.

See: HTML_Progress2::setIndeterminate()
Since: 2.0.0
Access: public

[ Top ]

moveNext [line 1141]

void moveNext(
)

Changes new value of the progress meter by increment increase.

Move current value to the next value of the progress meter defined by its increment. If result value is different than previous, then all listeners are notified.

See: HTML_Progress2::moveStep()
Since: 2.0.0
Access: public

[ Top ]

moveStep [line 1096]

void moveStep(
integer
$step)

Changes new value of the progress meter by step increase.

Move current value to the next step of the progress meter defined by its increment. If result value is different than previous, then all listeners are notified. Caution: a step is always between 1 and (maximum / taskcount) rounded fractions up.

See: HTML_Progress2::moveNext()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer $step — new step value

[ Top ]

process [line 3029]

mixed process(
)

Performs the progress user process.

This function call the user-specified progress function, defined by setProgressHandler() method. Default callback is the HTML_Progress2::sleep() method.

See: HTML_Progress2::sleep(), HTML_Progress2::setProgressHandler()
Since: 2.0.0
Access: public

[ Top ]

raiseError [line 3907]

mixed raiseError(
)

A basic wrapper around the default PEAR_Error object.

This method throws any internal API error that could be raised due to a wrong programming. It will use your error handler system defined at class construction (by first argument).

See: _errorHandler()
Since: 2.0.0
Access: public

[ Top ]

registerAjax [line 3211]

object|false registerAjax(
[string
$engine = 'StdDOMxml'])

Until version 2.2.0 Progress2 has only COMET (streaming) ability. With first alpha of 2.3.0 version, Progress2 has now Ajax (polling) ability. A default driver is available and you may register your own Ajax engine easily.

Return: instance of HTML_Progress2_Ajax_Common, false on error
Since: 2.3.0a1
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT, HTML_PROGRESS2_ERROR_INVALID_RESOURCE
Access: public

Parameters:

string $engine — (optional) Ajax engine driver name

[ Top ]

removeLabel [line 2011]

void removeLabel(
string
$name)

Removes a label to the progress meter.

The label identifier must exists or it cannot be remove. This is the same identifier as the one given to addLabel() method.

See: HTML_Progress2::addLabel()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

string $name — Label name

[ Top ]

removeListener [line 3167]

bool removeListener(
mixed
$callback, [string
$nName = EVENT_DISPATCHER_GLOBAL])

Removes a registered observer.

Detachs a previously registered observer and remove the Event Dispatcher if there is no more observer registered.

Return: True if observer was removed, false otherwise
See: HTML_Progress2::addListener()
Throws: HTML_PROGRESS2_ERROR_INVALID_CALLBACK, HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

mixed	`$callback`	—	PHP callback that act as listener
string	`$nName`	—	Expected notification name, serves as a filter

[ Top ]

run [line 3053]

void run(
)

Runs the progress meter.

This function accept both modes: indeterminate and determinate, and execute all actions defined in the user callback identified by setProgressHandler() method.

All observers are also notified of main changes (start, stop meter).

See: HTML_Progress2::process(), HTML_Progress2::setProgressHandler()
Since: 2.0.0
Access: public

[ Top ]

setAnimSpeed [line 2369]

void setAnimSpeed(
integer
$delay)

Sets delay execution of the progress meter.

The delay (in millisecond) cannot exceed 1000 (1 second), that is enough to smooth an animation. User process should slow down animation and in most case the default value (zero) will be efficient.

See: HTML_Progress2::getAnimSpeed()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer $delay — Delay in millisecond.

[ Top ]

setBorderAttributes [line 1650]

void setBorderAttributes(
mixed
$attributes)

Sets the progress bar's border attributes.

Defines all border attributes (color, size, ...) a progress bar (only horizontal or vertical) can handle.

Defaults are:

class = progressBorder%s
width = 0
style = solid
color = #000000

See: HTML_Progress2::getBorderAttributes()
Since: 2.0.0
Access: public

Parameters:

mixed $attributes — Associative array or string of HTML tag attributes

[ Top ]

setBorderPainted [line 798]

void setBorderPainted(
boolean
$paint)

Decides to paint or not a border to the progress bar.

This function gave ability to set ($paint = TRUE) or remove ($paint = FALSE) a border to the current progress bar.

See: HTML_Progress2::isBorderPainted()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

boolean $paint — whether the progress bar should paint its border

[ Top ]

setCellAttributes [line 1444]

void setCellAttributes(
mixed
$attributes, [int
$cell = null])

Sets cell attributes values.

Sets cell attributes for all cells (default) or a specific an existing cell.

Defaults are:

id = pcel%01s
class = cell
spacing = 2
active-color = #006600
inactive-color = #CCCCCC
font-family = Courier, Verdana
font-size = lowest value from cell width, cell height, and font size
color = #000000
background-color = #FFFFFF
background-image = none
background-repeat = no-repeat
background-position = top left
Horizontal Bar :
- width = 15
- height = 20
Vertical Bar :
- width = 20
- height = 15

See: HTML_Progress2::getCellAttributes()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

mixed	`$attributes`	—	Associative array or string of HTML tag attributes
int	`$cell`	—	(optional) Cell index

[ Top ]

setCellCoordinates [line 1520]

void setCellCoordinates(
integer
$xgrid, integer
$ygrid, [array
$coord = array()])

Sets coordinates of each cell for a polygonal progress meter.

A polygonal progress meter is defined by its size (width, height) and its cells coordinates (array of couple x,y screen coordinates).

See: HTML_Progress2::getCellCoordinates()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer	`$xgrid`	—	The grid width in cell size
integer	`$ygrid`	—	The grid height in cell size
array	`$coord`	—	(optional) Coordinates (x,y) in the grid, of each cell

[ Top ]

setCellCount [line 1350]

void setCellCount(
integer
$cells)

Sets count of cell in the progress meter.

Defines the number of cell to a progress meter. It must be positive. The default value is 10.

See: HTML_Progress2::getCellCount()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer $cells — Cell count on progress meter

[ Top ]

setFillWay [line 1300]

void setFillWay(
string
$way)

Sets fill option of the progress meter.

Sets the progress meter fill option: must be 'natural' or 'reverse'. The default fill way is 'natural'.

See: HTML_Progress2::getFillWay()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

string $way — fill direction (natural or reverse)

[ Top ]

setFrameAttributes [line 1716]

void setFrameAttributes(
[null|array
$attributes = array()])

Sets the progress meter frame attributes.

Allows to build a customisable frame (color, size) around the progress meter.

Defaults are:

show = true
left = 200
top = 100
width = 320
height = 90
color = #C0C0C0
border-width = 2
border-style = solid
border-color = #DFDFDF #404040 #404040 #DFDFDF

Since: 2.0.0
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT, HTML_PROGRESS2_ERROR_INVALID_OPTION
Access: public

Parameters:

null|array $attributes — (optional) hash of style parameters

[ Top ]

setIdent [line 3104]

void setIdent(
[mixed
$ident = null])

Sets the progress meter identifier.

Each progress meter has its own identifier. That allows to display more than only once meter at same time on same page. If no identification string is given, then the default identifier will be six first characters of md5 hash value of the current unix timestamp.

See: HTML_Progress2::getIdent()
Since: 2.0.0
Access: public

Parameters:

mixed $ident — (optional) the new identification string.

[ Top ]

setIncrement [line 977]

void setIncrement(
integer
$inc)

Sets the progress meter increment value.

Defines step of progress property of a progress meter. Allows to ajust default value (+1).

See: HTML_Progress2::getIncrement()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer $inc — progress meter's increment value

[ Top ]

setIndeterminate [line 755]

void setIndeterminate(
boolean
$continuous)

Sets the mode of progress meter.

Default progress meters are in determinate mode ($continuous = TRUE), but can be switched anytime in indeterminate mode ($continuous = FALSE).

See: HTML_Progress2::isIndeterminate()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

boolean $continuous — whether countinuously displays animation

[ Top ]

setLabelAttributes [line 1825]

void setLabelAttributes(
string
$name, mixed
$attributes)

Sets attributes values of an existing label.

Defines attributes (font, color, size, alignement ...) of an existing label. Whether an attribute is not specified, previous or default value is used instead.

Defaults are:

class = progressPercentLabel%s
width = 50
height = 0
font-size = 11
font-family = Verdana, Tahoma, Arial
font-weight = normal
color = #000000
background-color = transparent
align = right
valign = right

See: HTML_Progress2::getLabelAttributes(), HTML_Progress2::addLabel()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

string	`$name`	—	progress label id.
mixed	`$attributes`	—	Associative array or string of HTML tag attributes

[ Top ]

setMaximum [line 911]

void setMaximum(
integer
$max)

Sets the progress meter maximum value.

Set the maximum value at which the progress meter will stop. The default value is 100 and can't be less than minimum. If the new maximum is different than previous value, all listeners are notified.

See: HTML_Progress2::getMaximum()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer $max — progress meter's maximal value

[ Top ]

setMinimum [line 843]

void setMinimum(
integer
$min)

Sets the progress meter minimum value.

Set the minimum value at which the progress meter will start. The default value is zero and can't be negative. If the new minimum is different than previous value, all listeners are notified.

See: HTML_Progress2::getMinimum()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer $min — progress meter's minimal value

[ Top ]

setOrientation [line 1228]

void setOrientation(
integer
$orient)

Sets orientation of the progress bar.

See: HTML_Progress2::getOrientation()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer $orient — Orientation (horizontal or vertical)

[ Top ]

setProgressAttributes [line 2093]

void setProgressAttributes(
mixed
$attributes)

Sets the progress background attributes values.

Background attributes are color and size, with default values:

background-color = #FFFFFF
background-image = none
background-repeat = no-repeat
background-position = top left
Horizontal Bar :
- width = (cell_count * (cell_width + cell_spacing)) + cell_spacing
- height = cell_height + (2 * cell_spacing)
Vertical Bar :
- width = cell_width + (2 * cell_spacing)
- height = (cell_count * (cell_height + cell_spacing)) + cell_spacing

See: HTML_Progress2::getProgressAttributes()
Since: 2.0.0
Access: public

Parameters:

mixed $attributes — Associative array or string of HTML tag attributes

[ Top ]

setProgressHandler [line 3006]

void setProgressHandler(
mixed
$handler)

Sets the user progress callback function.

The process() function will call the user-callback defined here by this setProgressHandler() method.

The user-supplied progress function must return either positive for a step progression, using moveStep() method, or NULL for a standard progression, using moveNext() method.

See: HTML_Progress2::process()
Throws: HTML_PROGRESS2_ERROR_INVALID_CALLBACK
Since: 2.0.0
Access: public

Parameters:

mixed $handler — Name of function or a class-method.

[ Top ]

setScript [line 2231]

void setScript(
string
$url)

Sets the javascript progress meter handler.

Defines the javascript source (URL or inline code) that will handle the progress meter refresh.

See: HTML_Progress2::getScript()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

string $url — URL to the linked Progress JavaScript

[ Top ]

setValue [line 1028]

void setValue(
integer
$val)

Sets the progress meter current value.

Set the current value of the progress meter that is always between the minimum and maximum values, inclusive. If the new value is different from previous, then all listeners are notified.

See: HTML_Progress2::getValue(), HTML_Progress2::incValue()
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT
Since: 2.0.0
Access: public

Parameters:

integer $val — progress meter's current value

[ Top ]

sleep [line 2975]

void sleep(
)

Delay execution.

The HTML_Progress2::sleep() function delays program execution for the given number of milliseconds. This is the default user callback when none are defined.

NOTE: The function http://www.php.net/manual/en/function.usleep.php did not work on Windows systems until PHP 5.0.0

See: HTML_Progress2::getAnimSpeed(), HTML_Progress2::setAnimSpeed(), HTML_Progress2::process()
Since: 2.0.0
Access: public

[ Top ]

toArray [line 2646]

array toArray(
)

Returns the progress meter structure into an array.

Get all progress meter properties, couple key-value, into a php array. This structure is read-only, a dump-like information.

Since: 2.0.0
Access: public

[ Top ]

toHtml [line 2680]

string toHtml(
)

Returns the progress meter structure as HTML.

Get html code required to display the progress meter in any html document.

Since: 2.0.0
Access: public

[ Top ]

Class: HTML_Progress2

Class Overview

Author(s):

Version:

Copyright:

Variables

Methods

Inherited Variables

Inherited Methods

Class Details

Class Variables

$animSpeed =

$border = array()

$cell = array()

$cellCount =

$dispatcher =

$fillWay =

$frame = array()

$ident =

$increment =

$indeterminate =

$label = array()

$maximum =

$minimum =

$orientation =

$script =

$value =

Method Detail

__construct (Constructor) [line 602]

Parameters:

HTML_Progress2 (Constructor) [line 576]

Parameters:

addLabel [line 1866]

Parameters:

addListener [line 3129]

Parameters:

apiVersion [line 713]

display [line 2935]

drawCircleSegments [line 2273]

Parameters:

fileExists [line 3264]

Parameters:

getAnimSpeed [line 2349]

getBorderAttributes [line 1610]

Parameters:

getCellAttributes [line 1385]

Parameters:

getCellCoordinates [line 1499]

getCellCount [line 1331]

getError [line 3945]

getFillWay [line 1281]

getFrameAttributes [line 1671]

Parameters:

getIdent [line 3085]

getIncrement [line 958]

getLabelAttributes [line 1769]

Parameters:

getMaximum [line 890]

getMinimum [line 822]

getOrientation [line 1205]

getPercentComplete [line 1167]

Parameters:

getProgressAttributes [line 2046]

Parameters:

getScript [line 2112]

Parameters:

getStyle [line 2407]

Parameters:

getValue [line 1008]

hasErrors [line 3929]

hide [line 2951]

importStyle [line 2517]

Parameters:

incValue [line 1071]

isBorderPainted [line 779]

isIndeterminate [line 736]

moveNext [line 1141]

moveStep [line 1096]

Parameters:

process [line 3029]