Cmdlet

Add-OfficePowerPointTable

Aliases: PowerPointTable

Module: PSWriteOffice
Aliases: PowerPointTable
Inputs: System.Object[]
Outputs: OfficeIMO.PowerPoint.PowerPointTable
Source: AddOfficePowerPointTableCommand.cs:25 Edit on GitHub

Adds a table to a PowerPoint slide.

Syntax

Add-OfficePowerPointTable
[-CollectionSeparator <String>]
[-Column <Int32>]
[-Culture <CultureInfo>]
[-DictionaryEntrySeparator <String>]
[-DictionaryKeyValueSeparator <String>]
[-Height <OfficeLength>]
[-InputObject] <Object[]>
[-MaxCollectionItems <Int32>]
[-MaxNestingDepth <Int32>]
[-MaxRows <Int32>]
[-NoHeader]
[-NoSplit]
[-PassThru]
[-Property <String[]>]
[-Slide <PowerPointSlideSelector>]
[-Span <Int32>]
[-Style <String>]
[-View <Normal|Transpose>]
[-Width <OfficeLength>]
[-X <OfficeLength>]
[-Y <OfficeLength>]
[<CommonParameters>]

Parameter set: InputObject

Add-OfficePowerPointTable
[-Column <Int32>]
-Columns <Int32>
[-Height <OfficeLength>]
[-PassThru]
-Rows <Int32>
[-Slide <PowerPointSlideSelector>]
[-Span <Int32>]
[-Style <String>]
[-Width <OfficeLength>]
[-X <OfficeLength>]
[-Y <OfficeLength>]
[<CommonParameters>]

Parameter set: Size

Description

Builds a table from data rows or creates a blank grid with a fixed size.

Examples

Create a table from objects.

$rows = @([pscustomobject]@{ Item='Alpha'; Qty=2 }, [pscustomobject]@{ Item='Beta'; Qty=4 })
Add-OfficePowerPointTable -Slide $slide -InputObject $rows -X 60 -Y 140 -Width 420 -Height 200

Creates a table with headers and two data rows.

Parameters

-CollectionSeparator String optionalsets: InputObject: Text used between items when a cell contains a collection.
-Column Int32 optional: One-based start column in the native twelve-column grid; explicit X overrides it.
-Culture CultureInfo optionalsets: InputObject: Culture for formatting data; lengths always parse invariantly.
-DictionaryEntrySeparator String optionalsets: InputObject: Text used between entries when a cell contains a dictionary.
-DictionaryKeyValueSeparator String optionalsets: InputObject: Text used between a dictionary key and value.
-Height OfficeLength optional: Table height; numbers mean points.
-InputObject Object[] requiredposition: 0pipeline: True (ByValue)sets: InputObject: Source objects to convert into table rows.
-MaxCollectionItems Int32 optionalsets: InputObject: Maximum number of items allowed in one nested collection or dictionary cell. Defaults to 1,048,575; increase explicitly for trusted larger values.
-MaxNestingDepth Int32 optionalsets: InputObject: Maximum nesting depth allowed while normalizing one cell value. Defaults to 64; increase explicitly for trusted deeper values.
-MaxRows Int32 optionalsets: InputObject: Maximum data rows per physical slide; omission uses the shared layout capacity.
-NoHeader SwitchParameter optionalsets: InputObject: Skip writing header row.
-NoSplit SwitchParameter optionalsets: InputObject: Keep the table together instead of generating continuation slides.
-PassThru SwitchParameter optional: Emit the object created or changed by the command.
-Property String[] optionalsets: InputObject: Optional header order to apply to the table.
-Slide PowerPointSlideSelector optional: Target slide that will receive the table (optional inside DSL).
-Span Int32 optional: Number of grid columns; defaults to twelve, and explicit Width overrides it.
-Style String optional: Native table style name or GUID; omission retains the native theme style.
-View OfficeTableView optionalsets: InputObject: Projection to apply before writing the table.; Possible values: Normal, Transpose
-Width OfficeLength optional: Table width; numbers mean points.
-X OfficeLength optional: Left offset from the slide origin; numbers mean points.
-Y OfficeLength optional: Top offset from the slide origin; numbers mean points.
-Columns Int32 requiredsets: Size: Column count for an empty table.
-Rows Int32 requiredsets: Size: Row count for an empty table.

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.