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

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.