ComboBoxContentControl インターフェイス
文書内のコンボ ボックスを表します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll 内)
構文
'宣言
<GuidAttribute("fff2d316-e224-4cd9-a10c-3edf95689a6d")> _
Public Interface ComboBoxContentControl _
Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable, _
ISupportInitialize
[GuidAttribute("fff2d316-e224-4cd9-a10c-3edf95689a6d")]
public interface ComboBoxContentControl : ContentControlBase,
IBindableComponent, IComponent, IDisposable, ISupportInitialize
ComboBoxContentControl 型で公開されるメンバーは以下のとおりです。
プロパティ
名前 | 説明 | |
---|---|---|
Application | Microsoft Office Word の現在のインスタンスを表す Microsoft.Office.Interop.Word.Application を取得します。 | |
BindingContext | IBindableComponent の CurrencyManager のコレクションを取得または設定します。 (IBindableComponent から継承されます。) | |
Container | インフラストラクチャ。 (ContentControlBase から継承されます。) | |
ContainerComponent | インフラストラクチャ。 (ContentControlBase から継承されます。) | |
Creator | ComboBoxContentControl が作成されたアプリケーションを示す 32 ビット整数を取得します。 | |
DataBindings | このIBindableComponent のデータ バインディング オブジェクトのコレクションを取得します。 (IBindableComponent から継承されます。) | |
DefaultDataSourceUpdateMode | ContentControlBase の既定の DataSourceUpdateMode を取得または設定します。 (ContentControlBase から継承されます。) | |
DefaultTextStyle | ComboBoxContentControl 内のテキストへの書式設定に使用する、文字スタイルの名前を取得します。 | |
DropDownListEntries | ComboBoxContentControl によって表示される項目のコレクションを取得します。 | |
ID | コンテンツ コントロールを示す一意の数字を取得します。 (ContentControlBase から継承されます。) | |
InnerObject | Microsoft.Office.Tools.Word.ContentControlBase の基になる Microsoft.Office.Interop.Word.ContentControl オブジェクトを取得します。 (ContentControlBase から継承されます。) | |
LockContentControl | ComboBoxContentControl を文書から削除できるかどうかを指定する値を取得または設定します。 | |
LockContents | ComboBoxContentControl のコンテンツを編集できるかどうかを指定する値を取得または設定します。 | |
MultiLine | ComboBoxContentControl に改行を含めることができるかどうかを指定する値を取得または設定します。 | |
Parent | ComboBoxContentControl の親を取得します。 | |
ParentContentControl | 別のコンテンツ コントロールに入れ子になっている ComboBoxContentControl の親コンテンツ コントロールを取得します。 | |
PlaceholderText | ユーザーによる操作やその他の操作によってテキストが変更されない限り、ComboBoxContentControl に表示されるテキストを取得または設定します。 | |
Range | ComboBoxContentControl のコンテンツを表す Range を取得します。 | |
ShowingPlaceholderText | ComboBoxContentControl が現在表示されているプレースホルダー テキストであるかどうかを示す値を取得します。 | |
Site | IComponent に関連付けられた ISite を取得または設定します。 (IComponent から継承されます。) | |
Tag | ComboBoxContentControl に関連付ける文字列を取得または設定します。 | |
Temporary | コントロールが編集されたときに文書から ComboBoxContentControl を自動的に削除するかどうかを指定する値を取得または設定します。 | |
Text | ComboBoxContentControl 内のテキストを取得または設定します。 | |
Title | ComboBoxContentControl のタイトルを取得または設定します。 | |
XMLMapping | ComboBoxContentControl とカスタム XML 部分にある要素の間のバインディングを表す Microsoft.Office.Interop.Word.XMLMapping を取得します。 |
このページのトップへ
メソッド
名前 | 説明 | |
---|---|---|
BeginInit | 初期化の開始を通知するシグナルをオブジェクトに送信します。 (ISupportInitialize から継承されます。) | |
Copy | 文書からクリップボードに、ComboBoxContentControl をコピーします。 | |
Cut | ComboBoxContentControl を文書から削除し、クリップボードに追加します。 | |
Delete | 動的に作成されたコンテンツ コントロールを、文書から削除し、さらに文書内の ControlCollection から削除します。 (ContentControlBase から継承されます。) | |
Dispose | アンマネージ リソースの解放およびリセットに関連付けられているアプリケーション定義のタスクを実行します。 (IDisposable から継承されます。) | |
EndInit | 初期化の完了を通知するシグナルをオブジェクトに送信します。 (ISupportInitialize から継承されます。) | |
SetPlaceholderText | T:Microsoft.Office.Interop.Word.BuildingBlock、Range、または ComboBoxContentControl 内にプレースホルダー テキストとして存在する文字列にあるテキストを表示します。 |
このページのトップへ
イベント
名前 | 説明 | |
---|---|---|
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 から継承されます。) |
このページのトップへ
解説
ComboBoxContentControl は、ユーザーが選択できる項目の一覧を表示します。 ユーザーは、ComboBoxContentControl に独自のテキストを入力することもできます。
テキスト ボックスでユーザーが編集できない項目のドロップダウン リストを表示するには、DropDownListContentControl を使用します。
ComboBoxContentControl 内の項目の一覧にアクセスするには、DropDownListEntries プロパティを使用します。
注意
これは、Visual Studio Tools for Office ランタイムによって実装されたインターフェイスです。 コードに実装されるものではありません。 詳細については、「Visual Studio Tools for Office Runtime の概要」を参照してください。
コンテンツ コントロール
Microsoft Office Word には、文書やテンプレートのデザインに使用できるコンテンツ コントロールが 8 種類あります。ComboBoxContentControl は、そのコンテンツ コントロールの 1 つです。 コンテンツ コントロールには、フォームと同様に、入力を制御するユーザー インターフェイス (UI) があります。 コンテンツ コントロールを使用して、保護されている文書やテンプレートのセクションをユーザーが編集しないようにすることができます。また、コンテンツ コントロールをデータ ソースにバインドすることも可能です。 詳細については、「コンテンツ コントロール」を参照してください。
使用方法
ここでは、.NET Framework 4 を対象とする Office プロジェクトで使用される型のバージョンについて説明します。.NET Framework 3.5 を対象とするプロジェクトでは、この型のメンバーが異なること、およびこのコード例が動作しないことがあります。 .NET Framework 3.5 を対象とするプロジェクトの型の詳細については、Visual Studio 2008 ドキュメントの参照セクション https://go.microsoft.com/fwlink/?LinkId=160658 を参照してください。
例
次のコード例は、文書の先頭に新しい ComboBoxContentControl を追加します。 ユーザーは、コントロールで表示される色の名前を選択できます。または、新しい色の名前を入力できます。
このバージョンは、ドキュメント レベルのカスタマイズに使用されます。 このコードを使用するには、プロジェクトの ThisDocument クラスにコードを貼り付け、ThisDocument_Startup メソッドから AddComboBoxControlAtSelection メソッドを呼び出します。
Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl
Private Sub AddComboBoxControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
comboBoxControl1 = Me.Controls.AddComboBoxContentControl("comboBoxControl1")
With comboBoxControl1
.DropDownListEntries.Add("Red", "Red", 0)
.DropDownListEntries.Add("Green", "Green", 1)
.DropDownListEntries.Add("Blue", "Blue", 2)
.PlaceholderText = "Choose a color, or enter your own"
End With
End Sub
private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;
private void AddComboBoxControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
comboBoxControl1 = this.Controls.AddComboBoxContentControl("comboBoxControl1");
comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}
このバージョンは、アプリケーション レベルのアドインに使用されます。 このコードを使用するには、プロジェクトの ThisAddIn クラスにコードを貼り付け、ThisAddIn_Startup メソッドから AddComboBoxControlAtSelection メソッドを呼び出します。
Dim comboBoxControl1 As Microsoft.Office.Tools.Word.ComboBoxContentControl
Private Sub AddComboBoxControlAtSelection()
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()
comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl("comboBoxControl1")
With comboBoxControl1
.DropDownListEntries.Add("Red", "Red", 0)
.DropDownListEntries.Add("Green", "Green", 1)
.DropDownListEntries.Add("Blue", "Blue", 2)
.PlaceholderText = "Choose a color, or enter your own"
End With
End Sub
private Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl1;
private void AddComboBoxControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
comboBoxControl1 = vstoDoc.Controls.AddComboBoxContentControl(
"comboBoxControl1");
comboBoxControl1.DropDownListEntries.Add("Red", "Red", 0);
comboBoxControl1.DropDownListEntries.Add("Green", "Green", 1);
comboBoxControl1.DropDownListEntries.Add("Blue", "Blue", 2);
comboBoxControl1.PlaceholderText = "Choose a color, or enter your own";
}
参照
参照
Microsoft.Office.Tools.Word 名前空間