WorksheetBase.PasteSpecial Metode

Referensi

Definisi

Ruang nama:: Microsoft.Office.Tools.Excel

Rakitan:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menempelkan isi Papan Klip ke lembar kerja, menggunakan format yang ditentukan. Gunakan metode ini untuk menempelkan data dari aplikasi lain atau untuk menempelkan data dalam format tertentu.

public void PasteSpecial (object format, object link, object displayAsIcon, object iconFileName, object iconIndex, object iconLabel, object noHTMLFormatting);

member this.PasteSpecial : obj * obj * obj * obj * obj * obj * obj -> unit

Public Sub PasteSpecial (Optional format As Object, Optional link As Object, Optional displayAsIcon As Object, Optional iconFileName As Object, Optional iconIndex As Object, Optional iconLabel As Object, Optional noHTMLFormatting As Object)

Parameter

format: Object

String yang menentukan format Clipboard data. String format umum termasuk "HTML", "Bitmap", "Hyperlink", "Teks Unicode", dan "Teks".

link: Object

true untuk membuat tautan ke sumber data yang ditempelkan. Jika data sumber tidak cocok untuk penautan atau aplikasi sumber tidak mendukung penautan, parameter ini diabaikan. Nilai defaultnya adalah false.

displayAsIcon: Object

true untuk menampilkan objek yang ditempelkan sebagai ikon. Nilai defaultnya adalah false.

iconFileName: Object

Nama file yang berisi ikon yang akan digunakan jika DisplayAsIcon adalah true.

iconIndex: Object

Nomor indeks ikon dalam file ikon.

iconLabel: Object

Label teks ikon.

noHTMLFormatting: Object

true untuk menghapus semua pemformatan, hyperlink, dan gambar dari HTML; false untuk menempelkan HTML apa adanya. Nilai defaultnya adalah false.

Contoh

Contoh kode berikut menempatkan HTML ke Clipboard lalu menggunakan PasteSpecial metode untuk menempelkan konten Clipboard ke sel A1. Perhatikan bahwa contoh memilih rentang sebelum memanggil PasteSpecial metode .

Contoh ini untuk kustomisasi tingkat dokumen.

private void PasteSpecialText()
{
    Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" +
        "</STRONG></BODY></HTML>");

    this.Range["A1"].Select();
    this.PasteSpecial(missing, false, false);
}

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

Keterangan

Jika Anda tidak tahu string mana yang akan diteruskan ke parameter Format, Anda bisa menampilkan string yang kompatibel dengan data di Clipboard dengan mencoba perintah tempel di Excel . Salin data ke Clipboard, gunakan perintah Tempel Spesial di Excel, lalu tampilkan format yang tercantum dalam kotak dialog Tempel Spesial .

NoHTMLFormatting hanya akan penting ketika Format = "HTML". Dalam semua kasus lain, NoHTMLFormatting akan diabaikan.

Anda harus memilih rentang tujuan sebelum menggunakan metode ini.

Metode ini mungkin mengubah pilihan lembar, tergantung pada konten Clipboard.

Parameter Opsional

Untuk informasi tentang parameter opsional, lihat Parameter Opsional di Solusi Office.

Berlaku untuk

Bagikan melalui