WorksheetBase.PasteSpecial 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將剪貼簿的內容以指定格式貼至工作表中。 使用這個方法可以從其他應用程式中貼上資料,或以特定格式貼上資料。
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)
參數
- format
- Object
字串,會指定資料的 [剪貼簿] 格式。 常見格式字串包括 "HTML"、「點陣圖」、「超連結」、「Unicode 文字」和「文字」。
- link
- Object
true
表示會連結至貼上資料的來源。 如果來源資料不適合連結,或來源應用程式不支援連結,則會忽略這個參數。 預設值是 false
。
- displayAsIcon
- Object
true
表示將貼上的物件顯示為圖示。 預設值是 false
。
- iconFileName
- Object
包含圖示的檔案名,如果 DisplayAsIcon
為 true
,則為 。
- iconIndex
- Object
圖示檔內的圖示索引編號。
- iconLabel
- Object
圖示的文字標籤。
- noHTMLFormatting
- Object
true
表示會移除 HTML 的所有格式、超連結和影像,false
則表示會直接貼上原有的 HTML。 預設值是 false
。
範例
下列程式代碼範例會將 HTML 放在剪貼簿上,然後使用 PasteSpecial 方法將剪貼簿的內容貼到單元格 A1 中。 請注意,此範例會在呼叫 PasteSpecial 方法之前選取範圍。
此範例適用於檔層級自定義。
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
備註
如果您不知道要傳遞至 Format 參數的字串,您可以嘗試在 Excel 中嘗試貼上命令,以檢視與剪貼簿上數據相容的字串。 將資料複製到剪貼簿、使用 Excel 中的 [貼上特殊 ] 命令,然後檢視 [ 貼上特殊 ] 對話框中所列的格式。
NoHTMLFormatting
只有在 = “HTML” 時才 Format
重要。 在所有其他情況下, NoHTMLFormatting
將會忽略。
使用此方法之前,您必須先選取目的地範圍。
此方法可能會根據剪貼簿的內容修改工作表選取範圍。
選擇性參數
如需選擇性參數的資訊,請參閱 Office 方案中的選擇性參數。