Documentation

Frame extends AbstractStyle
in package

Frame defines the size and position of an object.

Width, height, left/hpos, top/vpos, hrel, vrel, wrap, zindex

Tags
since
0.12.0
todo

Make existing style (image, textbox, etc) use this style

Table of Contents

Constants

POS_ABSOLUTE  = 'absolute'
General positioning options.
POS_BOTTOM  = 'bottom'
POS_CENTER  = 'center'
Horizontal/vertical value.
POS_INSIDE  = 'inside'
POS_LEFT  = 'left'
POS_OUTSIDE  = 'outside'
POS_RELATIVE  = 'relative'
POS_RELTO_BMARGIN  = 'bottom-margin-area'
POS_RELTO_CHAR  = 'char'
POS_RELTO_COLUMN  = 'column'
POS_RELTO_IMARGIN  = 'inner-margin-area'
POS_RELTO_LINE  = 'line'
POS_RELTO_LMARGIN  = 'left-margin-area'
POS_RELTO_MARGIN  = 'margin'
Position relative to.
POS_RELTO_OMARGIN  = 'outer-margin-area'
POS_RELTO_PAGE  = 'page'
POS_RELTO_RMARGIN  = 'right-margin-area'
POS_RELTO_TEXT  = 'text'
POS_RELTO_TMARGIN  = 'top-margin-area'
POS_RIGHT  = 'right'
POS_TOP  = 'top'
UNIT_PT  = 'pt'
Length unit.
UNIT_PX  = 'px'
WRAP_BEHIND  = 'behind'
WRAP_INFRONT  = 'infront'
WRAP_INLINE  = 'inline'
Wrap type.
WRAP_SQUARE  = 'square'
WRAP_THROUGH  = 'through'
WRAP_TIGHT  = 'tight'
WRAP_TOPBOTTOM  = 'topAndBottom'

Properties

$aliases  : array<string|int, mixed>
Aliases.
$index  : null|int
Index number in Style collection for named style.
$styleName  : string|null
Style name.
$alignment  : string
$height  : float|int
Height.
$hPos  : string
Horizontal position.
$hPosRelTo  : string
Horizontal position relative to.
$isAuto  : bool
Is this an automatic style? (Used primarily in OpenDocument driver).
$left  : float|int
Leftmost (horizontal) position.
$pos  : string
Position type: absolute|relative.
$position  : int
Vertically raised or lowered text.
$top  : float|int
Topmost (vertical) position.
$unit  : string
Unit.
$vPos  : string
Vertical position.
$vPosRelTo  : string
Vertical position relative to.
$width  : float|int
Width.
$wrap  : string
Wrap type.
$wrapDistanceBottom  : float
Bottom wrap distance.
$wrapDistanceLeft  : float
Left wrap distance.
$wrapDistanceRight  : float
Right wrap distance.
$wrapDistanceTop  : float
Top wrap distance.

Methods

__construct()  : mixed
Create a new instance.
getAlignment()  : string
getChildStyleValue()  : mixed
Return style value of child style object, e.g. `left` from `Indentation` child style of `Paragraph`.
getHeight()  : float|int
Get height.
getHPos()  : string
Get horizontal position.
getHPosRelTo()  : string
Get horizontal position relative to.
getIndex()  : null|int
Get index number.
getLeft()  : float|int
Get left.
getPos()  : string
Get position type.
getPosition()  : int
Get position.
getStyleName()  : string|null
Get style name.
getTop()  : float|int
Get topmost position.
getUnit()  : string
Get unit.
getVPos()  : string
Get vertical position.
getVPosRelTo()  : string
Get vertical position relative to.
getWidth()  : float|int
Get width.
getWrap()  : string
Get wrap type.
getWrapDistanceBottom()  : float
Get bottom distance from text wrap.
getWrapDistanceLeft()  : float
Get left distance from text wrap.
getWrapDistanceRight()  : float
Get right distance from text wrap.
getWrapDistanceTop()  : float
Get top distance from text wrap.
isAuto()  : bool
Get is automatic style flag.
setAlignment()  : self
setAuto()  : self
Set is automatic style flag.
setHeight()  : self
Set height.
setHPos()  : self
Set horizontal position.
setHPosRelTo()  : self
Set horizontal position relative to.
setIndex()  : self
Set index number.
setLeft()  : self
Set left.
setPos()  : self
Set position type.
setPosition()  : self
Set position.
setStyleByArray()  : self
Set style by using associative array.
setStyleName()  : self
Set style name.
setStyleValue()  : self
Set style value template method.
setTop()  : self
Set topmost position.
setUnit()  : self
Set unit.
setVPos()  : self
Set vertical position.
setVPosRelTo()  : self
Set vertical position relative to.
setWidth()  : self
Set width.
setWrap()  : self
Set wrap type.
setWrapDistanceBottom()  : self
Set bottom distance from text wrap.
setWrapDistanceLeft()  : self
Set left distance from text wrap.
setWrapDistanceRight()  : self
Set right distance from text wrap.
setWrapDistanceTop()  : self
Set top distance from text wrap.
setBoolVal()  : bool
Set bool value.
setEnumVal()  : mixed
Set enum value.
setFloatVal()  : null|float
Set float value: Convert string that contains only numeric into float.
setIntVal()  : null|int
Set integer value: Convert string that contains only numeric into integer.
setNonEmptyVal()  : string
Set default for null and empty value.
setNumericVal()  : null|float|int
Set numeric value.
setObjectVal()  : mixed
Set object value.
setPairedVal()  : self
Set $property value and set $pairProperty = false when $value = true.

Constants

POS_ABSOLUTE

General positioning options.

public mixed POS_ABSOLUTE = 'absolute'
Tags
const

string

POS_BOTTOM

public mixed POS_BOTTOM = 'bottom'

POS_CENTER

Horizontal/vertical value.

public mixed POS_CENTER = 'center'
Tags
const

string

POS_INSIDE

public mixed POS_INSIDE = 'inside'

POS_LEFT

public mixed POS_LEFT = 'left'

POS_OUTSIDE

public mixed POS_OUTSIDE = 'outside'

POS_RELATIVE

public mixed POS_RELATIVE = 'relative'

POS_RELTO_BMARGIN

public mixed POS_RELTO_BMARGIN = 'bottom-margin-area'

POS_RELTO_CHAR

public mixed POS_RELTO_CHAR = 'char'

POS_RELTO_COLUMN

public mixed POS_RELTO_COLUMN = 'column'

POS_RELTO_IMARGIN

public mixed POS_RELTO_IMARGIN = 'inner-margin-area'

POS_RELTO_LINE

public mixed POS_RELTO_LINE = 'line'

POS_RELTO_LMARGIN

public mixed POS_RELTO_LMARGIN = 'left-margin-area'

POS_RELTO_MARGIN

Position relative to.

public mixed POS_RELTO_MARGIN = 'margin'
Tags
const

string

POS_RELTO_OMARGIN

public mixed POS_RELTO_OMARGIN = 'outer-margin-area'

POS_RELTO_PAGE

public mixed POS_RELTO_PAGE = 'page'

POS_RELTO_RMARGIN

public mixed POS_RELTO_RMARGIN = 'right-margin-area'

POS_RELTO_TEXT

public mixed POS_RELTO_TEXT = 'text'

POS_RELTO_TMARGIN

public mixed POS_RELTO_TMARGIN = 'top-margin-area'

POS_RIGHT

public mixed POS_RIGHT = 'right'

POS_TOP

public mixed POS_TOP = 'top'

UNIT_PT

Length unit.

public mixed UNIT_PT = 'pt'
Tags
const

string

UNIT_PX

public mixed UNIT_PX = 'px'

WRAP_BEHIND

public mixed WRAP_BEHIND = 'behind'

WRAP_INFRONT

public mixed WRAP_INFRONT = 'infront'

WRAP_INLINE

Wrap type.

public mixed WRAP_INLINE = 'inline'
Tags
const

string

WRAP_SQUARE

public mixed WRAP_SQUARE = 'square'

WRAP_THROUGH

public mixed WRAP_THROUGH = 'through'

WRAP_TIGHT

public mixed WRAP_TIGHT = 'tight'

WRAP_TOPBOTTOM

public mixed WRAP_TOPBOTTOM = 'topAndBottom'

Properties

$aliases

Aliases.

protected array<string|int, mixed> $aliases = []

$index

Index number in Style collection for named style.

protected null|int $index

This number starts from one and defined in Style::setStyleValues()

$alignment

private string $alignment = ''

$height

Height.

private float|int $height

$hPos

Horizontal position.

private string $hPos

$hPosRelTo

Horizontal position relative to.

private string $hPosRelTo

$isAuto

Is this an automatic style? (Used primarily in OpenDocument driver).

private bool $isAuto = false
Tags
since
0.11.0

$left

Leftmost (horizontal) position.

private float|int $left = 0

$pos

Position type: absolute|relative.

private string $pos

$top

Topmost (vertical) position.

private float|int $top = 0

$unit

Unit.

private string $unit = 'pt'

$vPos

Vertical position.

private string $vPos

$vPosRelTo

Vertical position relative to.

private string $vPosRelTo

$width

Width.

private float|int $width

$wrap

Wrap type.

private string $wrap

$wrapDistanceBottom

Bottom wrap distance.

private float $wrapDistanceBottom

$wrapDistanceLeft

Left wrap distance.

private float $wrapDistanceLeft

$wrapDistanceRight

Right wrap distance.

private float $wrapDistanceRight

$wrapDistanceTop

Top wrap distance.

private float $wrapDistanceTop

Methods

__construct()

Create a new instance.

public __construct([array<string|int, mixed> $style = [] ]) : mixed
Parameters
$style : array<string|int, mixed> = []

getAlignment()

public getAlignment() : string
Tags
since
0.13.0
Return values
string

getChildStyleValue()

Return style value of child style object, e.g. `left` from `Indentation` child style of `Paragraph`.

public getChildStyleValue(AbstractStyle $substyleObject, string $substyleProperty) : mixed
Parameters
$substyleObject : AbstractStyle
$substyleProperty : string
Tags
since
0.12.0

getHeight()

Get height.

public getHeight() : float|int
Return values
float|int

getHPos()

Get horizontal position.

public getHPos() : string
Return values
string

getHPosRelTo()

Get horizontal position relative to.

public getHPosRelTo() : string
Return values
string

getIndex()

Get index number.

public getIndex() : null|int
Return values
null|int

getLeft()

Get left.

public getLeft() : float|int
Return values
float|int

getPos()

Get position type.

public getPos() : string
Return values
string

getPosition()

Get position.

public getPosition() : int
Return values
int

getStyleName()

Get style name.

public getStyleName() : string|null
Return values
string|null

getTop()

Get topmost position.

public getTop() : float|int
Return values
float|int

getUnit()

Get unit.

public getUnit() : string
Return values
string

getVPos()

Get vertical position.

public getVPos() : string
Return values
string

getVPosRelTo()

Get vertical position relative to.

public getVPosRelTo() : string
Return values
string

getWidth()

Get width.

public getWidth() : float|int
Return values
float|int

getWrap()

Get wrap type.

public getWrap() : string
Return values
string

getWrapDistanceBottom()

Get bottom distance from text wrap.

public getWrapDistanceBottom() : float
Return values
float

getWrapDistanceLeft()

Get left distance from text wrap.

public getWrapDistanceLeft() : float
Return values
float

getWrapDistanceRight()

Get right distance from text wrap.

public getWrapDistanceRight() : float
Return values
float

getWrapDistanceTop()

Get top distance from text wrap.

public getWrapDistanceTop() : float
Return values
float

isAuto()

Get is automatic style flag.

public isAuto() : bool
Return values
bool

setAlignment()

public setAlignment(string $value) : self
Parameters
$value : string
Tags
since
0.13.0
Return values
self

setAuto()

Set is automatic style flag.

public setAuto([bool $value = true ]) : self
Parameters
$value : bool = true
Return values
self

setHeight()

Set height.

public setHeight([float|int $value = null ]) : self
Parameters
$value : float|int = null
Return values
self

setHPos()

Set horizontal position.

public setHPos(string $value) : self
Parameters
$value : string
Tags
since
0.12.0

"absolute" option is available.

Return values
self

setHPosRelTo()

Set horizontal position relative to.

public setHPosRelTo(string $value) : self
Parameters
$value : string
Return values
self

setIndex()

Set index number.

public setIndex([null|int $value = null ]) : self
Parameters
$value : null|int = null
Return values
self

setLeft()

Set left.

public setLeft([float|int $value = 0 ]) : self
Parameters
$value : float|int = 0
Return values
self

setPos()

Set position type.

public setPos(string $value) : self
Parameters
$value : string
Return values
self

setPosition()

Set position.

public setPosition([int $value = null ]) : self
Parameters
$value : int = null
Return values
self

setStyleByArray()

Set style by using associative array.

public setStyleByArray([array<string|int, mixed> $values = [] ]) : self
Parameters
$values : array<string|int, mixed> = []
Return values
self

setStyleName()

Set style name.

public setStyleName(string $value) : self
Parameters
$value : string
Return values
self

setStyleValue()

Set style value template method.

public setStyleValue(string $key, array<string|int, mixed>|int|string $value) : self

Some child classes have their own specific overrides. Backward compability check for versions < 0.10.0 which use underscore prefix for their private properties. Check if the set method is exists. Throws an exception?

Parameters
$key : string
$value : array<string|int, mixed>|int|string
Return values
self

setTop()

Set topmost position.

public setTop([float|int $value = 0 ]) : self
Parameters
$value : float|int = 0
Return values
self

setUnit()

Set unit.

public setUnit(string $value) : self
Parameters
$value : string
Return values
self

setVPos()

Set vertical position.

public setVPos(string $value) : self
Parameters
$value : string
Tags
since
0.12.0

"absolute" option is available.

Return values
self

setVPosRelTo()

Set vertical position relative to.

public setVPosRelTo(string $value) : self
Parameters
$value : string
Return values
self

setWidth()

Set width.

public setWidth([float|int $value = null ]) : self
Parameters
$value : float|int = null
Return values
self

setWrap()

Set wrap type.

public setWrap(string $value) : self
Parameters
$value : string
Return values
self

setWrapDistanceBottom()

Set bottom distance from text wrap.

public setWrapDistanceBottom([float $value = null ]) : self
Parameters
$value : float = null
Return values
self

setWrapDistanceLeft()

Set left distance from text wrap.

public setWrapDistanceLeft([float $value = null ]) : self
Parameters
$value : float = null
Return values
self

setWrapDistanceRight()

Set right distance from text wrap.

public setWrapDistanceRight([float $value = null ]) : self
Parameters
$value : float = null
Return values
self

setWrapDistanceTop()

Set top distance from text wrap.

public setWrapDistanceTop([int $value = null ]) : self
Parameters
$value : int = null
Return values
self

setBoolVal()

Set bool value.

protected setBoolVal(bool $value, bool $default) : bool
Parameters
$value : bool
$default : bool
Return values
bool

setEnumVal()

Set enum value.

protected setEnumVal([mixed $value = null ][, array<string|int, mixed> $enum = [] ][, mixed $default = null ]) : mixed
Parameters
$value : mixed = null
$enum : array<string|int, mixed> = []
$default : mixed = null

setFloatVal()

Set float value: Convert string that contains only numeric into float.

protected setFloatVal(mixed $value[, null|float $default = null ]) : null|float
Parameters
$value : mixed
$default : null|float = null
Return values
null|float

setIntVal()

Set integer value: Convert string that contains only numeric into integer.

protected setIntVal(null|float|int|string $value[, null|int $default = null ]) : null|int
Parameters
$value : null|float|int|string
$default : null|int = null
Return values
null|int

setNonEmptyVal()

Set default for null and empty value.

protected setNonEmptyVal(string|null $value, string $default) : string
Parameters
$value : string|null
$default : string
Return values
string

setNumericVal()

Set numeric value.

protected setNumericVal(mixed $value[, null|float|int $default = null ]) : null|float|int
Parameters
$value : mixed
$default : null|float|int = null
Return values
null|float|int

setObjectVal()

Set object value.

protected setObjectVal(mixed $value, string $styleName, mixed &$style) : mixed
Parameters
$value : mixed
$styleName : string
$style : mixed

setPairedVal()

Set $property value and set $pairProperty = false when $value = true.

protected setPairedVal(bool &$property, bool &$pairProperty, bool $value) : self
Parameters
$property : bool
$pairProperty : bool
$value : bool
Return values
self

        
On this page

Search results