指定したグラフィック フィルターを使用して図形をエクスポートし、指定したファイル名でエクスポートしたファイルを保存します。
構文
式。Export(Parameters)
式: Shape オブジェクトを表す変数。
パラメーター
| 名前 | 必須 / オプション | データ型 | 説明 |
|---|---|---|---|
| PathName | 必須 | 文字列 | エクスポートしてディスクに保存するファイルの名前。 フル パスを含めることができます。これを行わない場合、Microsoft PowerPoint は現在のフォルダーにファイルを作成します。 影の相対位置の水平方向の移動量をポイント単位で指定します。 正の値を指定すると影は右方向に移動し、負の値を指定すると左方向に移動します。 |
| フィルター | 必須 | PpShapeFormat | エクスポートされた画像ファイルの作成に使用するグラフィック フィルター。 |
| ScaleWidth | 省略可能 | Long | 画像の幅 (ポイント単位)。 既定値はスライドの幅です。 |
| ScaleHeight | 省略可能 | Long | 画像の高さ (ポイント単位)。 既定値はスライドの高さです。 |
| ExportMode | 省略可能 | ppExportMode | エクスポートされた画像ファイルの作成で使用されるスケーリング方法。 指定しない場合、スライドのサイズに応じて寸法が拡大縮小されます。 |
列挙型
PpShapeFormat 列挙型 (PowerPoint)
| 名前 | 値 | 説明 |
|---|---|---|
| ppShapeFormatBMP | 3 | ビットマップ |
| ppShapeFormatEMF | 5 | 拡張メタファイル |
| ppShapeFormatGIF | 0 | 静的 GIF |
| ppShapeFormatJPG | 1 | 圧縮 JPG |
| ppShapeFormatPNG | 2 | ロスレス PNG |
| ppShapeFormatSVG | 6 | スケーラブル ベクター グラフィックス |
| ppShapeFormatWMF | 4 | Windows メタファイル |
ExportMode 列挙型 (PowerPoint)
| 名前 | 値 | 説明 |
|---|---|---|
| ppClipRelativeToSlide | 2 | 将来使用するために予約されています。 |
| ppRelativeToSlide | 1 | スライドのサイズを基準にして画像を拡大縮小します |
| ppScaleToFit | 3 | 将来使用するために予約されています。 |
| ppScaleXY | 4 | 将来使用するために予約されています。 |
注釈
PowerPoint は指定されたグラフィック フィルターを使用して個々の図形を保存します。 エクスポートされてディスクに保存される図形の名前は、PathName 引数で決まります。この引数には、選択したグラフィックス フィルターに対応するファイル拡張子を含める必要があります。
ScaleWidth パラメーターと ScaleHeight パラメーターは、スライドのサイズに対してエクスポートされた画像サイズを拡大縮小するために使用されます。 たとえば、スライドにプレーンな 1 インチの正方形の図形を作成した場合、オブジェクト モデルでは 72x72 ポイントとして測定されます。 スケール ファクターを使用せずにエクスポートすると、既定のスケールである 1:1 が適用され、PowerPoint は 96DPI を使用して 96x96 ピクセルの画像を作成します。 次の例 2 に示すように 2x のスケール ファクターを使用すると、エクスポートされた画像は 192x192 ピクセルになります。
スライドや図形が完全にダウンロードされていない場合、このメソッドは失敗し、エラーが発生します。 部分ドキュメントの詳細については、「 部分ドキュメントで作業する」を参照してください。
macOS 上の PowerPoint からエクスポートする場合、ファイルは Office サンドボックス フォルダーまたは PowerPoint サンドボックス フォルダーのいずれかに作成する必要があります。
/Users/[username]/Library/Group Containers/UBF8T346G9.Office
/Users/[username]/Library/Containers/com.microsoft.Powerpoint/Data
これらのサンドボックスの場所外のパスを使用しようとすると、自動化エラーが発生します。
Availability
SVG フィルターは、Windows バージョン 2302 以降で使用できます。
エクスポート方法は、バージョン 16.82 以降の macOS で使用できます。
例
次の例では、アクティブなプレゼンテーション内のすべての SVG 図形を SVG ファイルとしてユーザーの [画像] フォルダーにエクスポートします。 既定の PpRelativeToSlide 値は ExportMode パラメーターに使用されます。つまり、エクスポートされた画像は
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
次の例は、拡大縮小機能を使用して、選択したオブジェクトをスライドに対して相対的なサイズでエクスポートする操作です。 この場合、スライドは標準の 16:9 サイズ (960 x 540 ポイント) です。 エクスポートされた画像は、スライド上の 2 倍のサイズで作成されます。
PathToFile = Environ("USERPROFILE") & "\Pictures\export.png"
With ActiveWindow.Selection.ShapeRange(1)
.Export PathToFile, ppShapeFormatPNG, 1920, 1080, ppRelativeToSlide
End With
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。