Cmdlet

Set-OfficePowerPointLayoutPlaceholderBounds

Aliases: PptLayoutPlaceholderBounds

Module: PSWriteOffice
Aliases: PptLayoutPlaceholderBounds
Inputs: OfficeIMO.PowerPoint.PowerPointPresentation
Outputs: OfficeIMO.PowerPoint.PowerPointTextBox
Source: SetOfficePowerPointLayoutPlaceholderBoundsCommand.cs:29 Edit on GitHub

Sets layout placeholder bounds for a slide layout.

Syntax

Set-OfficePowerPointLayoutPlaceholderBounds
[-CreateIfMissing]
-Height <Double>
[-Index <UInt32>]
-Layout <Int32>
-Left <Double>
[-Master <Int32>]
[-PassThru]
-PlaceholderType <PowerPointPlaceholderType>
[-Presentation <PowerPointPresentation>]
-Top <Double>
-Width <Double>
[<CommonParameters>]

Parameter set: All Parameter Sets

Examples

Update title placeholder bounds.

Set-OfficePowerPointLayoutPlaceholderBounds -Presentation $ppt -Master 0 -Layout 1 -PlaceholderType Title -Left 40 -Top 20 -Width 500 -Height 120

Moves/resizes the Title placeholder on the layout.

Update placeholder bounds inside the DSL.

New-OfficePowerPoint -Path .\deck.pptx {
  $layout = Get-OfficePowerPointLayout | Select-Object -First 1
  Set-OfficePowerPointLayoutPlaceholderBounds -Master $layout.MasterIndex -Layout $layout.LayoutIndex -PlaceholderType Title -Left 40 -Top 20 -Width 500 -Height 120
}

Uses the DSL context to resolve the presentation.

Parameters

-CreateIfMissing SwitchParameter optional: Create the placeholder if it is missing.
-Height Double required: Height in points.
-Index UInt32 optional: Optional placeholder index.
-Layout Int32 required: Layout index within the master.
-Left Double required: Left position in points.
-Master Int32 optional: Slide master index.
-PassThru SwitchParameter optional: Emit the placeholder textbox after update.
-PlaceholderType PowerPointPlaceholderType requiredaliases: Type: Placeholder type to target.; Possible values: Title, Body, CenteredTitle, SubTitle, DateAndTime, SlideNumber, Footer, Header, Object, Chart, Table, ClipArt, Diagram, Media, SlideImage, Picture
-Presentation PowerPointPresentation optionalpipeline: True (ByValue): Presentation to update (optional inside DSL).
-Top Double required: Top position in points.
-Width Double required: Width in points.

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.