08 The class BoxFrame
A BoxFrame is a special kind of ContainerFrame. It is derived from the class ContainerFrame, but it can manage only one frame in the container. This limitation is not very restricting because you can add a container frame.
A BoxFrame can have a border and a background color. You can specify a width and/or a height that the box may use in the report. The frame can have different paddings on all four sides. A padding reduces the possible size of the content in the box by adding some whitespace.
The width and the height can be set independently or not at all. If you do not set the width, then the content will define the width of the BoxFrame.
You will use BoxFrame and SerialFrame (see 2.14) a lot because they are very flexible objects to control the layout in a report.
The constructor of a BoxFrame has the following parameters
- width – can be zero
- height – can be zero
- borderExtent – the extent for a border line (default 0.0)
- borderColor – default black
- backgroundColor – default white
If you create a BoxFrame with no parameters in the constructor and you do not add any content to it, nothing will be printed because this box will not use any space. You have to define a width, or you have to add content to make a box visible.
The following example creates a red box in the report.
$box = new ReportLib\BoxFrame(70.0, 50.0, 0.1, "#FF0000"); $body->addFrame($box);
That may look like the following figure.
The background will fill the whole box including the paddings. The next example defines a box with a black border and a yellow filling. The text will respect a padding of 5mm inside the box.
$bf = new ReportLib\BoxFrame(50.0, 20.0, 0.3);
$bf->setPadding(5.0);
$bf->setBackground("#FFFF00");
$body->addFrame($bf);
$tf = new ReportLib\TextFrame("This is text in a box.", $tsNormal);
$bf->addFrame($tf);
This example produces the following output
BoxFrame width in percent
You can define the width and height of a BoxFrame in percent of the width of the parent frame. To do that you have to pass the width as string. You can even mix percent and absolute values as in the following example.
$bf = new ReportLib\BoxFrame("70.0%", 20.0, 0.1);
$bf->setPadding(1.0);
$body->addFrame($bf);
$tf = new ReportLib\TextFrame("This is text in a box.", $tsNormal);
$bf->addFrame($tf);
The example shows a box frame with 70% of the width of the parent frame and a height of 20mm with a thin black border. The box gets some example text in a TextFrame as content.
The output will look as follows.
