out (PPTX)
A PowerPoint content command that replaces the contents of its host shape's text body with the provided value. If placed onto a shape that already contains text, such as a Text Box, the replacement text will appear in the same location as the original text, otherwise the text will appear in an undefined location, typically around the middle of the shape.
This command has a priority of 15.
Syntax:
out(value,format,parser)
With required attributes only:
out(value)
Attributes
#1 - value | ||
---|---|---|
Required | Value type | EL-evaluated |
Yes | Boolean | Yes |
Defines the text content brought into the shape's text body. The resolved value may be of any kind, but if not a String, it will be converted into one. The Parser and/or Format optionally defined through the |
#2 - format | ||
---|---|---|
Required | Value type | EL-evaluated |
No | String | No |
Specifies a Format that takes the value to output and formats it into a String as according to its formatting rules. The resolved String is expected to name of a Format defined earlier in the logic. |
#3 - parser | ||
---|---|---|
Required | Value type | EL-evaluated |
No | String | No |
If the resolved value of this attribute is the name of a Parser, the value to output is first converted into a String (if it isn't one already) and then parsed into another type of value by the Parser. If both If undefined or if the named Parser cannot be found, the value retains its original type. |
Examples
In its basic use, out
only requires its first attribute value
to be defined.
out(subtitle)
out(UserInfo.Email)
The second attribute format
typically comes useful with Number and Currency values. The third attribute parser
is generally of limited use, primarily allowing String values representing numbers to be affected by Number formatters.
out(totalPrice,priceFormat)
out(priceString,priceFormat,priceParser)