PictureContentControl インターフェイス
イメージを表示する文書領域を表します。
名前空間: 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 型で公開されるメンバーは以下のとおりです。
プロパティ
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック プロパティ") |
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 を取得します。 |
このページのトップへ
メソッド
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック メソッド") |
BeginInit | 初期化の開始を通知するシグナルをオブジェクトに送信します。 (ISupportInitialize から継承されます。) |
|
Copy | 文書からクリップボードに、PictureContentControl をコピーします。 |
|
Cut | PictureContentControl を文書から削除し、クリップボードに追加します。 |
|
Delete | 動的に作成されたコンテンツ コントロールを、文書から削除し、さらに文書内の ControlCollection から削除します。 (ContentControlBase から継承されます。) |
|
Dispose | アンマネージ リソースの解放およびリセットに関連付けられているアプリケーション定義のタスクを実行します。 (IDisposable から継承されます。) |
|
EndInit | 初期化の完了を通知するシグナルをオブジェクトに送信します。 (ISupportInitialize から継承されます。) |
このページのトップへ
イベント
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック イベント") |
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 ランタイムによって実装されたインターフェイスです。 コードに実装されるものではありません。 詳細については、「Visual Studio Tools for Office Runtime の概要」を参照してください。
コンテンツ コントロール
Microsoft Office Word には、文書やテンプレートのデザインに使用できるコンテンツ コントロールが 8 種類あります。PictureContentControl は、そのコンテンツ コントロールの 1 つです。 コンテンツ コントロールには、フォームと同様に、入力を制御するユーザー インターフェイス (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;
}
参照
参照
Microsoft.Office.Tools.Word 名前空間
その他の技術情報
方法 : Word 文書にコンテンツ コントロールを追加する