Set-OfficePowerPointTableCell

Namespace PSWriteOffice

Inputs

System.Object

Outputs

OfficeIMO.PowerPoint.PowerPointTableCell

Source

Sources/PSWriteOffice/Cmdlets/PowerPoint/SetOfficePowerPointTableCellCommand.cs:29 Edit on GitHub

Sets text in an existing PowerPoint table cell.

Remarks

Accepts a PowerPointTable or a PowerPointShapeInfo record whose shape is a table. Row and column coordinates are zero-based, matching the OfficeIMO PowerPoint table API. Use this after Find-OfficePowerPointShape -Kind Table when a script needs to update a specific cell inside a deck that already exists.

Examples

Authored help example

Update a cell in a found table.

PS>


Find-OfficePowerPointShape -Presentation $ppt -Text 'Metric' -Kind Table |
                Set-OfficePowerPointTableCell -Row 1 -Column 1 -Text 'Ready'

Accepts a PowerPoint table or table shape metadata and updates a zero-based table cell.

Update a state cell after locating a readiness table.

PS>


$table = Find-OfficePowerPointShape -Presentation $ppt -Text 'Risk' -Kind Table | Select-Object -First 1
            $table | Set-OfficePowerPointTableCell -Row 1 -Column 1 -Text 'Mitigating'

Uses the table found by text content and updates the second row, second column.

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.

Syntax

Set-OfficePowerPointTableCell -Column <Int32> -InputObject <Object> [-PassThru] -Row <Int32> -Text <String> [<CommonParameters>]

Parameter set: Text

Parameters

Column Int32 requiredposition: namedpipeline: False: Zero-based column index.
InputObject Object requiredposition: 0pipeline: True (ByValue): PowerPoint table or table shape info returned by Find-OfficePowerPointShape or Get-OfficePowerPointShape.
PassThru SwitchParameter optionalposition: namedpipeline: False: Emit the updated table cell for additional OfficeIMO-level edits.
Row Int32 requiredposition: namedpipeline: False: Zero-based row index.
Text String requiredposition: namedpipeline: False: Replacement cell text. A null value clears the cell.

Outputs

OfficeIMO.PowerPoint.PowerPointTableCell

Set-OfficePowerPointTableCell -Column <Int32> -InputObject <Object> [-PassThru] -Row <Int32> -Run <Object[]> [<CommonParameters>]

Parameter set: Run

Parameters

Column Int32 requiredposition: namedpipeline: False: Zero-based column index.
InputObject Object requiredposition: 0pipeline: True (ByValue): PowerPoint table or table shape info returned by Find-OfficePowerPointShape or Get-OfficePowerPointShape.
PassThru SwitchParameter optionalposition: namedpipeline: False: Emit the updated table cell for additional OfficeIMO-level edits.
Row Int32 requiredposition: namedpipeline: False: Zero-based row index.
Run Object[] requiredposition: namedpipeline: Falsealiases: Runs: Replacement rich text runs. Each run can be created with TextRun/PowerPointTextRun or provided as a hashtable/object.

Outputs

OfficeIMO.PowerPoint.PowerPointTableCell