| 1 |
lars |
1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
|
|
|
2 |
<HTML>
|
|
|
3 |
<HEAD>
|
|
|
4 |
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-iso-8859-1">
|
|
|
5 |
<LINK REL="Start" HREF="index.html">
|
|
|
6 |
<LINK REL="Contents" HREF="toc.html">
|
|
|
7 |
<LINK REL="Prev" HREF="811Adjustinglabelsonatextscale.html">
|
|
|
8 |
<LINK REL="Next" HREF="813AddingtitlesandfooterstotheGraph.html">
|
|
|
9 |
<STYLE TYPE="text/css"><!--
|
|
|
10 |
BODY { font-family: serif }
|
|
|
11 |
H1 { font-family: sans-serif }
|
|
|
12 |
H2 { font-family: sans-serif }
|
|
|
13 |
H3 { font-family: sans-serif }
|
|
|
14 |
H4 { font-family: sans-serif }
|
|
|
15 |
H5 { font-family: sans-serif }
|
|
|
16 |
H6 { font-family: sans-serif }
|
|
|
17 |
SUB { font-size: smaller }
|
|
|
18 |
SUP { font-size: smaller }
|
|
|
19 |
PRE { font-family: monospace }
|
|
|
20 |
A { text-decoration: none }
|
|
|
21 |
--></STYLE>
|
|
|
22 |
</HEAD>
|
|
|
23 |
<BODY>
|
|
|
24 |
<A HREF="toc.html">Contents</A>
|
|
|
25 |
<A HREF="811Adjustinglabelsonatextscale.html">Previous</A>
|
|
|
26 |
<A HREF="813AddingtitlesandfooterstotheGraph.html">Next</A>
|
|
|
27 |
<HR NOSHADE>
|
|
|
28 |
<H2><A NAME="8_12">8.12 Adding arbitrary text strings to the graph</A></H2>
|
|
|
29 |
<P> To add clarification or other information text strings to the graph
|
|
|
30 |
you can add arbitrary lines of text anywhere you like onto the graph.
|
|
|
31 |
The text might have multiple lines and you can choose the paragraph
|
|
|
32 |
alignment.</P>
|
|
|
33 |
<P> To add text you have to create one or more instances of the <A href="../ref/Text.html#_C_TEXT">
|
|
|
34 |
Text()</A> object and then add the text object to the graph with the <A href="../ref/Graph.html#_GRAPH_ADDTEXT">
|
|
|
35 |
AddText()</A> method.</P>
|
|
|
36 |
<P> The position of these text boxes are given as fraction of the width
|
|
|
37 |
and height of the graph. When you are positioning these text boxes you
|
|
|
38 |
might also choose what part of the text box should be considered the
|
|
|
39 |
anchor point for the position you specify.</P>
|
|
|
40 |
<P> By default the anchor point is the upper left corner of the bounding
|
|
|
41 |
box for the text.</P>
|
|
|
42 |
<P> To show some ways of positioning the text we use a very simple bar
|
|
|
43 |
graph not to distract from the text. We first just add a single text
|
|
|
44 |
line with most of the settings their default value by adding the
|
|
|
45 |
following lines to the graph<DIV class="phpscript"><CODE><FONT color="#000000">
|
|
|
46 |
<FONT color="#0000BB"> $txt</FONT><FONT color="#007700">=new </FONT><FONT
|
|
|
47 |
color="#0000BB">Text</FONT><FONT color="#007700">(</FONT><FONT color="#DD0000">
|
|
|
48 |
"This is a text"</FONT><FONT color="#007700">);
|
|
|
49 |
<BR></FONT><FONT color="#0000BB">$txt</FONT><FONT color="#007700">-></FONT><FONT
|
|
|
50 |
color="#0000BB">Pos</FONT><FONT color="#007700">(</FONT><FONT color="#0000BB">
|
|
|
51 |
0</FONT><FONT color="#007700">,</FONT><FONT color="#0000BB">0</FONT><FONT
|
|
|
52 |
color="#007700">);
|
|
|
53 |
<BR></FONT><FONT color="#0000BB">$txt</FONT><FONT color="#007700">-></FONT><FONT
|
|
|
54 |
color="#0000BB">SetColor</FONT><FONT color="#007700">(</FONT><FONT color="#DD0000">
|
|
|
55 |
"red"</FONT><FONT color="#007700">);
|
|
|
56 |
<BR></FONT><FONT color="#0000BB">$graph</FONT><FONT color="#007700">-></FONT><FONT
|
|
|
57 |
color="#0000BB">AddText</FONT><FONT color="#007700">(</FONT><FONT color="#0000BB">
|
|
|
58 |
$txt</FONT><FONT color="#007700">);</FONT><FONT color="#0000BB"></FONT></FONT>
|
|
|
59 |
</CODE></DIV></P>
|
|
|
60 |
<P> The result is shown below.<DIV class="example">
|
|
|
61 |
<BR> <A href="exframes/frame_example25.html" target="blank"><IMG border="0"
|
|
|
62 |
HEIGHT="200" src="img/example25.png" WIDTH="300"></A>
|
|
|
63 |
<BR><B>Figure 85:</B> Adding a single text string in the upper left
|
|
|
64 |
corner <A href="exframes/frame_example25.html" target="blank">[src]</A>
|
|
|
65 |
|
|
|
66 |
<P></P>
|
|
|
67 |
</DIV></P>
|
|
|
68 |
<P>Not too exiting. Let's make it more interesting by having a
|
|
|
69 |
background color, using larger fonts and framing the text box and
|
|
|
70 |
adding a drop shadow to the text box by using the methods <A href="../ref/Text.html#_TEXT_SETBOX">
|
|
|
71 |
SetBox()</A> and <A href="../ref/Text.html#_TEXT_SETSHADOW"> SetBox()</A><DIV
|
|
|
72 |
class="example">
|
|
|
73 |
<BR> <A href="exframes/frame_example25.1.html" target="blank"><IMG border="0"
|
|
|
74 |
HEIGHT="200" src="img/example25.1.png" WIDTH="300"></A>
|
|
|
75 |
<BR><B>Figure 86:</B> Making the text more interesting <A href="exframes/frame_example25.1.html"
|
|
|
76 |
target="blank">[src]</A>
|
|
|
77 |
<P></P>
|
|
|
78 |
</DIV></P>
|
|
|
79 |
<P> That's better. Now we get some attention. If you want to add a text
|
|
|
80 |
with several lines you just need to separate the lines with a newline
|
|
|
81 |
('\n' character). The default paragraph alignment is left edge but you
|
|
|
82 |
can also use right and center alignment.</P>
|
|
|
83 |
<P> As an illustration let's add a couple of more lines to the previous
|
|
|
84 |
text, center the text box in the middle of the graph and also use
|
|
|
85 |
centered paragraph alignment for the text. To adjust the paragraph
|
|
|
86 |
alignment of the text you have to use the <A href="../ref/Text.html#_TEXT_PARAGRAPHALIGN">
|
|
|
87 |
Text::ParagraphAlign()</A><DIV class="example">
|
|
|
88 |
<BR> <A href="exframes/frame_example25.2.html" target="blank"><IMG border="0"
|
|
|
89 |
HEIGHT="200" src="img/example25.2.png" WIDTH="300"></A>
|
|
|
90 |
<BR><B>Figure 87:</B> Text with multiple lines and centered paragraph
|
|
|
91 |
alignment <A href="exframes/frame_example25.2.html" target="blank">
|
|
|
92 |
[src]</A>
|
|
|
93 |
<P></P>
|
|
|
94 |
</DIV></P>
|
|
|
95 |
<P> Of course there is no limit to the number of text string you can add
|
|
|
96 |
to the graph.</P>
|
|
|
97 |
<P> From version 1.12 it is also possible to add text strings to a graph
|
|
|
98 |
using the scale coordinates instead. This is accomplished by using the <A
|
|
|
99 |
href="../ref/Text.html#_TEXT_SETSCALEPOS"> Text::SetScalePos()</A> Which
|
|
|
100 |
is completely analog to SetPos() with the only difference that the
|
|
|
101 |
positions given are interpretated as scale values instead of fractions
|
|
|
102 |
of the width and height.</P>
|
|
|
103 |
<HR NOSHADE>
|
|
|
104 |
<A HREF="toc.html">Contents</A>
|
|
|
105 |
<A HREF="811Adjustinglabelsonatextscale.html">Previous</A>
|
|
|
106 |
<A HREF="813AddingtitlesandfooterstotheGraph.html">Next</A>
|
|
|
107 |
</BODY>
|
|
|
108 |
</HTML>
|