Shapes.PasteSpecial メソッド (PowerPoint)

  • [アーティクル]

特定の形式でクリップボードの内容を貼り付けます。

構文

式。PasteSpecial (DataType、 DisplayAsIcon、 IconFileName、 IconIndex、 IconLabel、 Link)

表現Shapes オブジェクトを表す変数です。

パラメーター

名前 必須 / オプション データ型 説明
DataType 省略可能 PpPasteDataType ドキュメントに挿入するときのクリップボード内容の形式を指定します。 既定値は、クリップボードの内容によって異なります。 クリップボードの内容が引数 DataType で指定されたデータの形式をサポートしていない場合、エラーが発生します。
DisplayAsIcon 省略可能 MsoTriState 埋め込みオブジェクトまたはリンクをアイコンとして表示するのには 、msotrue を設定 をします。
IconFileName 省略可能 String DisplayAsIcon が msoTrue に設定されている場合この引数は、表示するアイコンが格納されるファイルのパスとファイル名です。 DisplayAsIcon が msoFalse に設定されている場合、この引数は無視されます。
IconIndex 省略可能 長整数型 (Long) DisplayAsIcon が msoTrue に設定されている場合この引数は、引数 IconFilename で指定したプログラム ファイルで使用するアイコンに対応する番号です。 たとえば、0 は最初のアイコン、1 は 2 番目のアイコンに対応します。 この引数を省略すると、最初 (既定) のアイコンが使用されます。 DisplayAsIcon が msoFalse に設定されている場合、この引数は無視されます。 IconIndex が有効な範囲外にある場合は、既定のアイコン (インデックス 0) が使用されます。
IconLabel 省略可能 String DisplayAsIcon が msoTrue に設定されている場合、この引数は、アイコンの下に表示されるテキストになります。 このラベルが存在しない場合は、PowerPoint には、クリップボードの内容に基づいてアイコン ラベルが生成されます。 DisplayAsIcon が msoFalse に設定されている場合、この引数は無視されます。
Link 省略可能 MsoTriState クリップボード内容のソース ファイルへのリンクを作成するかどうかを指定します。 クリップボードの内容がリンクをサポートしていない場合、エラーが発生します。

戻り値

ShapeRange

注釈

指定した形式で図形を図形コレクションに追加します。 指定したデータ型がテキスト データ型の場合は、テキスト付きで新しいテキスト ボックスが作成されます。 貼り付けが成功すると、PasteSpecial メソッドは貼り付けられた図形範囲を表す ShapeRange オブジェクトを返します。

DataType パラメーターの値に使用できるのは、次に示す PpPasteDataType クラスの定数のいずれかです。

  • ppPasteBitmap
  • ppPasteDefault
  • ppPasteEnhancedMetafile
  • ppPasteHTML
  • ppPasteGIF
  • ppPasteJPG
  • ppPasteMetafilePicture
  • ppPastePNG
  • ppPasteShape

DisplayAsIcon パラメーターの値に使用できるのは、次に示す MsoTriState クラスの定数のいずれかです。

定数 説明
msoFalse 既定値です。 埋め込みオブジェクトまたはリンクをアイコンで表示しません。
msoTrue 埋め込みオブジェクトまたはリンクをアイコンで表示します。

データがない、クリップボードで PasteSpecial メソッドが呼び出されたときにエラーが発生します。

ソース コンテンツが完全にダウンロードされていない場合、このメソッドは失敗し、エラーが発生します。 部分ドキュメントの詳細については、「部分ドキュメントを 操作する」を参照してください。

関連項目

Shapes オブジェクト

部分ドキュメントの操作

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。