Docs For Class HTML_Progress

HTML_Progress_UI (Constructor) [line 214]

HTML_Progress_UI HTML_Progress_UI(
int
$cell)

The progress bar's UI model class constructor

Constructor Summary

Creates a natural horizontal progress bar that displays ten cells/units. $html = new HTML_Progress_UI();

Creates a natural horizontal progress bar with the specified cell count, which cannot be less than 1 (minimum), but has no maximum limit. $html = new HTML_Progress_UI($cell);

Since: 1.0
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Access: public

Parameters:

int $cell — (optional) Cell count

[ Top ]

drawCircleSegments [line 1066]

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

Draw all circle segment pictures

Since: 1.2.0RC1
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Access: public

Parameters:

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

[ Top ]

getBorderAttributes [line 675]

mixed getBorderAttributes(
[bool
$asString = false])

Returns the progress bar's border attributes. Assoc array (defaut) or string.

See: HTML_Progress_UI::setBorderAttributes()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

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

[ Top ]

getCellAttributes [line 465]

mixed getCellAttributes(
[bool
$asString = false])

Returns the common and private cell attributes. Assoc array (defaut) or string

See: HTML_Progress_UI::setCellAttributes()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

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

[ Top ]

getCellCoordinates [line 571]

array getCellCoordinates(
)

Returns the coordinates of each cell for a polygonal progress shape.

Return: list of cell coordinates
See: HTML_Progress_UI::setCellCoordinates()
Since: 1.2.0
Access: public

[ Top ]

getCellCount [line 417]

integer getCellCount(
)

Returns the number of cell in the progress bar. The default value is 10.

See: HTML_Progress_UI::setCellCount()
Since: 1.0
Access: public

[ Top ]

getFillWay [line 373]

string getFillWay(
)

Returns 'natural' or 'reverse', depending of the fill way of progress bar.

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_Progress_UI::setFillWay()
Since: 1.0
Access: public

[ Top ]

getOrientation [line 304]

integer getOrientation(
)

Returns HTML_PROGRESS_BAR_HORIZONTAL or HTML_PROGRESS_BAR_VERTICAL, depending on the orientation of the progress bar.

The default orientation is HTML_PROGRESS_BAR_HORIZONTAL.

See: HTML_Progress_UI::setOrientation()
Since: 1.0
Access: public

[ Top ]

getProgressAttributes [line 794]

mixed getProgressAttributes(
[bool
$asString = false])

Returns the progress attributes. Assoc array (defaut) or string.

See: HTML_Progress_UI::setProgressAttributes()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

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

[ Top ]

getScript [line 857]

string getScript(
)

Get the javascript code to manage progress bar.

Return: JavaScript URL or inline code to manage progress bar
Author: Stefan Neufeind <pear.neufeind@speedpartner.de> Contributor. See details on thanks section of README file.
Author: Christian Wenz <wenz@php.net> Helper. See details on thanks section of README file.
See: HTML_Progress_UI::setScript()
Since: 0.5
Access: public

[ Top ]

getStringAttributes [line 730]

mixed getStringAttributes(
[bool
$asString = false])

Returns the string attributes. Assoc array (defaut) or string.

See: HTML_Progress_UI::setStringAttributes()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

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

[ Top ]

getStyle [line 981]

string getStyle(
)

Get the cascading style sheet to put inline on HTML document

Author: Stefan Neufeind <pear.neufeind@speedpartner.de> Contributor. See details on thanks section of README file.
Since: 0.2
Access: public

[ Top ]

setBorderAttributes [line 712]

void setBorderAttributes(
mixed
$attributes)

Sets the progress bar's border attributes.

Defaults are:

class = progressBarBorder
width = 0
style = solid
color = #000000

See: HTML_Progress_UI::getBorderAttributes(), HTML_Progress::setBorderPainted()
Since: 1.0
Access: public

Parameters:

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

[ Top ]

setCellAttributes [line 522]

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

Sets the cell attributes for an existing cell.

Defaults are:

Common :
- id = progressCell%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 (added for progress circle shape on release 1.2.0)
- Horizontal Bar :
  - width = 15
  - height = 20
- Vertical Bar :
  - width = 20
  - height = 15

See: HTML_Progress_UI::getCellAttributes(), HTML_Progress_UI::getCellCount()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

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

[ Top ]

setCellCoordinates [line 588]

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

Set the coordinates of each cell for a polygonal progress shape.

See: HTML_Progress_UI::getCellCoordinates()
Since: 1.2.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 433]

void setCellCount(
integer
$cells)

Sets the number of cell in the progress bar

See: HTML_Progress_UI::getCellCount()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

integer $cells — Cell count on progress bar

[ Top ]

setFillWay [line 390]

void setFillWay(
string
$way)

Sets the progress bar's fill way, which must be 'natural' or 'reverse'.

The default fill way is 'natural'.

See: HTML_Progress_UI::getFillWay()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

string $way — fill direction (natural or reverse)

[ Top ]

setOrientation [line 322]

void setOrientation(
integer
$orient)

Sets the progress bar's orientation, which must be HTML_PROGRESS_BAR_HORIZONTAL or HTML_PROGRESS_BAR_VERTICAL.

The default orientation is HTML_PROGRESS_BAR_HORIZONTAL.

See: HTML_Progress_UI::getOrientation()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

integer $orient — Orientation (horizontal or vertical)

[ Top ]

setProgressAttributes [line 840]

void setProgressAttributes(
mixed
$attributes)

Sets the common progress bar attributes.

Defaults are:

class = progressBar
background-color = #FFFFFF
auto-size = true
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_Progress_UI::getProgressAttributes()
Since: 1.0
Access: public

Parameters:

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

[ Top ]

setScript [line 945]

void setScript(
string
$url)

Set the external JavaScript code (file) to manage progress element.

See: HTML_Progress_UI::getScript()
Throws: HTML_PROGRESS_ERROR_INVALID_INPUT
Since: 1.0
Access: public

Parameters:

string $url — URL to the linked Progress JavaScript

[ Top ]

setStringAttributes [line 778]

void setStringAttributes(
mixed
$attributes)

Sets the string attributes.

Defaults are:

id = installationProgress
width = 50
font-family = Verdana, Arial, Helvetica, sans-serif
font-size = 12
color = #000000
background-color = #FFFFFF
align = right
Horizontal Bar :
- valign = right
Vertical Bar :
- valign = bottom

See: HTML_Progress_UI::getStringAttributes(), HTML_Progress::setStringPainted()
Since: 1.0
Access: public

Parameters:

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

[ Top ]

Class: HTML_Progress_UI

Class Overview

Author(s):

Version:

Copyright:

Methods

Child classes:

Inherited Variables

Inherited Methods

Class Details

Method Detail

HTML_Progress_UI (Constructor) [line 214]

Parameters:

drawCircleSegments [line 1066]

Parameters:

getBorderAttributes [line 675]

Parameters:

getCellAttributes [line 465]

Parameters:

getCellCoordinates [line 571]

getCellCount [line 417]

getFillWay [line 373]

getOrientation [line 304]

getProgressAttributes [line 794]

Parameters:

getScript [line 857]

getStringAttributes [line 730]

Parameters:

getStyle [line 981]

setBorderAttributes [line 712]

Parameters:

setCellAttributes [line 522]

Parameters:

setCellCoordinates [line 588]

Parameters:

setCellCount [line 433]

Parameters:

setFillWay [line 390]

Parameters:

setOrientation [line 322]

Parameters:

setProgressAttributes [line 840]

Parameters:

setScript [line 945]

Parameters:

setStringAttributes [line 778]

Parameters: