Cmdlet

Set-OfficePowerPointShapeLayout

Aliases: PptArrange, PptShapeLayout

Module PSWriteOffice

Aliases

PptArrange PptShapeLayout

Inputs

System.Object

Outputs

OfficeIMO.PowerPoint.PowerPointShape

Source

SetOfficePowerPointShapeLayoutCommand.cs:22 Edit on GitHub

Aligns, distributes, or arranges PowerPoint shapes using OfficeIMO layout helpers.

Syntax

Set-OfficePowerPointShapeLayout -Align <PowerPointShapeAlignment> [-InputObject] <Object> [-MarginPoints <Double>] [-PassThru] [-Slide <PowerPointSlide>] [-ToSlide] [<CommonParameters>]

Parameter set: Align

Set-OfficePowerPointShapeLayout [-Center] [-CrossAxisAlign <PowerPointShapeAlignment>] -Distribute <Horizontal|Vertical> [-InputObject] <Object> [-MarginPoints <Double>] [-PassThru] [-Slide <PowerPointSlide>] [-SpacingPoints <Double>] [-ToSlide] [<CommonParameters>]

Parameter set: Distribute

Set-OfficePowerPointShapeLayout [-AutoGrid] [-Columns <Int32>] [-Flow <RowMajor|ColumnMajor>] -Grid [-GutterXPoints <Double>] [-GutterYPoints <Double>] [-InputObject] <Object> [-MarginPoints <Double>] [-NoResize] [-PassThru] [-Rows <Int32>] [-Slide <PowerPointSlide>] [-ToSlide] [<CommonParameters>]

Parameter set: Grid

Examples

Authored help example

Align found shapes.

Find-OfficePowerPointShape -Slide $slide -Name 'Kpi.*' |
                Set-OfficePowerPointShapeLayout -Align Top

Uses OfficeIMO.PowerPoint to align all matching shapes to the top edge of their selection bounds.

Parameters

-Align PowerPointShapeAlignment requiredsets: Align: Alignment operation.; Possible values: Left, Center, Right, Top, Middle, Bottom
-InputObject Object requiredposition: 0pipeline: True (ByValue): PowerPoint shapes or shape info records from Get-OfficePowerPointShape or Find-OfficePowerPointShape.
-MarginPoints Double optional: Use slide content bounds with the supplied margin in points.
-PassThru SwitchParameter optional: Emit the arranged shapes.
-Slide PowerPointSlide optional: Slide that owns raw PowerPointShape inputs. Shape info records carry their own slide.
-ToSlide SwitchParameter optional: Use the full slide bounds instead of the current selection bounds.
-Center SwitchParameter optionalsets: Distribute: Center a fixed-spacing distribution within its bounds.
-CrossAxisAlign PowerPointShapeAlignment optionalsets: Distribute: Optional cross-axis alignment for even distribution.; Possible values: Left, Center, Right, Top, Middle, Bottom
-Distribute PowerPointShapeDistribution requiredsets: Distribute: Distribution operation.; Possible values: Horizontal, Vertical
-SpacingPoints Double optionalsets: Distribute: Fixed spacing between distributed shapes in points.
-AutoGrid SwitchParameter optionalsets: Grid: Let OfficeIMO choose the grid dimensions.
-Columns Int32 optionalsets: Grid: Grid column count. Omit with AutoGrid.
-Flow PowerPointShapeGridFlow optionalsets: Grid: Fill the grid column-by-column instead of row-by-row.; Possible values: RowMajor, ColumnMajor
-Grid SwitchParameter requiredsets: Grid: Arrange shapes in a grid.
-GutterXPoints Double optionalsets: Grid: Horizontal grid gutter in points.
-GutterYPoints Double optionalsets: Grid: Vertical grid gutter in points.
-NoResize SwitchParameter optionalsets: Grid: Keep each shape's current size when arranging in a grid.
-Rows Int32 optionalsets: Grid: Grid row count. Omit with AutoGrid.

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.