Add-OfficePowerPointImage

Aliases: PptImage

Namespace PSWriteOffice

Aliases

PptImage

Inputs

OfficeIMO.PowerPoint.PowerPointSlide

Outputs

OfficeIMO.PowerPoint.PowerPointPicture

Source

Sources/PSWriteOffice/Cmdlets/PowerPoint/AddOfficePowerPointImageCommand.cs:24 Edit on GitHub

Adds an image to a PowerPoint slide.

Remarks

Places the picture at the requested coordinates using point measurements.

Examples

Authored help example

Example 1: Insert an image.

PS>


$image = '.\Tests\Assets\CellImage.png'
            New-OfficePowerPoint -Path .\Examples\Documents\PowerPointImage.pptx {
                $slide = Add-OfficePowerPointSlide -Layout 1
                Set-OfficePowerPointSlideTitle -Slide $slide -Title 'Evidence'
                Add-OfficePowerPointImage -Slide $slide -Path $image -X 60 -Y 130 -Width 180 -Height 120
            }

Adds a picture to a generated slide.

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

Add-OfficePowerPointImage [-Height <Double>] -Path <String> [-Slide <PowerPointSlide>] [-Width <Double>] [-X <Double>] [-Y <Double>] [<CommonParameters>]

Parameter set: All Parameter Sets

Parameters

Height Double optionalposition: namedpipeline: False: Image height in points.
Path String requiredposition: 0pipeline: False: Path to the image file.
Slide PowerPointSlide optionalposition: namedpipeline: True (ByValue): Target slide that will receive the picture (optional inside DSL).
Width Double optionalposition: namedpipeline: False: Image width in points.
X Double optionalposition: namedpipeline: False: Left offset (in points) from the slide origin.
Y Double optionalposition: namedpipeline: False: Top offset (in points) from the slide origin.

Outputs

OfficeIMO.PowerPoint.PowerPointPicture