Bookmark.PasteSpecial 方法
將 [剪貼簿] 的內容插入到 Bookmark 控制項。
命名空間: Microsoft.Office.Tools.Word
組件: Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.dll 中)
語法
'宣告
Sub PasteSpecial ( _
ByRef IconIndex As Object, _
ByRef Link As Object, _
ByRef Placement As Object, _
ByRef DisplayAsIcon As Object, _
ByRef DataType As Object, _
ByRef IconFileName As Object, _
ByRef IconLabel As Object _
)
void PasteSpecial(
ref Object IconIndex,
ref Object Link,
ref Object Placement,
ref Object DisplayAsIcon,
ref Object DataType,
ref Object IconFileName,
ref Object IconLabel
)
參數
- IconIndex
型別:System.Object%
如果 DisplayAsIcon 是 true,這個引數就會是一個數字,這個數字對應到您想在 IconFilename 所指定之程式檔案中使用的圖示。圖示會出現在 [變更圖示] 對話方塊:0 (零) 對應至第一個圖示、1 對應至第二個圖示,以此類推。如果省略這個引數,就會使用第一個 (預設) 圖示。
- Link
型別:System.Object%
若要與 [剪貼簿] 內容的來源檔案建立連結,則為 true。預設值是 false。
- Placement
型別:System.Object%
可以是下列其中一個 WdOLEPlacement 常數:wdFloatOverText 或 wdInLine。預設值是 wdInLine。
- DisplayAsIcon
型別:System.Object%
若要將連結顯示成圖示,則為 true。預設值是 false。
- DataType
型別:System.Object%
當 [剪貼簿] 內容插入至文件時的格式。WdPasteDataType.
- IconFileName
型別:System.Object%
如果 DisplayAsIcon 是 true,這個引數便是儲存所顯示圖示的檔案路徑和檔案名稱。
- IconLabel
型別:System.Object%
如果 DisplayAsIcon 是 true,這個引數便是出現在圖示下方的文字。
備註
與 Paste 方法不同,使用 PasteSpecial 可以讓您控制貼上資訊的格式,並且 (選擇性地) 建立與來源檔案 (例如:Microsoft Office Excel 工作表) 的連結。
呼叫這個方法可能會刪除 Bookmark 控制項。
選擇性參數
如需選擇性參數的詳細資訊,請參閱Office 方案中的選擇性參數。
範例
下列程式碼範例將 [剪貼簿] 內容當做未格式化的文字插入 Bookmark 控制項。 這個範例假設 [剪貼簿] 有一些文字。
這是示範文件層級自訂的範例。
Private Sub BookmarkPasteSpecial()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
Bookmark1.PasteSpecial(DataType:=Word.WdPasteDataType.wdPasteText)
End Sub
private void BookmarkPasteSpecial()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Bookmark bookmark1 =
this.Controls.AddBookmark(this.Paragraphs[1].Range,
"bookmark1");
object DataType = Word.WdPasteDataType.wdPasteText;
bookmark1.PasteSpecial(ref missing, ref missing, ref missing,
ref missing, ref DataType, ref missing, ref missing);
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。