Class DisplayValue

(Defined in: jpgraph.php : 4959)

DisplayValue

ApplyFont()
HideZero()
SetAlign()
SetAngle()
SetColor()
SetFont()
SetFormat()
SetFormatCallback()
SetMargin()
Show()
__construct()

Class usage and Overview

Property class which is used to represent the display value for graphs. For line and bar graphs they represent the propertied of the value that can be displayed at each data point. For bars it represents the value of each bar that can be displayed at top of the bars.

This class should never be used directly instead this is an internal class which is accessed through it's instance variable, for example,

$lineplot = new LinePlot($datay); // Access the instance of DisplayValue $lineplot->value->Show();

Argument	Default	Description
$aImg		No description available

Argument	Default	Description
$aFlag	true	True=Hide zero values

See also:

Example:

$pieplot->value->HideZero();

DisplayValue ::
SetAlign($aHAlign, $aVAlign)

Specify horizontal and vertical alignment

Argument Default Description

$aHAlign Horizontal alignment

$aVAlign '' Vertical alignment

Argument	Default	Description
$aHAlign		Horizontal alignment
$aVAlign	''	Vertical alignment

Description:

Specify the alignment of the display value in relation to the data point. Possible values are 'left', 'right', 'center'

Example:

$lineplot->value->SetAlign('center');

$lineplot->value->Show();

DisplayValue ::
SetAngle($aAngle)

Rotate the value a specified angle

Argument Default Description

$aAngle Angle in degrees

Argument	Default	Description
$aAngle		Angle in degrees

Description:

Roates the text label a number of degrees. 0 degrees is horizontal.

Please rememberthat you must use TTF fonts if you need any angle other than 0 or 90 degrees (horizontal or vertical)

See also:

DisplayValue::SetFont()

Example:

$bplot = new barPlot($datay);

// Setup the values that are displayed on top of each bar

$bplot->value->Show();

// Must use TTF fonts if we want text at an arbitrary angle

$bplot->value->SetFont(FF_ARIAL,FS_BOLD);

$bplot->value->SetAngle(45);

// Black color for positive values and darkred for negative values

$bplot->value->SetColor("black","darkred");

DisplayValue ::
SetColor($aColor, $aNegcolor)

Specify color for values

Argument Default Description

$aColor Color for positive values

$aNegcolor '' Color for negative values

Argument	Default	Description
$aColor		Color for positive values
$aNegcolor	''	Color for negative values

Description:

Specify the value for the labels. You can have one color for positive and one color for negative values. If no negative color value is specified it will be the same as the positive color.

Example:

// Black color for positive values and darkred for negative values

$bplot->value->SetColor("black","darkred");

DisplayValue ::
SetFont($aFontFamily, $aFontStyle, $aFontSize)

Specify font for values

Argument Default Description

$aFontFamily Font family

$aFontStyle FS_NORMAL Font style

$aFontSize 10 Font size

Argument	Default	Description
$aFontFamily		Font family
$aFontStyle	FS_NORMAL	Font style
$aFontSize	10	Font size

Description:

Specify font for display value

See also:

DisplayValue::SetAngle()

Example:

// Must use TTF fonts if we want text at an arbitrary angle

$bplot->value->SetFont(FF_ARIAL,FS_BOLD);

DisplayValue ::
SetFormat($aFormat, $aNegFormat)

Specify printf() format string.

Argument Default Description

$aFormat Format for positive values

$aNegFormat '' Format for negative values

Argument	Default	Description
$aFormat		Format for positive values
$aNegFormat	''	Format for negative values

Description:

Specify the format string for positive and negative values. The format string follows the same riules as the standard printf() format.

Please remember that if you want to format a number with a '%' sign you must use double '%%' as escape format, e.g. '%01.2.f%%' will format a number with two decimal places and a following '%' sign.

Example:

// Format label as floating point with 2 decimal points and

// a dollar sign in front, e.g. '$237.56'

$bplot->SetFormt('$%01.2f');

DisplayValue ::
SetFormatCallback($aFunc)

Specify format callback function

Argument Default Description

$aFunc Name of callback function

Argument	Default	Description
$aFunc		Name of callback function

Description:

Specify a function that get's called to format any value.

See also:

DisplayValue::SetFormat()

Example:

function barValueFormat($aLabel) {

    // Format '1000 english style

    return number_format($aLabel)

    // Format '1000 french style

    // return number_format($aLabel, 2, ',', ' ');

}

$barplot->value->SetFormatCallback('barValueFormat');

DisplayValue ::
SetMargin($aMargin)

Set nargin between value and anchor point in plot

Argument Default Description

$aMargin Margin in pixels

Argument	Default	Description
$aMargin		Margin in pixels

Description:

Specify the margin between the data point and the label.

Example:

$bplot->value->SetMargin(50);

DisplayValue ::
Show($aFlag)

Show value

Argument Default Description

$aFlag true True=show value

Argument	Default	Description
$aFlag	true	True=show value

Description:

Enable display of the label. If you want to display a value you must enable it since it is turned off by default.

Example:

// Enable display of each slice value

$pieplot->value->Show();

DisplayValue ::
__construct()

//===================================================// CLASS DisplayValue// Description: Used to print data values at data points//===================================================

Description:

No description available.