Shape.Export メソッド (PowerPoint)
指定したグラフィックス フィルターを使用して図形をエクスポートし、エクスポートしたファイルを指定したファイル名で保存します。
構文
式。Export(Parameters)
式: Shape オブジェクトを表す変数。
パラメーター
名前 | 必須 / オプション | データ型 | 説明 |
---|---|---|---|
PathName | 必須 | String | エクスポートしてディスクに保存するファイルの名前。 完全なパスを含めることができます。そうでない場合は、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 以降で使用できます。
Export メソッドは、バージョン 16.82 以降の macOS で使用できます。
例
次の例では、作業中のプレゼンテーションのすべての SVG 図形を SVG ファイルとしてユーザーの Pictures フォルダーにエクスポートします。 ExportMode パラメーターには、既定の PpRelativeToSlide 値が使用されます。これは、エクスポートされたイメージが
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 サイズで、960x540 ポイントです。 エクスポートされたイメージは、スライドのサイズの 2 倍のサイズで作成されます。
PathToFile = Environ("USERPROFILE") & "\Pictures\export.png"
With ActiveWindow.Selection.ShapeRange(1)
.Export PathToFile, ppShapeFormatPNG, 1920, 1080, ppRelativeToSlide
End With
関連項目
サポートとフィードバック
Office VBA またはこの説明書に関するご質問やフィードバックがありますか? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。