WorksheetBase.PasteSpecial メソッド
クリップボードの内容を、指定された形式でワークシートに貼り付けます。他のアプリケーションからデータを貼り付ける場合、または特定の形式でデータを貼り付ける場合、このメソッドを使用します。
名前空間: Microsoft.Office.Tools.Excel
アセンブリ: Microsoft.Office.Tools.Excel.v4.0.Utilities (Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 内)
構文
'宣言
Public Sub PasteSpecial ( _
format As Object, _
link As Object, _
displayAsIcon As Object, _
iconFileName As Object, _
iconIndex As Object, _
iconLabel As Object, _
noHTMLFormatting As Object _
)
public void PasteSpecial(
Object format,
Object link,
Object displayAsIcon,
Object iconFileName,
Object iconIndex,
Object iconLabel,
Object noHTMLFormatting
)
パラメーター
- format
型 : System.Object
データのクリップボード形式を指定する文字列。"HTML"、"ビットマップ"、"ハイパーリンク"、"Unicode テキスト"、および "テキスト" を含む共通の書式指定文字列です。
- link
型 : System.Object
貼り付けられたデータの元のデータへのリンクを確立する場合は true です。コピー元のデータがリンクできない場合は、またはコピー元のアプリケーションがリンクをサポートしていない場合、このパラメーターは無視されます。既定値 false です。
- displayAsIcon
型 : System.Object
貼り付けられたオブジェクトをアイコンとして表示する場合は true です。既定値 false です。
- iconFileName
型 : System.Object
DisplayAsIcon が true の場合に使用するアイコンを含むファイルの名前です。
- iconIndex
型 : System.Object
アイコン ファイル内のアイコンのインデックス番号です。
- iconLabel
型 : System.Object
アイコンのテキスト ラベルです。
- noHTMLFormatting
型 : System.Object
すべての書式、ハイパーリンク、画像を HTML から削除する場合は true、HTML をそのまま貼り付ける場合は false です。既定値 false です。
解説
Format パラメーターに渡す文字列が不明の場合は、Excel で貼り付けコマンドを試みることによって、クリップボード上のデータと互換性のある文字列を表示できます。データをクリップボードにコピーし、Excel で [形式を選択して貼り付け] コマンドを使用し、[形式を選択して貼り付け] ダイアログ ボックスに書式一覧を表示します。
NoHTMLFormatting は、Format = "HTML" の場合のみ有効です。それ以外の場合は、NoHTMLFormatting は無視されます。
このメソッドを使用する前に、貼り付け先の範囲を選択する必要があります。
このメソッドは、クリップボードの内容によって、シートの選択内容を変更する可能性があります。
省略可能なパラメーター
省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。
例
次のコード例では、HTML をクリップボードにコピーし、PasteSpecial メソッドを使用してクリップボードの内容をセル A1 に貼り付けます。この例では、PasteSpecial メソッドを呼び出す前に範囲を選択しています。
この例は、ドキュメント レベルのカスタマイズ用に作成されています。
Private Sub PasteSpecialText()
Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" & _
"</STRONG></BODY></HTML>")
Me.Range("A1").Select()
Me.PasteSpecial(Link:=False, DisplayAsIcon:=False)
End Sub
private void PasteSpecialText()
{
Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" +
"</STRONG></BODY></HTML>");
this.Range["A1"].Select();
this.PasteSpecial(missing, false, false);
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。