Cmdlet

Add-OfficePowerPointParagraph

Aliases: PowerPointParagraph

Module: PSWriteOffice
Aliases: PowerPointParagraph
Inputs: PSWriteOffice.Foundation.PowerPointSlideSelector
Outputs: OfficeIMO.PowerPoint.PowerPointParagraph
Source: AddOfficePowerPointParagraphCommand.cs:20 Edit on GitHub

Adds a plain or rich paragraph backed by native content before layout.

Syntax

Add-OfficePowerPointParagraph
[-Alignment <OfficeAlignment>]
[-Bold]
[-Color <OfficeColor>]
[-Column <Int32>]
[-Font <String>]
[-Height <OfficeLength>]
[-Highlight <OfficeColor>]
[-Italic]
[-PassThru]
[-Size <OfficeLength>]
[-Slide <PowerPointSlideSelector>]
[-SpacingAfter <OfficeLength>]
[-SpacingBefore <OfficeLength>]
[-Span <Int32>]
[-Strikethrough]
[-Text] <String>
[-Underline <PowerPointUnderlineStyle>]
[-Width <OfficeLength>]
[-X <OfficeLength>]
[-Y <OfficeLength>]
[<CommonParameters>]

Parameter set: Text

Add-OfficePowerPointParagraph
[-Alignment <OfficeAlignment>]
[-Column <Int32>]
[-Content] <ScriptBlock>
[-Height <OfficeLength>]
[-PassThru]
[-Slide <PowerPointSlideSelector>]
[-SpacingAfter <OfficeLength>]
[-SpacingBefore <OfficeLength>]
[-Span <Int32>]
[-Width <OfficeLength>]
[-X <OfficeLength>]
[-Y <OfficeLength>]
[<CommonParameters>]

Parameter set: Content

Examples

Capture and edit a designed paragraph.

PowerPointSlide -Title 'Status' {
    $paragraph = PowerPointParagraph { PowerPointText 'Healthy' -Bold } -PassThru
    $paragraph.AddText(' in all regions')
}

Parameters

-Alignment OfficeAlignment optional: Gets or sets paragraph alignment.; Possible values: Left, Center, Right, Justify, Start, End
-Bold SwitchParameter optionalsets: Text: Gets or sets whether plain text is bold.
-Color OfficeColor optionalsets: Text: Gets or sets the text color or theme role.
-Column Int32 optional: Gets or sets the one-based theme grid column; explicit X overrides its position.
-Font String optionalsets: Text: Gets or sets the font family.
-Height OfficeLength optional: Gets or sets the height; omission uses the native default for fixed placement.
-Highlight OfficeColor optionalsets: Text: Gets or sets the highlight color.
-Italic SwitchParameter optionalsets: Text: Gets or sets whether plain text is italic.
-PassThru SwitchParameter optional: Gets or sets whether to emit the live native paragraph.
-Size OfficeLength optionalsets: Text: Gets or sets the font size; numbers mean points.
-Slide PowerPointSlideSelector optionalpipeline: True (ByValue): Gets or sets a native slide or one-based position; omission uses the current slide block.
-SpacingAfter OfficeLength optional: Gets or sets space after the paragraph; numbers mean points.
-SpacingBefore OfficeLength optional: Gets or sets space before the paragraph; numbers mean points.
-Span Int32 optional: Gets or sets the grid column count; omission with Column uses twelve. Explicit Width overrides it.
-Strikethrough SwitchParameter optionalsets: Text: Gets or sets whether plain text has a strike through it.
-Text String requiredposition: 0sets: Text: Gets or sets the paragraph text.
-Underline PowerPointUnderlineStyle optionalsets: Text: Gets or sets the native underline style.; Possible values: Words, Single, Double, Heavy, Dotted, HeavyDotted, Dash, DashHeavy, DashLong, DashLongHeavy, DotDash, DotDashHeavy, DotDotDash, DotDotDashHeavy, Wavy, WavyHeavy, WavyDouble
-Width OfficeLength optional: Gets or sets the width; omission uses the native default for fixed placement.
-X OfficeLength optional: Gets or sets the left coordinate; numbers mean points.
-Y OfficeLength optional: Gets or sets the top coordinate; numbers mean points.
-Content ScriptBlock requiredposition: 0sets: Content: Gets or sets the block of native styled runs.

Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see about_CommonParameters.