104 lines
2.7 KiB
ReStructuredText
104 lines
2.7 KiB
ReStructuredText
|
.. _containers:
|
|||
|
|
|
|||
|
|
Containers
|
|||
|
|
==========
|
|||
|
|
|
|||
|
|
Sections
|
|||
|
|
--------
|
|||
|
|
|
|||
|
|
Every visible element in word is placed inside of a section. To create a
|
|||
|
|
section, use the following code:
|
|||
|
|
|
|||
|
|
.. code:: php
|
|||
|
|
|
|||
|
|
$section = $phpWord->createSection($sectionSettings);
|
|||
|
|
|
|||
|
|
The ``$sectionSettings`` is an optional associative array that sets the
|
|||
|
|
section. Example:
|
|||
|
|
|
|||
|
|
.. code:: php
|
|||
|
|
|
|||
|
|
$sectionSettings = array(
|
|||
|
|
'orientation' => 'landscape',
|
|||
|
|
'marginTop' => 600,
|
|||
|
|
'colsNum' => 2,
|
|||
|
|
);
|
|||
|
|
|
|||
|
|
Section settings
|
|||
|
|
~~~~~~~~~~~~~~~~
|
|||
|
|
|
|||
|
|
Below are the available settings for section:
|
|||
|
|
|
|||
|
|
- ``orientation`` Page orientation, i.e. ‘portrait’ (default) or
|
|||
|
|
‘landscape’
|
|||
|
|
- ``marginTop`` Page margin top in twips
|
|||
|
|
- ``marginLeft`` Page margin left in twips
|
|||
|
|
- ``marginRight`` Page margin right in twips
|
|||
|
|
- ``marginBottom`` Page margin bottom in twips
|
|||
|
|
- ``borderTopSize`` Border top size in twips
|
|||
|
|
- ``borderTopColor`` Border top color
|
|||
|
|
- ``borderLeftSize`` Border left size in twips
|
|||
|
|
- ``borderLeftColor`` Border left color
|
|||
|
|
- ``borderRightSize`` Border right size in twips
|
|||
|
|
- ``borderRightColor`` Border right color
|
|||
|
|
- ``borderBottomSize`` Border bottom size in twips
|
|||
|
|
- ``borderBottomColor`` Border bottom color
|
|||
|
|
- ``headerHeight`` Spacing to top of header
|
|||
|
|
- ``footerHeight`` Spacing to bottom of footer
|
|||
|
|
- ``colsNum`` Number of columns
|
|||
|
|
- ``colsSpace`` Spacing between columns
|
|||
|
|
- ``breakType`` Section break type (nextPage, nextColumn, continuous,
|
|||
|
|
evenPage, oddPage)
|
|||
|
|
|
|||
|
|
The following two settings are automatically set by the use of the
|
|||
|
|
``orientation`` setting. You can alter them but that’s not recommended.
|
|||
|
|
|
|||
|
|
- ``pageSizeW`` Page width in twips
|
|||
|
|
- ``pageSizeH`` Page height in twips
|
|||
|
|
|
|||
|
|
Section page numbering
|
|||
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|||
|
|
|
|||
|
|
You can change a section page numbering.
|
|||
|
|
|
|||
|
|
.. code:: php
|
|||
|
|
|
|||
|
|
$section = $phpWord->createSection();
|
|||
|
|
$section->getSettings()->setPageNumberingStart(1);
|
|||
|
|
|
|||
|
|
Headers
|
|||
|
|
-------
|
|||
|
|
|
|||
|
|
Each section can have its own header reference. To create a header use
|
|||
|
|
the ``createHeader`` method:
|
|||
|
|
|
|||
|
|
.. code:: php
|
|||
|
|
|
|||
|
|
$header = $section->createHeader();
|
|||
|
|
|
|||
|
|
Be sure to save the result in a local object. You can use all elements
|
|||
|
|
that are available for the footer. See “Footer” section for detail.
|
|||
|
|
Additionally, only inside of the header reference you can add watermarks
|
|||
|
|
or background pictures. See “Watermarks” section.
|
|||
|
|
|
|||
|
|
Footers
|
|||
|
|
-------
|
|||
|
|
|
|||
|
|
Each section can have its own footer reference. To create a footer, use
|
|||
|
|
the ``createFooter`` method:
|
|||
|
|
|
|||
|
|
.. code:: php
|
|||
|
|
|
|||
|
|
$footer = $section->createFooter();
|
|||
|
|
|
|||
|
|
Be sure to save the result in a local object to add elements to a
|
|||
|
|
footer. You can add the following elements to footers:
|
|||
|
|
|
|||
|
|
- Texts ``addText`` and ``createTextrun``
|
|||
|
|
- Text breaks
|
|||
|
|
- Images
|
|||
|
|
- Tables
|
|||
|
|
- Preserve text
|
|||
|
|
|
|||
|
|
See the “Elements” section for the detail of each elements.
|