Compartilhar via


Método Shapes.AddPicture (Publisher)

Adiciona um novo objeto Shape que representa uma imagem à coleção Shapes especificada.

Sintaxe

expressão. 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 nome do arquivo de imagem a ser inserido na forma. O caminho pode ser absoluto ou relativo.
LinkToFile Obrigatório MsoTriState Determina se a imagem é vinculada ou incorporada na publicação.
SaveWithDocument Obrigatório MsoTriState Determina se a imagem é salva como um arquivo separado com a publicação.
Left Obrigatório Variant A posição da borda esquerda da forma que representa a imagem.
Top Obrigatório Variant A posição da borda superior da forma que representa a imagem.
Width Opcional Variant A largura da forma que representa a imagem. O padrão é -1, significando que a largura da forma é automaticamente definida com base nos dados do objeto.
Height Opcional Variant A altura da forma que representa a imagem. O padrão é -1, o que significa que a altura da forma é definida automaticamente com base nos dados do objeto.

Valor de retorno

Forma

Comentários

Se o argumento SaveWithDocument for msoTrue, o Microsoft Publisher salvará uma nova cópia do arquivo de imagem especificado pelo argumento FileName no mesmo diretório que a publicação.

Os argumentos LinkToFile e SaveWithDocument não podem ter o mesmo valor ou então ocorre um erro. Se algum argumento for msoTrue, o outro deve ser msoFalse.

Para os argumentos Esquerdo, Superior, Largura e Altura , os valores numéricos são avaliados em pontos; cadeias de caracteres podem estar em todas as unidades com suporte pelo Publisher (por exemplo, "2.5 in").

O parâmetro LinkToFile pode ser uma das constantes MsoTriState declaradas na biblioteca de tipos do Microsoft Office e mostradas na tabela a seguir.

Constante Descrição
msoFalse A imagem deve ser incorporada na publicação.
msoTrue A imagem deve ser vinculada à publicação.

Exemplo

O exemplo a seguir adiciona à publicação ativa uma imagem baseada em um arquivo existente; a imagem na publicação é vinculada a uma cópia do arquivo original. Observe que deve ser substituído por um caminho de arquivo válido para que PathToFile este exemplo funcione.

Dim shpPicture As Shape 
 
Set shpPicture = ActiveDocument.Pages(1).Shapes.AddPicture _ 
 (FileName:="PathToFile", _ 
 LinkToFile:=msoTrue, _ 
 SaveWithDocument:=msoFalse 
 Left:=72, Top:=72)

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.