PasteSpecial メソッド (PowerPoint)TextRange.PasteSpecial method (PowerPoint)

指定した形式でテキスト範囲をクリップボードの内容に置き換えます。Replaces the text range with the contents of the Clipboard in the format specified.

構文Syntax

expression.expression. PasteSpecial( _DataType_, _DisplayAsIcon_, _IconFileName_, _IconIndex_, _IconLabel_, _Link_ )

TextRangeオブジェクトを表す変数を取得します。expression A variable that represents a TextRange object.

パラメーターParameters

名前Name 必須 / オプションRequired/Optional データ型Data type 説明Description
DataTypeDataType オプションOptional PpPasteDataTypePpPasteDataType ドキュメントに挿入するときのクリップボード内容の形式を指定します。既定値は、クリップボードの内容によって異なります。クリップボードの内容が引数 DataType で指定されたデータの形式をサポートしていない場合、エラーが発生します。A format for the Clipboard contents when they're inserted into the document. The default value varies, depending on the contents in the Clipboard. An error occurs if the specified data type in the DataType argument is not supported by the clipboard contents.
DisplayAsIconDisplayAsIcon オプションOptional MsoTriStateMsoTriState 埋め込みオブジェクトまたはリンクをアイコンで表示するには、MsoTrue を設定します。MsoTrue to display the embedded object (or link) as an icon.
IconFileNameIconFileName 省略可Optional StringString 引数 DisplayAsIcon が定数 msoTrue に設定されている場合、この引数は表示するアイコンが保存されているファイルのパスとファイル名となります。引数 DisplayAsIcon が定数 msoFalse に設定されている場合、この引数は無視されます。If DisplayAsIcon is set to msoTrue, this argument is the path and file name for the file in which the icon to be displayed is stored. If DisplayAsIcon is set to msoFalse, this argument is ignored.
IconIndexIconIndex オプションOptional 長整数型 (Long)Long DisplayAsIcon が msoTrue に設定されている場合、この引数は IconFilename で指定したプログラム ファイル内で使用するアイコンに対応する番号になります。If DisplayAsIcon is set to msoTrue, this argument is a number that corresponds to the icon you want to use in the program file specified by IconFilename. たとえば、0 (ゼロ) は、最初のアイコンに対応して、1、2 番目のアイコンに対応します。For example, 0 (zero) corresponds to the first icon, 1 corresponds to the second icon. この引数を省略すると、最初の (既定) のアイコンが使用されます。If this argument is omitted, the first (default) icon is used. DisplayAsIcon が msoFalse に設定されている場合、この引数は無視されます。If DisplayAsIcon is set to msoFalse, then this argument is ignored. IconIndex が有効な範囲外にある場合は、既定のアイコン (インデックス 0) が使用されます。If IconIndex is outside the valid range, then the default icon (index 0) is used.
IconLabelIconLabel 省略可Optional StringString 引数 DisplayAsIcon が定数 msoTrue に設定されている場合、この引数はアイコンの下に表示されるテキストとなります。このラベルがない場合、クリップボードの内容に基づいてアイコン ラベルが作成されます。DisplayAsIcon が msoFalse に設定されている場合、この引数は無視されます。If DisplayAsIcon is set to msoTrue, this argument is the text that appears below the icon. If this label is missing, Microsoft PowerPoint generates an icon label based on the Clipboard contents. If DisplayAsIcon is set to msoFalse, then this argument is ignored.
リンクLink オプションOptional MsoTriStateMsoTriState クリップボード内容のソース ファイルへのリンクを作成するかどうかを指定します。クリップボードの内容がリンクをサポートしていない場合、エラーが発生します。Determines whether to create a link to the source file of the Clipboard contents. An error occurs if the Clipboard contents do not support a link.

戻り値Return value

TextRangeTextRange

解説Remarks

TextRangeオブジェクトの有効なデータ型は、 ppPasteTextppPasteHTML、およびpppaare tf (他の任意の形式ではエラーを生成します) です。Valid data types for the TextRange object are ppPasteText, ppPasteHTML, and ppPasteRTF (any other format generates an error). 貼り付けが正常に実行された場合、このメソッドは貼り付けられているテキスト範囲を表す TextRange オブジェクトを返します。If the paste succeeds, this method returns a TextRange object representing the text range that was pasted.

_DataType_パラメーターの値には、これらのPpPasteDataType定数のいずれかを指定できます。The DataType parameter value can be one of these PpPasteDataType constants.

ppPasteDefaultppPasteDefault
ppPasteHTMLppPasteHTML
pppaた tfppPasteRTF
ppPasteTextppPasteText

_DisplayAsIcon_パラメーターの値に使用できるのは、次に示すMsoTriStateクラスの定数のいずれかです。The DisplayAsIcon parameter value can be one of these MsoTriState constants.

定数Constant 説明Description
msoFalsemsoFalse 既定値です。埋め込みオブジェクトまたはリンクをアイコンで表示しません。The default. Does not display the embedded object (or link) as an icon.
msoTruemsoTrue 埋め込みオブジェクトまたはリンクをアイコンで表示します。Displays the embedded object (or link) as an icon.

PasteSpecial メソッドを呼び出したときにクリップボードにデータがないと、エラーが発生します。An error occurs if there is no data on the Clipboard when the PasteSpecial method is called.

関連項目See also

TextRange オブジェクトTextRange Object

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.