PictureContentControl インターフェイス

[アーティクル]
05/14/2013

イメージを表示する文書領域を表します。

名前空間: 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 Word の現在のインスタンスを表す Microsoft.Office.Interop.Word.Application を取得します。
	BindingContext	IBindableComponent の CurrencyManager のコレクションを取得または設定します。 (IBindableComponent から継承されます。)
	Container	インフラストラクチャ。 (ContentControlBase から継承されます。)
	ContainerComponent	インフラストラクチャ。 (ContentControlBase から継承されます。)
	Creator	PictureContentControl が作成されたアプリケーションを示す 32 ビット整数を取得します。
	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 の親を取得します。
	ParentContentControl	別のコンテンツコントロールに入れ子になっている PictureContentControl の親コンテンツコントロールを取得します。
	Range	PictureContentControl のコンテンツを表す Range を取得します。
	ShowInsertPictureIcon	実行時にコントロールに表示するイメージをユーザーが選択できるようにする UI を表示するかどうかを指定する値を取得または設定します。
	Site	IComponent に関連付けられた ISite を取得または設定します。 (IComponent から継承されます。)
	Tag	PictureContentControl に関連付ける文字列を取得または設定します。
	Temporary	コントロールが編集されたときに文書から PictureContentControl を自動的に削除するかどうかを指定する値を取得または設定します。
	Title	PictureContentControl のタイトルを取得または設定します。
	XMLMapping	PictureContentControl とカスタム XML 部分にある要素の間のバインディングを表す XMLMapping を取得します。

このページのトップへ

メソッド

	名前	説明
	BeginInit	初期化の開始を通知するシグナルをオブジェクトに送信します。 (ISupportInitialize から継承されます。)
	Copy	文書からクリップボードに、PictureContentControl をコピーします。
	Cut	PictureContentControl を文書から削除し、クリップボードに追加します。
	Delete	動的に作成されたコンテンツコントロールを、文書から削除し、さらに文書内の ControlCollection から削除します。 (ContentControlBase から継承されます。)
	Dispose	アンマネージリソースの解放およびリセットに関連付けられているアプリケーション定義のタスクを実行します。 (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	コンテンツコントロールにバインドされているカスタム XML 部分にあるデータを Microsoft Office Word が更新する直前 (コンテンツコントロール内のテキストが変更された後) に発生します。 (ContentControlBase から継承されます。)
	Validated	コンテンツコントロールの検証が正常に完了したときに発生します。 (ContentControlBase から継承されます。)
	Validating	コンテンツコントロール内のコンテンツを検証中であるときに発生します。 (ContentControlBase から継承されます。)

このページのトップへ

解説

PictureContentControl は、イメージを表示します。イメージは、デザイン時または実行時に指定できます。また、このコントロールをクリックしてイメージを選択し、文書に挿入することも可能です。

イメージを取得または設定するには、Image プロパティを使用します。既定では、実行時にユーザーが PictureContentControl 内のイメージを変更することはできません。コントロールに表示するイメージをユーザーが選択できるようにするには、ShowInsertPictureIcon プロパティを true に設定します。

[!メモ]

これは、Visual Studio Tools for Office Runtime によって実装されたインターフェイスです。コードに実装されるものではありません。詳細については、「Visual Studio Tools for Office Runtime の概要」を参照してください。

コンテンツコントロール

Microsoft Office Word には、文書やテンプレートのデザインに使用できるコンテンツコントロールが 8 種類あります。PictureContentControl は、そのコンテンツコントロールの 1 つです。コンテンツコントロールには、フォームと同様に、入力を制御するユーザーインターフェイス (UI) があります。コンテンツコントロールを使用して、保護されている文書やテンプレートのセクションをユーザーが編集しないようにすることができます。また、コンテンツコントロールをデータソースにバインドすることも可能です。詳細については、「コンテンツコントロール」を参照してください。

使用方法

ここでは、.NET Framework 4 および .NET Framework 4.5 を対象とする 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;
}

参照

その他の技術情報

コンテンツコントロール

方法 : Word 文書にコンテンツコントロールを追加する

方法 : コンテンツコントロールを使用して文書を保護する

チュートリアル : コンテンツコントロールによるテンプレートの作成

チュートリアル : カスタム XML 部分へのコンテンツコントロールのバインド

次の方法で共有

PictureContentControl インターフェイス

構文

プロパティ

メソッド

イベント

解説

コンテンツコントロール

使用方法

例

参照

関連項目

その他の技術情報

その他のリソース

次の方法で共有

PictureContentControl インターフェイス

構文

プロパティ

メソッド

イベント

解説

コンテンツ コントロール

使用方法

例

参照

関連項目

その他の技術情報

その他のリソース

コンテンツコントロール