Método Shapes.AddPicture (PowerPoint)

Artigo
04/07/2023

Cria uma imagem de um arquivo existente. Retorna um objeto Shape que representa a nova imagem.

Sintaxe

expression. AddPicture( _FileName_, _LinkToFile_, _SaveWithDocument_, _Left_, _Top_, _Width_, _Height_ )

expressão Uma variável que representa um objeto Formas.

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
FileName	Obrigatório	String	O arquivo a partir do qual o objeto OLE está para ser criado.
LinkToFile	Obrigatório	MsoTriState	Determina se a imagem será vinculada ao arquivo a partir do qual foi criada.
SaveWithDocument	Obrigatório	MsoTriState	Determina se a imagem vinculada será salva com o documento no qual ela é inserida. Esse argumento deve ser msoTrue se LinkToFile for msoFalse.
Left	Obrigatório	Single	A posição, medida em pontos, da borda esquerda da imagem em relação à borda esquerda do slide.
Top	Obrigatório	Single	A posição, medida em pontos, da borda superior da imagem em relação à borda superior do slide.
Width	Opcional	Single	A largura da imagem, medida em pontos.
Height	Opcional	Single	A altura da imagem, medida em pontos.

Valor de retorno

Forma

Exemplo

Este exemplo adiciona uma imagem criada a partir do arquivo Music.bmp a myDocument. A imagem inserida está vinculada ao arquivo a partir do qual foi criada e é salva com 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

Confira também

Objeto Shapes

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.

Compartilhar via