addTextBox

Key	Type	Description
coordinateX	int	EMUs (English Metric Unit).
coordinateY	int	EMUs (English Metric Unit).
sizeX	int	EMUs (English Metric Unit).
sizeY	int	EMUs (English Metric Unit).
name	string	Internal name. If not set, a random name is generated.
order	int	Set the display order. Default after existing contents. 0 is the first order position. If the order position doesn't exist add after existing contents.

Coordinate and size values must be set.

textBoxStyles

Key	Type	Description
autofit	string	autofit (default), noautofit, shrink.
border	array	'cap' (string) rnd, sq, flat. 'dash' (string) solid, dot, dash, lgDash, dashDot, lgDashDot, lgDashDotDot, sysDash, sysDot, sysDashDot, sysDashDotDot. 'color' (string) default as 000000. 'transparency' (int) 0 to 100. 'width' (int) EMUs (English Metric Unit). Default as 12700 (1pt).
columns	array	'number' (int) 'spacing' (int) EMUs (English Metric Unit).
descr	string	Descr value.
fill	array	'color' (string) FFFF00, CCCCCC... 'image' (string) 'imageTransparency' (int) 'imageAsTexture' (bool) default as false
margin	array	'bottom' (int) EMUs (English Metric Unit) 'left' (int) EMUs (English Metric Unit) 'right' (int) EMUs (English Metric Unit) 'top' (int) EMUs (English Metric Unit)
rotation	int	Rotation.
textDirection	string	horz, vert, vert270, wordArtVert, eaVert, mongolianVert, wordArtVertRtl.
verticalAlign	string	top, middle, bottom, topCentered, middleCentered, bottomCentered.
wrap	string	square, none.

Exceptions

Position not valid.

Code samples

Example #1

require_once 'classes/CreatePptx.php';

$position = array(
    'coordinateX' => 1470000,
    'coordinateY' => 600000,
    'sizeX' => 5000000,
    'sizeY' => 450000,
);
// if no style is applied or a content is added, a text box is added in the slide but it's not visually displayed
$textBoxStyles = array(
    'border' => array(
        'color' => '000000',
    ),
);
$pptx->addTextBox($position, $textBoxStyles);

$position = array(
    'coordinateX' => 3770000,
    'coordinateY' => 4507000,
    'sizeX' => 7000000,
    'sizeY' => 1450000,
);
$textBoxStyles = array(
    'autofit' => 'noautofit',
    'border' => array(
        'color' => '000000',
    ),
    'fill' => array(
        'color' => '99B369',
    ),
);
$pptx->addTextBox($position, $textBoxStyles);

$pptx->savePptx('output');

The resulting PPTX looks like:

Example #2

require_once 'classes/CreatePptx.php';

$pptx = new CreatePptxFromTemplate('template.pptx');

// add the text boxed in the second slide. The first slide has the position 0
$pptx->setActiveSlide(array('position' => 1));

$position = array(
    'coordinateX' => 6470000,
    'coordinateY' => 600000,
    'sizeX' => 5000000,
    'sizeY' => 450000,
    'name' => 'Textbox custom A',
);
$textBoxStyles = array(
    'border' => array(
        'color' => '000000',
    ),
);
$pptx->addTextBox($position, $textBoxStyles);

$position = array(
    'coordinateX' => 1770000,
    'coordinateY' => 3507000,
    'sizeX' => 4000000,
    'sizeY' => 2350000,
    'name' => 'Textbox custom A',
    'order' => 0,
);
$textBoxStyles = array(
    'autofit' => 'noautofit',
    'fill' => array(
        'image' => 'image.png',
    ),
);
$pptx->addTextBox($position, $textBoxStyles);

$pptx->savePptx('output');

The resulting PPTX looks like:

Release notes

phppptx 4.0:
- extra check to avoid duplicated shape internal ids.
- name option moved to the position array option.

phppptx 1.0:
- new method.