Subversion Repositories cheapmusic

Rev

Blame | Last modification | View Log | RSS feed 

<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><title>SetDataValueLabelColor</title><link rel="stylesheet" type="text/css" href="phplotdoc.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="PHPlot Reference Manual" /><link rel="up" href="reference.html" title="PHPlot Function Reference" /><link rel="prev" href="SetDataType.html" title="SetDataType" /><link rel="next" href="SetDataValues.html" title="SetDataValues" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">SetDataValueLabelColor</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="SetDataType.html">Prev</a> </td><th width="60%" align="center">PHPlot Function Reference</th><td width="20%" align="right"> <a accesskey="n" href="SetDataValues.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="SetDataValueLabelColor"></a><div class="titlepage"></div><div class="refnamediv"><h2><span class="refentrytitle">SetDataValueLabelColor</span></h2><p>SetDataValueLabelColor &#8212; Set the color for data value labels</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">$plot-&gt;SetDataValueLabelColor(<em class="parameter"><code>$color</code></em>)</pre></div><div class="refsect1"><a id="idp1377910092"></a><h2>Description</h2><p>
<code class="function">SetDataValueLabelColor</code> sets the color which is used for
data value labels. These are the labels which show the values of data points
or bars, within the plot area. (Do not confuse these with axis data labels,
which are displayed along the X or Y axis lines.)
    </p></div><div class="refsect1"><a id="idp1377911292"></a><h2>Parameters</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="replaceable"><code>$color</code></em></span></dt><dd><p>
Color value to use.
See <a class="xref" href="conc-colors.html" title="3.5. Colors">Section 3.5, &#8220;Colors&#8221;</a> for more on color values.
          </p></dd></dl></div></div><div class="refsect1"><a id="idp1377913148"></a><h2>Notes</h2><p>
If <code class="function">SetDataValueLabelColor</code> is not used, data value labels
default to using the color set for all data labels with
<a class="xref" href="SetDataLabelColor.html" title="SetDataLabelColor"><span class="refentrytitle">SetDataLabelColor</span></a>.
If that function is not used, both types of data labels default to using the
general text color set with <a class="xref" href="SetTextColor.html" title="SetTextColor"><span class="refentrytitle">SetTextColor</span></a>.
If none of <code class="function">SetDataValueLabelColor</code>,
<code class="function">SetDataLabelColor</code>, or <code class="function">SetTextColor</code>
is used, the default color for all data labels is black.
    </p><p>
See also <a class="xref" href="conc-labels.html" title="3.6. Labels">Section 3.6, &#8220;Labels&#8221;</a> for information about different
label types.
    </p><p>
PHPlot has a deprecated function called <code class="function">SetLabelColor</code>.
Do not use this function. It does not set the color used for labels.
    </p></div><div class="refsect1"><a id="idp1377917412"></a><h2>History</h2><p>
This function was added in PHPlot-5.7.0, and the defaults were changed as
described above. Through PHPlot-5.6.0, the data value labels were drawn using
the title color, as set with <a class="xref" href="SetTitleColor.html" title="SetTitleColor"><span class="refentrytitle">SetTitleColor</span></a>.
Since data value labels are not titles, this was incorrect, and they should
have been using the general text color like other data labels. There were
two parts to the fix in PHPlot-5.7.0: data value label color now defaults to
the general text color rather than the title color, and new functions
<code class="function">SetDataValueLabelColor</code> and
<a class="xref" href="SetDataLabelColor.html" title="SetDataLabelColor"><span class="refentrytitle">SetDataLabelColor</span></a> were added to allow separate control of
label colors.
    </p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="SetDataType.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="SetDataValues.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">SetDataType </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> SetDataValues</td></tr></table></div></body></html>