Método Shape.Export (PowerPoint)

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

Sintaxis

más sencilla.Exportar (parámetros)

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 El filtro de gráficos que se utilizará en la creación del archivo de imagen exportado.
ScaleWidth Opcional Long El ancho de la imagen en puntos. El valor predeterminado es el ancho de la diapositiva.
ScaleHeight Opcional Long La altura de la imagen en puntos. El valor predeterminado es la altura de la diapositiva.
ExportMode Opcional ppExportMode El método de escalado utilizado 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

Enumeración ExportMode (PowerPoint)

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

Comentarios

PowerPoint usa el filtro de gráficos especificado para guardar cada forma individual. Los nombres de las formas exportadas y guardadas en el disco están determinados por 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 la imagen exportada en relación con las dimensiones de la diapositiva. Por ejemplo, si se crea una forma cuadrada lisa de 1" en una diapositiva, medirá 72 x 72 puntos 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á 96 PPP 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 a continuación, la imagen exportada será de 192 x 192 píxeles.

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

Al exportar desde PowerPoint en macOS, los archivos deben crearse en la carpeta del 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 produce un error de automatización.

Disponibilidad

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

El método de exportación 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 PpRelativeToSlide predeterminado se usa para el parámetro ExportMode , lo que significa que la imagen exportada se


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 escala para exportar el objeto seleccionado a un tamaño relativo a la diapositiva. En este caso, la diapositiva tiene un tamaño estándar de 16:9 que es de 960 x 540 puntos. La imagen exportada se crea con el doble de tamaño que 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

Vea 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.

  • Last updated on