Cmdlet

Set-OfficePowerPointLayoutPlaceholder

Module: PSWriteOffice
Inputs: OfficeIMO.PowerPoint.PowerPointDocument
Outputs: OfficeIMO.PowerPoint.PowerPointTextBox
Source: SetOfficePowerPointLayoutPlaceholderCommand.cs:18 Edit on GitHub

Updates a template layout placeholder's geometry, text margins and text style.

Syntax

Set-OfficePowerPointLayoutPlaceholder
[-Bold]
[-BulletChar <String>]
[-Color <OfficeColor>]
[-CreateIfMissing]
[-Document <PowerPointDocument>]
[-Font <String>]
[-Height <OfficeLength>]
[-Highlight <OfficeColor>]
[-Index <UInt32>]
[-Italic]
[-Level <Int32>]
[-Master <Int32>]
[-Numbering <PowerPointNumberingScheme>]
[-PassThru]
[-Size <OfficeLength>]
[-Style <Title|Subtitle|Body|Caption|Emphasis>]
-TemplateLayout <PowerPointLayoutSelector>
[-TextMargin <OfficeLength[]>]
-Type <PowerPointPlaceholderType>
[-Underline <PowerPointUnderlineStyle>]
[-Width <OfficeLength>]
[-X <OfficeLength>]
[-Y <OfficeLength>]
[<CommonParameters>]

Parameter set: Document

Description

Omitted properties keep their current values. Master and layout positions start at one. Numbers mean points; text margins use one, two or four values in CSS order.

Examples

Adjust a template title area and style.

Set-OfficePowerPointLayoutPlaceholder -Document $deck -TemplateLayout 'Title and Content' -Type Title -X 2cm -Width 24cm -TextMargin 6pt,8pt -Size 32pt -Bold

Parameters

-Bold SwitchParameter optional: Gets or sets bold formatting; an explicitly false switch clears it.
-BulletChar String optional: Gets or sets a single bullet character, exclusive with Numbering.
-Color OfficeColor optional: Gets or sets text color, resolving theme roles against the selected master.
-CreateIfMissing SwitchParameter optional: Gets or sets whether to create a missing placeholder.
-Document PowerPointDocument optionalpipeline: True (ByValue): Gets or sets an explicit live document; omission uses the enclosing content block.
-Font String optional: Gets or sets the Latin font family.
-Height OfficeLength optional: Gets or sets the positive placeholder height.
-Highlight OfficeColor optional: Gets or sets the highlight color.
-Index UInt32 optional: Gets or sets the optional native placeholder index.
-Italic SwitchParameter optional: Gets or sets italic formatting; an explicitly false switch clears it.
-Level Int32 optional: Gets or sets the zero-based paragraph indentation level.
-Master Int32 optional: Gets or sets the one-based master position, defaulting to the first or to the layout metadata's master.
-Numbering PowerPointNumberingScheme optional: Gets or sets the native numbering scheme, exclusive with BulletChar.; Possible values: AlphaLowerCharacterParenBoth, AlphaUpperCharacterParenBoth, AlphaLowerCharacterParenR, AlphaUpperCharacterParenR, AlphaLowerCharacterPeriod, AlphaUpperCharacterPeriod, ArabicParenBoth, ArabicParenR, ArabicPeriod, ArabicPlain, RomanLowerCharacterParenBoth, RomanUpperCharacterParenBoth, RomanLowerCharacterParenR, RomanUpperCharacterParenR, RomanLowerCharacterPeriod, RomanUpperCharacterPeriod, CircleNumberDoubleBytePlain, CircleNumberWingdingsBlackPlain, CircleNumberWingdingsWhitePlain, ArabicDoubleBytePeriod, ArabicDoubleBytePlain, EastAsianSimplifiedChinesePeriod, EastAsianSimplifiedChinesePlain, EastAsianTraditionalChinesePeriod, EastAsianTraditionalChinesePlain, EastAsianJapaneseDoubleBytePeriod, EastAsianJapaneseKoreanPlain, EastAsianJapaneseKoreanPeriod, Arabic1Minus, Arabic2Minus, Hebrew2Minus, ThaiAlphaPeriod, ThaiAlphaParenthesisRight, ThaiAlphaParenthesisBoth, ThaiNumberPeriod, ThaiNumberParenthesisRight, ThaiNumberParenthesisBoth, HindiAlphaPeriod, HindiNumPeriod, HindiNumberParenthesisRight, HindiAlpha1Period
-PassThru SwitchParameter optional: Gets or sets whether to emit the updated native text box.
-Size OfficeLength optional: Gets or sets the font size, from one through 4000 points.
-Style String optional: Gets or sets a native text preset.; Possible values: Title, Subtitle, Body, Caption, Emphasis
-TemplateLayout PowerPointLayoutSelector required: Gets or sets a layout name, one-based position, native type or returned layout metadata.
-TextMargin OfficeLength[] optional: Gets or sets margins: all; vertical,horizontal; or top,right,bottom,left.
-Type PowerPointPlaceholderType required: Gets or sets the placeholder type.; Possible values: Title, Body, CenteredTitle, SubTitle, DateAndTime, SlideNumber, Footer, Header, Object, Chart, Table, ClipArt, Diagram, Media, SlideImage, Picture
-Underline PowerPointUnderlineStyle optional: Gets or sets the native underline style; None removes underlining.; 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 positive placeholder width.
-X OfficeLength optional: Gets or sets the left position; negative positions are allowed.
-Y OfficeLength optional: Gets or sets the top position; negative positions are allowed.

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.