Método Shape.Export (PowerPoint)

Exporta una forma mediante el filtro de gráficos especificado y guarda el archivo exportado con el nombre de archivo especificado.

Sintaxis

expresión. Export(Parameters)

expresión Variable que representa un objeto Shape.

Parameters

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
PathName	Obligatorio	Cadena	Nombre del archivo que se va a exportar y guardar en el disco. Puede incluir una ruta de acceso completa; si no es así, Microsoft PowerPoint creará un archivo dentro de la carpeta actual. Especifica cuánto se moverá el desplazamiento de la sombra horizontalmente, en puntos. Un valor positivo mueve la sombra hacia la derecha; un valor negativo la mueve hacia la izquierda.
Filter	Obligatorio	PpShapeFormat	Filtro gráfico que se va a usar en la creación del archivo de imagen exportado.
ScaleWidth	Opcional	Long	Ancho de la imagen en puntos. El valor predeterminado es el ancho de la diapositiva.
ScaleHeight	Opcional	Long	Alto de la imagen en puntos. El valor predeterminado es el alto de la diapositiva.
ExportMode	Opcional	ppExportMode	El método de escalado que se usa en la creación del archivo de imagen exportado. Si no se especifica, las dimensiones se escalarán en relación con el tamaño de la diapositiva.

Enumeraciones

Enumeración PpShapeFormat (PowerPoint)

Nombre	Valor	Descripción
ppShapeFormatBMP	3	Mapa de bits
ppShapeFormatEMF	5	Metarchivo mejorado
ppShapeFormatGIF	0	GIF estático
ppShapeFormatJPG	1	JPG comprimido
ppShapeFormatPNG	2	PNG sin pérdida
ppShapeFormatSVG	6	Gráfico vectorial escalable
ppShapeFormatWMF	4	Metarchivo de Windows

ExportMode (enumeración) (PowerPoint)

Nombre	Valor	Descripción
ppClipRelativeToSlide	2	Reservado para uso posterior.
ppRelativeToSlide	1	Escala la imagen con respecto a las dimensiones de la diapositiva
ppScaleToFit	3	Reservado para uso posterior.
ppScaleXY	4	Reservado para uso posterior.

Observaciones

PowerPoint usa el filtro de gráficos especificado para guardar cada forma individual. Los nombres de las formas exportadas y guardadas en el disco se determinan en el argumento PathName, que debe incluir la extensión de archivo correspondiente para el filtro de gráficos elegido.

Los parámetros ScaleWidth y ScaleHeight se usan para escalar el tamaño de imagen exportado en relación con las dimensiones de la diapositiva. Por ejemplo, si se crea una forma cuadrada de 1" sin formato en una diapositiva, se medirá como 72 puntos x 72 en el modelo de objetos. Cuando se exporta sin usar ningún factor de escala, se aplica la escala predeterminada de 1:1 y PowerPoint usará 96DPI para crear una imagen de 96 x 96 píxeles. Si se usa un factor de escala de 2x como se muestra en el ejemplo 2 siguiente, la imagen exportada será de 192 x 192 píxeles.

Si la diapositiva o la forma no están completamente descargadas, se produce un error en este método y se produce un error. Para obtener más información sobre los documentos parciales, vea Trabajar con documentos parciales.

Al exportar desde PowerPoint en macOS, los archivos deben crearse en la carpeta espacio aislado de Office o en la carpeta del espacio aislado de PowerPoint:

/Users/[username]/Library/Group Containers/UBF8T346G9.Office /Users/[username]/Library/Containers/com.microsoft.Powerpoint/Data

Si intenta usar una ruta de acceso fuera de estas ubicaciones de espacio aislado y se genera un error de automatización.

Disponibilidad

El filtro SVG está disponible en Windows versión 2302 y versiones posteriores.

El método Export está disponible en macOS en la versión 16.82 y posteriores.

Ejemplo

En el ejemplo siguiente se exportan todas las formas SVG de la presentación activa como archivos SVG a la carpeta Imágenes del usuario. El valor predeterminado de PpRelativeToSlide se usa para el parámetro ExportMode , lo que significa que la imagen 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 

En el ejemplo siguiente se usa la característica de escalado para exportar el objeto seleccionado en un tamaño relativo a la diapositiva. En este caso, la diapositiva es un tamaño estándar de 16:9 que es de 960 x 540 puntos. La imagen exportada se crea con el doble del tamaño de su tamaño en la diapositiva.

PathToFile = Environ("USERPROFILE") & "\Pictures\export.png"

With ActiveWindow.Selection.ShapeRange(1)
        .Export PathToFile, ppShapeFormatPNG, 1920, 1080, ppRelativeToSlide
End With

Consulte también

Objeto Shape

PageSetup.SlideHeight

PageSetup.SlideWidth

Trabajar con documentos parciales

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.