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.