Shapes.AddPicture method (PowerPoint)
Creates a picture from an existing file. Returns a Shape object that represents the new picture.
Syntax
expression. AddPicture( _FileName_, _LinkToFile_, _SaveWithDocument_, _Left_, _Top_, _Width_, _Height_ )
expression A variable that represents a Shapes object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| FileName | Required | String | The file from which the OLE object is to be created. |
| LinkToFile | Required | MsoTriState | Determines whether the picture will be linked to the file from which it was created. |
| SaveWithDocument | Required | MsoTriState | Determines whether the linked picture will be saved with the document into which it is inserted. This argument must be msoTrue if LinkToFile is msoFalse. |
| Left | Required | Single | The position, measured in points, of the left edge of the picture relative to the left edge of the slide. |
| Top | Required | Single | The position, measured in points, of the top edge of the picture relative to the top edge of the slide. |
| Width | Optional | Single | The width of the picture, measured in points. |
| Height | Optional | Single | The height of the picture, measured in points. |
Return value
Shape
Example
This example adds a picture created from the file Music.bmp to myDocument. The inserted picture is linked to the file from which it was created and is saved with myDocument.
Set myDocument = ActivePresentation.Slides(1)
myDocument.Shapes.AddPicture FileName:="c:\microsoft office\" & _
"clipart\music.bmp", LinkToFile:=msoTrue, SaveWithDocument:=msoTrue, _
Left:=100, Top:=100, Width:=70, Height:=70
See also
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.