Docs For Class HTML

$ajax = array()

[line 501]

Resources to handle AJAX progress meter:

See: HTML_Progress2::registerAJAX(), HTML_Progress2::setupAJAX()
Since: 2.3.0a2
Access: public

Type:

array

[ Top ]

$animSpeed =

[line 225]

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 423]

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 451]

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 325]

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 202]

Stores the event dispatcher which handles notifications

Since: 2.0.0RC2
Access: protected

Type:

array

[ Top ]

$fillWay =

[line 315]

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 404]

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 193]

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 268]

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 172]

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 481]

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 257]

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 246]

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 289]

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 491]

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 278]

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 603]

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 577]

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 1867]

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 3094]

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 714]

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 2900]

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 2238]

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 3290]

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 2314]

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 1611]

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 1386]

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 1500]

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 1332]

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 3971]

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 1282]

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 1672]

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 3050]

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 959]

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 1770]

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 891]

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 823]

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 1206]

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 1168]

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 2047]

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 2116]

string getScript(
[boolean
$raw = true], [string
$path = null])

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, HTML_PROGRESS2_ERROR_INVALID_RESOURCE
Since: 2.0.0
Access: public

Parameters:

boolean	`$raw`	—	(optional) html output with script tags or just raw data
string	`$path`	—	(optional) directory, with no trailing slash, where to get HTML_Progress2.js file

[ Top ]

getStyle [line 2372]

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 1009]

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 3955]

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 2916]

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 2482]

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 1072]

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 780]

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 737]

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 1142]

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 1097]

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 2994]

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 3933]

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 3177]

void registerAJAX(
string
$serverUrl, [array
$stub = array()], [array
$client = array('all')])

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. Use PEAR::HTML_AJAX package as backend.

Since: 2.3.0a1
Throws: HTML_PROGRESS2_ERROR_INVALID_INPUT, HTML_PROGRESS2_ERROR_INVALID_RESOURCE
Access: public

Parameters:

string	`$serverUrl`	—	the url the client should be making a request to
array	`$stub`	—	(optional) list of proxy definition for
array	`$client`	—	(optional) list of client libraries to use

[ Top ]

removeLabel [line 2012]

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 3132]

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 3018]

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 2334]

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 1651]

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 799]

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 1445]

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 1521]

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 1351]

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 1301]

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 1717]

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 3069]

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 978]

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 756]

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 1826]

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 912]

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 844]

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 1229]

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 2094]

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 2971]

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 2196]

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 ]

setupAJAX [line 3229]

string setupAJAX(
[string
$serializer = null])

Include all needed libraries, stubs, and set defaultServer

Since: 2.3.0a2
Access: public

Parameters:

string $serializer — (optional) What encoding you are going to use for serializing/unserializing data

[ Top ]

setValue [line 1029]

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 2940]

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 2611]

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 2645]

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

$ajax = array()

$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 603]

Parameters:

HTML_Progress2 (Constructor) [line 577]

Parameters:

addLabel [line 1867]

Parameters:

addListener [line 3094]

Parameters:

apiVersion [line 714]

display [line 2900]

drawCircleSegments [line 2238]

Parameters:

fileExists [line 3290]

Parameters:

getAnimSpeed [line 2314]

getBorderAttributes [line 1611]

Parameters:

getCellAttributes [line 1386]

Parameters:

getCellCoordinates [line 1500]

getCellCount [line 1332]

getError [line 3971]

getFillWay [line 1282]

getFrameAttributes [line 1672]

Parameters:

getIdent [line 3050]

getIncrement [line 959]

getLabelAttributes [line 1770]

Parameters:

getMaximum [line 891]

getMinimum [line 823]

getOrientation [line 1206]

getPercentComplete [line 1168]

Parameters:

getProgressAttributes [line 2047]

Parameters:

getScript [line 2116]

Parameters:

getStyle [line 2372]

Parameters:

getValue [line 1009]

hasErrors [line 3955]

hide [line 2916]

importStyle [line 2482]

Parameters:

incValue [line 1072]

isBorderPainted [line 780]

isIndeterminate [line 737]

moveNext [line 1142]

moveStep [line 1097]

Parameters: