ControlCollection.AddDropDownListContentControl メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
AddDropDownListContentControl(String) |
ドキュメントの現在の選択範囲に新しい DropDownListContentControl を追加します。 |
AddDropDownListContentControl(ContentControl, String) |
新しい DropDownListContentControl をコレクションに追加します。 新しいコントロールは、ドキュメントに既に存在するネイティブ コンテンツ コントロールに基づいています。 |
AddDropDownListContentControl(Range, String) |
ドキュメント内の指定した範囲に新しい DropDownListContentControl を追加します。 |
AddDropDownListContentControl(String)
ドキュメントの現在の選択範囲に新しい DropDownListContentControl を追加します。
public:
Microsoft::Office::Tools::Word::DropDownListContentControl ^ AddDropDownListContentControl(System::String ^ name);
public Microsoft.Office.Tools.Word.DropDownListContentControl AddDropDownListContentControl (string name);
abstract member AddDropDownListContentControl : string -> Microsoft.Office.Tools.Word.DropDownListContentControl
Public Function AddDropDownListContentControl (name As String) As DropDownListContentControl
パラメーター
- name
- String
新しいコントロールの名前。
戻り値
ドキュメントに追加された DropDownListContentControl。
例外
name
は、null
であるか、または長さがゼロです。
ControlCollection に既に同じ名前のコントロールがあります。
例
次のコード例では、ドキュメントの先頭に新しい DropDownListContentControl を追加します。 また、この例では、ユーザーがコントロールで選択できる項目の一覧に数日間の名前を追加します。
このバージョンは、ドキュメント レベルのカスタマイズ用です。 このコードを使用するには、プロジェクトの ThisDocument
クラスに貼り付け、 メソッドから メソッドをAddDropDownListControlAtSelection
ThisDocument_Startup
呼び出します。
private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl1;
private void AddDropDownListControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
dropDownListControl1 = this.Controls.AddDropDownListContentControl("dropDownListControl1");
dropDownListControl1.DropDownListEntries.Add("Monday", "Monday", 0);
dropDownListControl1.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
dropDownListControl1.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
dropDownListControl1.PlaceholderText = "Choose a day";
}
Dim dropDownListControl1 As Microsoft.Office.Tools.Word.DropDownListContentControl
Private Sub AddDropDownListControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
dropDownListControl1 = Me.Controls.AddDropDownListContentControl("dropDownListControl1")
With dropDownListControl1
.DropDownListEntries.Add("Monday", "Monday", 0)
.DropDownListEntries.Add("Tuesday", "Tuesday", 1)
.DropDownListEntries.Add("Wednesday", "Wednesday", 2)
.PlaceholderText = "Choose a day"
End With
End Sub
このバージョンは、.NET Framework 4 または .NET Framework 4.5 を対象とするアプリケーション レベルのアドイン用です。 このコードを使用するには、プロジェクトの ThisAddIn
クラスに貼り付け、 メソッドから メソッドをAddDropDownListControlAtSelection
ThisAddIn_Startup
呼び出します。
private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl1;
private void AddDropDownListControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
dropDownListControl1 = vstoDoc.Controls.AddDropDownListContentControl("dropDownListControl1");
dropDownListControl1.DropDownListEntries.Add("Monday", "Monday", 0);
dropDownListControl1.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
dropDownListControl1.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
dropDownListControl1.PlaceholderText = "Choose a day";
}
Dim dropDownListControl1 As Microsoft.Office.Tools.Word.DropDownListContentControl
Private Sub AddDropDownListControlAtSelection()
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()
dropDownListControl1 = vstoDoc.Controls.AddDropDownListContentControl("dropDownListControl1")
With dropDownListControl1
.DropDownListEntries.Add("Monday", "Monday", 0)
.DropDownListEntries.Add("Tuesday", "Tuesday", 1)
.DropDownListEntries.Add("Wednesday", "Wednesday", 2)
.PlaceholderText = "Choose a day"
End With
End Sub
注釈
実行時に文書内の現在の選択範囲に新しい DropDownListContentControl を追加するには、このメソッドを使用します。 詳細については、「 Adding Controls to Office Documents at Run Time」を参照してください。
適用対象
AddDropDownListContentControl(ContentControl, String)
新しい DropDownListContentControl をコレクションに追加します。 新しいコントロールは、ドキュメントに既に存在するネイティブ コンテンツ コントロールに基づいています。
public:
Microsoft::Office::Tools::Word::DropDownListContentControl ^ AddDropDownListContentControl(Microsoft::Office::Interop::Word::ContentControl ^ contentControl, System::String ^ name);
public Microsoft.Office.Tools.Word.DropDownListContentControl AddDropDownListContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);
abstract member AddDropDownListContentControl : Microsoft.Office.Interop.Word.ContentControl * string -> Microsoft.Office.Tools.Word.DropDownListContentControl
Public Function AddDropDownListContentControl (contentControl As ContentControl, name As String) As DropDownListContentControl
パラメーター
- contentControl
- ContentControl
新しいコントロールのベースとなる ContentControl。
- name
- String
新しいコントロールの名前。
戻り値
ドキュメントに追加された DropDownListContentControl。
例外
contentControl
が null
.-or- name
または の null
長さが 0 です。
ControlCollection に既に同じ名前のコントロールがあります。
contentControl
は文書パーツ ギャラリーではありません (つまり、 Type の contentControl
プロパティに Microsoft.Office.Interop.Word の値がありません。WdContentControlType.wdContentControlDropdownList)。
例
次のコード例では、ドキュメント内のすべてのネイティブ ドロップダウン リストに対して新しい DropDownListContentControl を作成します。
このバージョンは、ドキュメント レベルのカスタマイズ用です。 このコードを使用するには、プロジェクトの ThisDocument
クラスに貼り付け、 メソッドから メソッドをCreateDropDownListControlsFromNativeControls
ThisDocument_Startup
呼び出します。
private System.Collections.Generic.List
<Microsoft.Office.Tools.Word.DropDownListContentControl> dropDownControls;
private void CreateDropDownListControlsFromNativeControls()
{
if (this.ContentControls.Count <= 0)
return;
dropDownControls = new System.Collections.Generic.List
<Microsoft.Office.Tools.Word.DropDownListContentControl>();
int count = 0;
foreach (Word.ContentControl nativeControl in this.ContentControls)
{
if (nativeControl.Type == Word.WdContentControlType.wdContentControlDropdownList)
{
count++;
Microsoft.Office.Tools.Word.DropDownListContentControl tempControl =
this.Controls.AddDropDownListContentControl(nativeControl,
"VSTODropDownListContentControl" + count.ToString());
dropDownControls.Add(tempControl);
}
}
}
Private dropDownListControls As New System.Collections.Generic.List _
(Of Microsoft.Office.Tools.Word.DropDownListContentControl)
Private Sub CreateDropDownListControlsFromNativeControls()
If Me.ContentControls.Count <= 0 Then
Return
End If
Dim count As Integer = 0
For Each nativeControl As Word.ContentControl In Me.ContentControls
If nativeControl.Type = Word.WdContentControlType.wdContentControlDropdownList Then
count += 1
Dim tempControl As Microsoft.Office.Tools.Word.DropDownListContentControl = _
Me.Controls.AddDropDownListContentControl(nativeControl, _
"VSTODropDownListContentControl" + count.ToString())
dropDownListControls.Add(tempControl)
End If
Next nativeControl
End Sub
このバージョンは、.NET Framework 4 または .NET Framework 4.5 を対象とするアプリケーション レベルのアドイン用です。 このコードを使用するには、アドイン プロジェクトの ThisAddIn
クラスに貼り付け、 メソッドから メソッドをCreateDropDownListControlsFromNativeControls
ThisAddIn_Startup
呼び出します。
private System.Collections.Generic.List
<Microsoft.Office.Tools.Word.DropDownListContentControl> dropDownControls;
private void CreateDropDownListControlsFromNativeControls()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
if (vstoDoc.ContentControls.Count <= 0)
return;
dropDownControls = new System.Collections.Generic.List
<Microsoft.Office.Tools.Word.DropDownListContentControl>();
int count = 0;
foreach (Word.ContentControl nativeControl in vstoDoc.ContentControls)
{
if (nativeControl.Type == Word.WdContentControlType.wdContentControlDropdownList)
{
count++;
Microsoft.Office.Tools.Word.DropDownListContentControl tempControl =
vstoDoc.Controls.AddDropDownListContentControl(nativeControl,
"VSTODropDownListContentControl" + count.ToString());
dropDownControls.Add(tempControl);
}
}
}
Private dropDownListControls As New System.Collections.Generic.List _
(Of Microsoft.Office.Tools.Word.DropDownListContentControl)
Private Sub CreateDropDownListControlsFromNativeControls()
If Me.Application.ActiveDocument Is Nothing Then
Return
End If
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
If vstoDoc.ContentControls.Count <= 0 Then
Return
End If
Dim count As Integer = 0
For Each nativeControl As Word.ContentControl In vstoDoc.ContentControls
If nativeControl.Type = Word.WdContentControlType.wdContentControlDropdownList Then
count += 1
Dim tempControl As Microsoft.Office.Tools.Word.DropDownListContentControl = _
vstoDoc.Controls.AddDropDownListContentControl(nativeControl, _
"VSTODropDownListContentControl" + count.ToString())
dropDownListControls.Add(tempControl)
End If
Next nativeControl
End Sub
次のコード例では、ユーザーがドキュメントに追加するすべてのネイティブ ドロップダウン リストに対して新しい DropDownListContentControl を作成します。
このバージョンは、ドキュメント レベルのカスタマイズ用です。 このコードを使用するには、プロジェクトの クラスに ThisDocument
貼り付けます。 C# の場合は、イベント ハンドラーを ThisDocument_DropDownListContentControlAfterAdd
クラスの ThisDocument
イベントにContentControlAfterAddアタッチする必要もあります。
void ThisDocument_DropDownListContentControlAfterAdd(Word.ContentControl NewContentControl, bool InUndoRedo)
{
if (NewContentControl.Type == Word.WdContentControlType.wdContentControlDropdownList)
{
this.Controls.AddDropDownListContentControl(NewContentControl,
"DropDownListControl" + NewContentControl.ID);
}
}
Private Sub ThisDocument_DropDownListContentControlAfterAdd(ByVal NewContentControl As Word.ContentControl, _
ByVal InUndoRedo As Boolean) Handles Me.ContentControlAfterAdd
If NewContentControl.Type = Word.WdContentControlType.wdContentControlDropdownList Then
Me.Controls.AddDropDownListContentControl(NewContentControl, _
"DropDownListControl" + NewContentControl.ID)
End If
End Sub
このバージョンは、.NET Framework 4 または .NET Framework 4.5 を対象とするアプリケーション レベルのアドイン用です。 このコードを使用するには、プロジェクトの クラスに ThisAddIn
貼り付けます。 また、作業中の文書の ActiveDocument_DropDownListContentControlAfterAdd
イベントにイベント ハンドラーを ContentControlAfterAdd アタッチする必要があります。
void ActiveDocument_DropDownListContentControlAfterAdd(
Word.ContentControl NewContentControl, bool InUndoRedo)
{
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
if (NewContentControl.Type == Word.WdContentControlType.wdContentControlDropdownList)
{
vstoDoc.Controls.AddDropDownListContentControl(NewContentControl,
"DropDownListControl" + NewContentControl.ID);
}
}
Private Sub ActiveDocument_DropDownListContentControlAfterAdd( _
ByVal NewContentControl As Word.ContentControl, _
ByVal InUndoRedo As Boolean)
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
If NewContentControl.Type = Word.WdContentControlType. _
wdContentControlDropdownList Then
vstoDoc.Controls.AddDropDownListContentControl(NewContentControl, _
"DropDownListControl" + NewContentControl.ID)
End If
End Sub
注釈
実行時にドキュメント内のネイティブ コンテンツ コントロールに基づく新しい DropDownListContentControl を追加するには、このメソッドを使用します。 これは、実行時に を DropDownListContentControl 作成し、次にドキュメントを開いたときに同じコントロールを再作成する場合に便利です。 詳細については、「 Adding Controls to Office Documents at Run Time」を参照してください。
適用対象
AddDropDownListContentControl(Range, String)
ドキュメント内の指定した範囲に新しい DropDownListContentControl を追加します。
public:
Microsoft::Office::Tools::Word::DropDownListContentControl ^ AddDropDownListContentControl(Microsoft::Office::Interop::Word::Range ^ range, System::String ^ name);
public Microsoft.Office.Tools.Word.DropDownListContentControl AddDropDownListContentControl (Microsoft.Office.Interop.Word.Range range, string name);
abstract member AddDropDownListContentControl : Microsoft.Office.Interop.Word.Range * string -> Microsoft.Office.Tools.Word.DropDownListContentControl
Public Function AddDropDownListContentControl (range As Range, name As String) As DropDownListContentControl
パラメーター
- name
- String
新しいコントロールの名前。
戻り値
ドキュメントに追加された DropDownListContentControl。
例外
name
は、null
であるか、または長さがゼロです。
ControlCollection に既に同じ名前のコントロールがあります。
例
次のコード例では、ドキュメントの先頭に新しい DropDownListContentControl を追加します。 また、この例では、ユーザーがコントロールで選択できる項目の一覧に数日間の名前を追加します。
このバージョンは、ドキュメント レベルのカスタマイズ用です。 このコードを使用するには、プロジェクトの ThisDocument
クラスに貼り付け、 メソッドから メソッドをAddDropDownListControlAtRange
ThisDocument_Startup
呼び出します。
private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl2;
private void AddDropDownListControlAtRange()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
dropDownListControl2 = this.Controls.AddDropDownListContentControl(this.Paragraphs[1].Range,
"dropDownListControl2");
dropDownListControl2.DropDownListEntries.Add("Monday", "Monday", 0);
dropDownListControl2.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
dropDownListControl2.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
dropDownListControl2.PlaceholderText = "Choose a day";
}
Dim dropDownListControl2 As Microsoft.Office.Tools.Word.DropDownListContentControl
Private Sub AddDropDownListControlAtRange()
Me.Paragraphs(1).Range.InsertParagraphBefore()
dropDownListControl2 = Me.Controls.AddDropDownListContentControl(Me.Paragraphs(1).Range, _
"dropDownListControl2")
With dropDownListControl2
.DropDownListEntries.Add("Monday", "Monday", 0)
.DropDownListEntries.Add("Tuesday", "Tuesday", 1)
.DropDownListEntries.Add("Wednesday", "Wednesday", 2)
.PlaceholderText = "Choose a day"
End With
End Sub
このバージョンは、.NET Framework 4 または .NET Framework 4.5 を対象とするアプリケーション レベルのアドイン用です。 このコードを使用するには、プロジェクトの ThisAddIn
クラスに貼り付け、 メソッドから メソッドをAddDropDownListControlAtRange
ThisAddIn_Startup
呼び出します。
private Microsoft.Office.Tools.Word.DropDownListContentControl dropDownListControl2;
private void AddDropDownListControlAtRange()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
dropDownListControl2 = vstoDoc.Controls.AddDropDownListContentControl(
vstoDoc.Paragraphs[1].Range,
"dropDownListControl2");
dropDownListControl2.DropDownListEntries.Add("Monday", "Monday", 0);
dropDownListControl2.DropDownListEntries.Add("Tuesday", "Tuesday", 1);
dropDownListControl2.DropDownListEntries.Add("Wednesday", "Wednesday", 2);
dropDownListControl2.PlaceholderText = "Choose a day";
}
Dim dropDownListControl2 As Microsoft.Office.Tools.Word.DropDownListContentControl
Private Sub AddDropDownListControlAtRange()
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()
dropDownListControl2 = vstoDoc.Controls.AddDropDownListContentControl( _
vstoDoc.Paragraphs(1).Range, _
"dropDownListControl2")
With dropDownListControl2
.DropDownListEntries.Add("Monday", "Monday", 0)
.DropDownListEntries.Add("Tuesday", "Tuesday", 1)
.DropDownListEntries.Add("Wednesday", "Wednesday", 2)
.PlaceholderText = "Choose a day"
End With
End Sub
注釈
実行時にドキュメント内の指定した範囲に新しい DropDownListContentControl を追加するには、このメソッドを使用します。 詳細については、「 Adding Controls to Office Documents at Run Time」を参照してください。