PreserveText extends AbstractElement
Preserve text/field element
Table of Contents
- $collectionRelation : bool
- Is part of collection; true for Title, Footnote, Endnote, Chart, and Comment
- $commentRangeEnd : Comment
- The end position for the linked comment
- $commentRangeStart : Comment
- The start position for the linked comment
- $docPart : string
- Document part type: Section|Header|Footer|Footnote|Endnote
- $docPartId : int
- Document part Id
- $elementId : string
- Unique Id for element
- $elementIndex : int
- Index of element in the elements collection (start with 1)
- $mediaRelation : bool
- Has media relation flag; true for Link, Image, and Object
- $phpWord : PhpWord
- PhpWord object
- $relationId : int
- Relation Id
- $sectionId : int
- Section Id
- $fontStyle : string|Font
- Text style
- $nestedLevel : int
- Depth of table container nested level; Primarily used for RTF writer/reader
- $paragraphStyle : string|Paragraph
- Paragraph style
- $parent : AbstractElement|null
- A reference to the parent
- $parentContainer : string
- Parent container type
- $text : string|array<string|int, mixed>
- Text content
- $trackChange : TrackChange
- changed element info
- __construct() : mixed
- Create a new Preserve Text Element
- getCommentRangeEnd() : Comment
- Get comment end
- getCommentRangeStart() : Comment
- Get comment start
- getDocPart() : string
- Get doc part
- getDocPartId() : int
- Get doc part Id
- getElementId() : string
- Get element unique ID
- getElementIndex() : int
- Get element index
- getFontStyle() : string|Font
- Get Text style
- getNestedLevel() : int
- Get nested level
- getParagraphStyle() : string|Paragraph
- Get Paragraph style
- getParent() : AbstractElement|null
- Get parent element
- getPhpWord() : PhpWord
- Get PhpWord
- getRelationId() : int
- Get relation Id
- getSectionId() : int
- Get section number
- getText() : string|array<string|int, mixed>
- Get Text content
- getTrackChange() : TrackChange
- Gets the trackChange information
- isInSection() : bool
- Check if element is located in Section doc part (as opposed to Header/Footer)
- setChangeInfo() : mixed
- Set changed
- setCommentRangeEnd() : mixed
- Set comment end
- setCommentRangeStart() : mixed
- Set comment start
- setDocPart() : mixed
- Set doc part.
- setElementId() : mixed
- Set element unique ID from 6 first digit of md5.
- setElementIndex() : mixed
- Set element index.
- setParentContainer() : mixed
- Set parent container
- setPhpWord() : mixed
- Set PhpWord as reference.
- setRelationId() : mixed
- Set relation Id.
- setTrackChange() : mixed
- Sets the trackChange information
- setEnumVal() : string|null
- Set enum value
- setNewStyle() : mixed
- Set new style value
- getMediaPart() : string
- Return media element (image, object, link) container name
- setCollectionRelation() : mixed
- Set relation Id for elements that will be registered in the Collection subnamespaces.
- setMediaRelation() : mixed
- Set relation Id for media elements (link, image, object; legacy of OOXML)
Properties
$collectionRelation
Is part of collection; true for Title, Footnote, Endnote, Chart, and Comment
protected
bool
$collectionRelation
= false
$commentRangeEnd
The end position for the linked comment
protected
Comment
$commentRangeEnd
$commentRangeStart
The start position for the linked comment
protected
Comment
$commentRangeStart
$docPart
Document part type: Section|Header|Footer|Footnote|Endnote
protected
string
$docPart
= 'Section'
Used by textrun and cell container to determine where the element is located because it will affect the availability of other element, e.g. footnote will not be available when $docPart is header or footer.
$docPartId
Document part Id
protected
int
$docPartId
= 1
For header and footer, this will be = ($sectionId - 1) * 3 + $index because the max number of header/footer in every page is 3, i.e. AUTO, FIRST, and EVEN (AUTO = ODD)
$elementId
Unique Id for element
protected
string
$elementId
$elementIndex
Index of element in the elements collection (start with 1)
protected
int
$elementIndex
= 1
$mediaRelation
Has media relation flag; true for Link, Image, and Object
protected
bool
$mediaRelation
= false
$phpWord
PhpWord object
protected
PhpWord
$phpWord
$relationId
Relation Id
protected
int
$relationId
$sectionId
Section Id
protected
int
$sectionId
$fontStyle
Text style
private
string|Font
$fontStyle
$nestedLevel
Depth of table container nested level; Primarily used for RTF writer/reader
private
int
$nestedLevel
= 0
0 = Not in a table; 1 = in a table; 2 = in a table inside another table, etc.
$paragraphStyle
Paragraph style
private
string|Paragraph
$paragraphStyle
$parent
A reference to the parent
private
AbstractElement|null
$parent
$parentContainer
Parent container type
private
string
$parentContainer
$text
Text content
private
string|array<string|int, mixed>
$text
$trackChange
changed element info
private
TrackChange
$trackChange
Methods
__construct()
Create a new Preserve Text Element
public
__construct([string $text = null ][, mixed $fontStyle = null ][, mixed $paragraphStyle = null ]) : mixed
Parameters
- $text : string = null
- $fontStyle : mixed = null
- $paragraphStyle : mixed = null
Return values
mixed —getCommentRangeEnd()
Get comment end
public
getCommentRangeEnd() : Comment
Return values
Comment —getCommentRangeStart()
Get comment start
public
getCommentRangeStart() : Comment
Return values
Comment —getDocPart()
Get doc part
public
getDocPart() : string
Return values
string —getDocPartId()
Get doc part Id
public
getDocPartId() : int
Return values
int —getElementId()
Get element unique ID
public
getElementId() : string
Return values
string —getElementIndex()
Get element index
public
getElementIndex() : int
Return values
int —getFontStyle()
Get Text style
public
getFontStyle() : string|Font
Return values
string|Font —getNestedLevel()
Get nested level
public
getNestedLevel() : int
Return values
int —getParagraphStyle()
Get Paragraph style
public
getParagraphStyle() : string|Paragraph
Return values
string|Paragraph —getParent()
Get parent element
public
getParent() : AbstractElement|null
Return values
AbstractElement|null —getPhpWord()
Get PhpWord
public
getPhpWord() : PhpWord
Return values
PhpWord —getRelationId()
Get relation Id
public
getRelationId() : int
Return values
int —getSectionId()
Get section number
public
getSectionId() : int
Return values
int —getText()
Get Text content
public
getText() : string|array<string|int, mixed>
Return values
string|array<string|int, mixed> —getTrackChange()
Gets the trackChange information
public
getTrackChange() : TrackChange
Return values
TrackChange —isInSection()
Check if element is located in Section doc part (as opposed to Header/Footer)
public
isInSection() : bool
Return values
bool —setChangeInfo()
Set changed
public
setChangeInfo(string $type, string $author[, null|int|DateTime $date = null ]) : mixed
Parameters
- $type : string
-
INSERTED|DELETED
- $author : string
- $date : null|int|DateTime = null
-
allways in UTC
Return values
mixed —setCommentRangeEnd()
Set comment end
public
setCommentRangeEnd(Comment $value) : mixed
Parameters
- $value : Comment
Return values
mixed —setCommentRangeStart()
Set comment start
public
setCommentRangeStart(Comment $value) : mixed
Parameters
- $value : Comment
Return values
mixed —setDocPart()
Set doc part.
public
setDocPart(string $docPart[, int $docPartId = 1 ]) : mixed
Parameters
- $docPart : string
- $docPartId : int = 1
Return values
mixed —setElementId()
Set element unique ID from 6 first digit of md5.
public
setElementId() : mixed
Return values
mixed —setElementIndex()
Set element index.
public
setElementIndex(int $value) : mixed
Parameters
- $value : int
Return values
mixed —setParentContainer()
Set parent container
public
setParentContainer(AbstractElement $container) : mixed
Passed parameter should be a container, except for Table (contain Row) and Row (contain Cell)
Parameters
- $container : AbstractElement
Return values
mixed —setPhpWord()
Set PhpWord as reference.
public
setPhpWord([PhpWord $phpWord = null ]) : mixed
Parameters
- $phpWord : PhpWord = null
Return values
mixed —setRelationId()
Set relation Id.
public
setRelationId(int $value) : mixed
Parameters
- $value : int
Return values
mixed —setTrackChange()
Sets the trackChange information
public
setTrackChange(TrackChange $trackChange) : mixed
Parameters
- $trackChange : TrackChange
Return values
mixed —setEnumVal()
Set enum value
protected
setEnumVal([string|null $value = null ][, array<string|int, string> $enum = array() ][, string|null $default = null ]) : string|null
Parameters
- $value : string|null = null
- $enum : array<string|int, string> = array()
- $default : string|null = null
Tags
Return values
string|null —setNewStyle()
Set new style value
protected
setNewStyle(mixed $styleObject[, mixed $styleValue = null ][, bool $returnObject = false ]) : mixed
Parameters
- $styleObject : mixed
-
Style object
- $styleValue : mixed = null
-
Style value
- $returnObject : bool = false
-
Always return object
Return values
mixed —getMediaPart()
Return media element (image, object, link) container name
private
getMediaPart() : string
Return values
string —section|headerx|footerx|footnote|endnote
setCollectionRelation()
Set relation Id for elements that will be registered in the Collection subnamespaces.
private
setCollectionRelation() : mixed
Return values
mixed —setMediaRelation()
Set relation Id for media elements (link, image, object; legacy of OOXML)
private
setMediaRelation() : mixed
- Image element needs to be passed to Media object
- Icon needs to be set for Object element