PictureContentControl 介面

發行項
08/12/2011

表示會顯示影像的文件區域。

命名空間： Microsoft.Office.Tools.Word
組件： Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.dll 中)

語法

'宣告
<GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")> _
Public Interface PictureContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")]
public interface PictureContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

PictureContentControl 型別會公開下列成員。

屬性

	名稱	說明
	Application	取得 Microsoft.Office.Interop.Word.Application，代表 Microsoft Office Word 目前的執行個體。
	BindingContext	取得或設定 IBindableComponent 的 Currency 管理員集合。 (繼承自 IBindableComponent)。
	Container	基礎架構。 (繼承自 ContentControlBase)。
	ContainerComponent	基礎架構。 (繼承自 ContentControlBase)。
	Creator	取得 32 位元整數，表示在其中建立 PictureContentControl 的應用程式。
	DataBindings	取得這個 IBindableComponent 的資料繫結物件集合。 (繼承自 IBindableComponent)。
	DefaultDataSourceUpdateMode	取得或設定 ContentControlBase 的預設 DataSourceUpdateMode。 (繼承自 ContentControlBase)。
	ID	取得識別內容控制項的唯一號碼。 (繼承自 ContentControlBase)。
	Image	取得或設定 PictureContentControl 所顯示的影像。
	InnerObject	取得 Microsoft.Office.Tools.Word.ContentControlBase 的基礎 Microsoft.Office.Interop.Word.ContentControl 物件。 (繼承自 ContentControlBase)。
	LockContentControl	取得或設定值，這個值指定是否可以從文件中刪除 PictureContentControl。
	LockContents	取得或設定值，這個值指定是否可以編輯 PictureContentControl 的內容。
	Parent	取得 PictureContentControl 的父代 (Parent)。
	ParentContentControl	取得以巢狀方式置於另一個內容控制項中之 PictureContentControl 的父內容控制項。
	Range	取得 Range，表示 PictureContentControl 的內容。
	ShowInsertPictureIcon	取得或設定值，此值會指定是否要顯示 UI，可讓使用者按一下以選取執行階段要顯示在控制項中的影像。
	Site	取得或設定與 IComponent 相關聯的 ISite。 (繼承自 IComponent)。
	Tag	取得或設定要與 PictureContentControl 產生關聯的字串。
	Temporary	取得或設定值，這個值指定編輯 PictureContentControl 控制項時，是否會從文件中自動刪除此控制項。
	Title	取得或設定 PictureContentControl 的標題。
	XMLMapping	取得 XMLMapping，表示 PictureContentControl 和自訂 XML 組件的項目之間的繫結。

回頁首

方法

	名稱	說明
	BeginInit	表示物件正在啟動初始設定。 (繼承自 ISupportInitialize)。
	Copy	將 PictureContentControl 從文件複製到 [剪貼簿]。
	Cut	從文件移除 PictureContentControl 並將它加入至 [剪貼簿]。
	Delete	從文件中刪除動態建立的內容控制項，並從文件中的 ControlCollection 移除這個內容控制項。 (繼承自 ContentControlBase)。
	Dispose	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承自 IDisposable)。
	EndInit	表示物件已完成初始設定。 (繼承自 ISupportInitialize)。

回頁首

事件

	名稱	說明
	Added	在內容控制項加入至文件之後發生。 (繼承自 ContentControlBase)。
	BindingContextChanged	在 ContentControlBase 的 BindingContext 屬性值變更時發生。 (繼承自 ContentControlBase)。
	ContentUpdating	如果內容控制項已繫結至自訂 XML 組件，只在 Microsoft Office Word 更新內容控制項中的文字之前發生。 (繼承自 ContentControlBase)。
	Deleting	只在內容控制項從文件中刪除之前發生。 (繼承自 ContentControlBase)。
	Disposed	表示處理元件的 Disposed 事件的方法。 (繼承自 IComponent)。
	Entering	當使用者在內容控制項中按一下或以程式設計方式將游標移至內容控制項時發生。 (繼承自 ContentControlBase)。
	Exiting	當使用者在內容控制項外部按一下或以程式設計方式將游標移至內容控制項外部時發生。 (繼承自 ContentControlBase)。
	StoreUpdating	只在 Microsoft Office Word 更新已繫結至內容控制項之自訂 XML 組件中的資料之前發生 (也就是，在內容控制項中的文字變更之後)。 (繼承自 ContentControlBase)。
	Validated	在成功驗證內容控制項時發生。 (繼承自 ContentControlBase)。
	Validating	驗證內容控制項的內容時發生。 (繼承自 ContentControlBase)。

回頁首

備註

PictureContentControl 會顯示影像。您可以在設計階段或執行階段指定影像，或使用者可以按一下這個控制項，以選取要插入文件中的影像。

若要取得或設定影像，請使用 Image 屬性。根據預設，使用者不能在執行階段變更 PictureContentControl 中的影像。如果您要讓使用者選擇要顯示在控制項中的影像，請將 ShowInsertPictureIcon 屬性設定為 true。

注意事項
此介面是由 Visual Studio Tools for Office Runtime 所實作，並不能實作於您的程式碼中。如需詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。

內容控制項

PictureContentControl 是八種內容控制項型別的其中一個，可用來設計 Microsoft Office Word 中的文件和範本。內容控制項有一個使用者介面 (UI) 具有像表單一樣的受控制輸入。您可以使用內容控制項以避免使用者編輯文件或範本中被保護的區段，也可以將內容控制項繫結至資料來源。如需詳細資訊，請參閱內容控制項。

使用方式

本文件說明此型別用於以 .NET Framework 4 為目標之 Office 專案的版本。在以 .NET Framework 3.5 為目標的專案中，此型別可能會有不同的成員，而為此型別提供的程式碼範例可能無法運作。如需此型別在以 .NET Framework 3.5 為目標之專案中的相關文件，請參閱下列 Visual Studio 2008 文件中的參考章節：https://go.microsoft.com/fwlink/?LinkId=160658 (英文)。

範例

下列程式碼範例會將新的 PictureContentControl 加入至文件的開頭。本範例假設名為 picture.bmp 的檔案位於 %UserProfile%\My Documents 資料夾 (Windows XP 和舊版) 中，或是 %UserProfile%\Documents 資料夾 (Windows Vista) 中。

這是示範文件層級自訂的版本。若要使用這段程式碼，請將它貼到專案的 ThisDocument 類別中，並從 ThisDocument_Startup 方法呼叫 AddPictureControlAtSelection 方法。

Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap

Private Sub AddPictureControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    pictureControl1 = Me.Controls.AddPictureContentControl("pictureControl1")
    Dim imagePath As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
            "\picture.bmp"
    bitmap1 = New System.Drawing.Bitmap(imagePath, True)
    pictureControl1.Image = bitmap1
End Sub

private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;

private void AddPictureControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    pictureControl1 = this.Controls.AddPictureContentControl("pictureControl1");

    string imagePath = System.Environment.GetFolderPath(
        Environment.SpecialFolder.MyDocuments) + "\\picture.bmp";
    bitmap1 = new System.Drawing.Bitmap(imagePath, true);
    pictureControl1.Image = bitmap1;
}

這是示範應用程式層級增益集的版本。若要使用這段程式碼，請將它貼到專案的 ThisAddIn 類別中，並從 ThisAddIn_Startup 方法呼叫 AddPictureControlAtSelection 方法。

Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap

Private Sub AddPictureControlAtSelection()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1")
    Dim imagePath As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
            "\picture.bmp"
    bitmap1 = New System.Drawing.Bitmap(imagePath, True)
    pictureControl1.Image = bitmap1
End Sub

private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;

private void AddPictureControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1");

    string imagePath = System.Environment.GetFolderPath(
        Environment.SpecialFolder.MyDocuments) + "\\picture.bmp";
    bitmap1 = new System.Drawing.Bitmap(imagePath, true);
    pictureControl1.Image = bitmap1;
}