ControlCollection.AddDatePickerContentControl メソッド (Range, String)
新しい DatePickerContentControl を指定された範囲で文書に追加します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll 内)
構文
'宣言
Function AddDatePickerContentControl ( _
range As Range, _
name As String _
) As DatePickerContentControl
DatePickerContentControl AddDatePickerContentControl(
Range range,
string name
)
パラメーター
- range
型 : Microsoft.Office.Interop.Word.Range
新しいコントロールの境界線となる Range。
- name
型 : System.String
新しいコントロール名。
戻り値
型 : Microsoft.Office.Tools.Word.DatePickerContentControl
文書に追加された DatePickerContentControl。
例外
例外 | 条件 |
---|---|
ArgumentNullException | name が nullnull 参照 (Visual Basic では Nothing) であるか、または長さが 0 である場合。 |
ControlNameAlreadyExistsException | 同じ名前のコントロールが既に ControlCollection に存在する場合。 |
解説
このメソッドを使用して、実行時における文書の指定された範囲で新しい DatePickerContentControl を追加します。詳細については、「実行時の Office ドキュメントへのコントロールの追加」を参照してください。
例
次のコード例は、文書の先頭に新しい DatePickerContentControl を追加します。この例では、コントロールが表示する日付形式の変更も行います。
このバージョンは、ドキュメント レベルのカスタマイズに使用されます。このコードを使用するには、プロジェクトの ThisDocument クラスにコードを貼り付け、ThisDocument_Startup メソッドから AddDatePickerControlAtRange メソッドを呼び出します。
Dim datePickerControl2 As Microsoft.Office.Tools.Word.DatePickerContentControl
Private Sub AddDatePickerControlAtRange()
Me.Paragraphs(1).Range.InsertParagraphBefore()
datePickerControl2 = Me.Controls.AddDatePickerContentControl(Me.Paragraphs(1).Range, "datePickerControl2")
datePickerControl2.DateDisplayFormat = "MMMM d, yyyy"
datePickerControl2.PlaceholderText = "Choose a date"
End Sub
private Microsoft.Office.Tools.Word.DatePickerContentControl datePickerControl2;
private void AddDatePickerControlAtRange()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
datePickerControl2 = this.Controls.AddDatePickerContentControl(this.Paragraphs[1].Range,
"datePickerControl2");
datePickerControl2.DateDisplayFormat = "MMMM d, yyyy";
datePickerControl2.PlaceholderText = "Choose a date";
}
.NET Framework 4 か .NET Framework 4.5を対象とするこのバージョンは、アプリケーション レベルのアドインの場合) です。このコードを使用するには、プロジェクトの ThisAddIn クラスにコードを貼り付け、ThisAddIn_Startup メソッドから AddDatePickerControlAtRange メソッドを呼び出します。
Dim datePickerControl2 As Microsoft.Office.Tools.Word.DatePickerContentControl
Private Sub AddDatePickerControlAtRange()
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()
datePickerControl2 = vstoDoc.Controls.AddDatePickerContentControl( _
vstoDoc.Paragraphs(1).Range, "datePickerControl2")
datePickerControl2.DateDisplayFormat = "MMMM d, yyyy"
datePickerControl2.PlaceholderText = "Choose a date"
End Sub
private Microsoft.Office.Tools.Word.DatePickerContentControl datePickerControl2;
private void AddDatePickerControlAtRange()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
datePickerControl2 = vstoDoc.Controls.AddDatePickerContentControl(
vstoDoc.Paragraphs[1].Range,
"datePickerControl2");
datePickerControl2.DateDisplayFormat = "MMMM d, yyyy";
datePickerControl2.PlaceholderText = "Choose a date";
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
参照
関連項目
AddDatePickerContentControl オーバーロード
Microsoft.Office.Tools.Word 名前空間