Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Exporta uma forma, utilizando o filtro de gráficos especificado, e guarda o ficheiro exportado sob o nome de ficheiro especificado.
Sintaxe
expressão. Exportar(Parâmetros)
expressão Uma variável que representa um objeto Shape.
Parâmetros
| Nome | Obrigatório/Opcional | Tipo de dados | Descrição |
|---|---|---|---|
| PathName | Obrigatório | Cadeia de caracteres | O nome do arquivo a ser exportado e salvo em disco. Você pode incluir um caminho completo; se não o fizer, o Microsoft PowerPoint criará um arquivo na pasta atual. Especifica o quanto a sombra é deslocada horizontalmente, em pontos. Um valor positivo move a sombra para a direita; um valor negativo a move para a esquerda. |
| Filtro | Obrigatório | PpShapeFormat | O filtro gráfico a utilizar na criação do ficheiro de imagem exportado. |
| ScaleWidth | Opcional | Long | A largura da imagem em pontos. A predefinição é a largura do diapositivo. |
| ScaleHeight | Opcional | Long | A altura da imagem em pontos. A predefinição é a altura do diapositivo. |
| ExportMode | Opcional | ppExportMode | O método de dimensionamento utilizado na criação do ficheiro de imagem exportado. Se não for especificado, as dimensões serão dimensionadas relativamente ao tamanho do diapositivo. |
Enumerações
Enumeração PpShapeFormat (PowerPoint)
| Nome | Valor | Descrição |
|---|---|---|
| ppShapeFormatBMP | 3 | Bitmap |
| ppShapeFormatEMF | 5 | Metaficheiro Avançado |
| ppShapeFormatGIF | 0 | GIF Estático |
| ppShapeFormatJPG | 1 | JPG comprimido |
| ppShapeFormatPNG | 2 | PNG sem perda |
| ppShapeFormatSVG | 6 | Gráfico de Vetor Dimensionável |
| ppShapeFormatWMF | 4 | Windows Metafile |
Enumeração ExportMode (PowerPoint)
| Nome | Valor | Descrição |
|---|---|---|
| ppClipRelativeToSlide | 2 | Reservado para uso futuro |
| ppRelativeToSlide | 1 | Dimensiona a imagem relativamente às dimensões do diapositivo |
| ppScaleToFit | 3 | Reservado para uso futuro |
| ppScaleXY | 4 | Reservado para uso futuro |
Comentários
O PowerPoint utiliza o filtro de gráficos especificado para guardar cada forma individual. Os nomes das formas exportadas e guardadas no disco são determinados no argumento PathName, que deve incluir a extensão de ficheiro correspondente para o filtro gráfico escolhido.
Os parâmetros ScaleWidth e ScaleHeight são utilizados para dimensionar o tamanho da imagem exportada em relação às dimensões do diapositivo. Por exemplo, se for criada uma forma quadrada simples de 1" num diapositivo, será medida como 72 x 72 pontos no Modelo de Objeto. Quando exportado sem utilizar qualquer fator de dimensionamento, é aplicada a escala predefinida de 1:1 e o PowerPoint utilizará 96DPI para criar uma imagem de 96x96 píxeis. Se for utilizado um fator de dimensionamento de 2x, conforme mostrado no exemplo 2 abaixo, a imagem exportada será de 192x192 pixels.
Se o diapositivo e/ou a forma não estiverem totalmente transferidos, este método falhará e ocorrerá um erro. Para obter mais informações sobre Documentos Parciais, consulte Trabalhar com Documentos Parciais.
Ao exportar do PowerPoint para macOS, os ficheiros têm de ser criados na pasta sandbox do Office ou na pasta do sandbox do PowerPoint:
/Users/[username]/Library/Group Containers/UBF8T346G9.Office
/Users/[username]/Library/Containers/com.microsoft.Powerpoint/Data
Se tentar utilizar um caminho fora destas localizações do sandbox, é gerado um erro de automatização.
Disponibilidade
O filtro SVG está disponível no Windows versão 2302 e posterior.
O método Exportar está disponível no macOS na versão 16.82 e posterior.
Exemplo
O exemplo seguinte exporta todas as formas SVG na apresentação ativa como ficheiros SVG para a pasta Imagens do utilizador. O valor ppRelativeToSlide predefinido é utilizado para o parâmetro ExportMode , o que significa que a imagem exportada será
For Each oSld In ActivePresentation.Slides
For Each oShp In oSld.Shapes
If oShp.Type = msoGraphic Then
FileName = oShp.Name & ".svg"
PathToFolder = Environ("USERPROFILE") & "\Pictures\"
oShp.Export PathToFolder & FileName, ppShapeFormatSVG
End If
Next
Next
O exemplo seguinte utiliza a funcionalidade de dimensionamento para exportar o objeto selecionado com um tamanho em relação ao diapositivo. Neste caso, o diapositivo tem um tamanho padrão de 16:9, que é 960x540 pontos. A imagem exportada é criada com o dobro do tamanho no diapositivo.
PathToFile = Environ("USERPROFILE") & "\Pictures\export.png"
With ActiveWindow.Selection.ShapeRange(1)
.Export PathToFile, ppShapeFormatPNG, 1920, 1080, ppRelativeToSlide
End With
Confira também
Trabalhar com Documentos Parciais
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.