ControlCollection.AddDatePickerContentControl Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
AddDatePickerContentControl(String) |
Přidá nový DatePickerContentControl u aktuálního výběru v dokumentu. |
AddDatePickerContentControl(ContentControl, String) |
Přidá do kolekce nový DatePickerContentControl . Nový ovládací prvek je založen na nativním ovládacím prvku obsahu, který je již v dokumentu. |
AddDatePickerContentControl(Range, String) |
Přidá nový DatePickerContentControl v zadaném rozsahu v dokumentu. |
AddDatePickerContentControl(String)
Přidá nový DatePickerContentControl u aktuálního výběru v dokumentu.
public:
Microsoft::Office::Tools::Word::DatePickerContentControl ^ AddDatePickerContentControl(System::String ^ name);
public Microsoft.Office.Tools.Word.DatePickerContentControl AddDatePickerContentControl (string name);
abstract member AddDatePickerContentControl : string -> Microsoft.Office.Tools.Word.DatePickerContentControl
Public Function AddDatePickerContentControl (name As String) As DatePickerContentControl
Parametry
- name
- String
Název nového ovládacího prvku
Návraty
Hodnota DatePickerContentControl přidaná do dokumentu.
Výjimky
name
je null
nebo má nulovou délku.
Ovládací prvek se stejným názvem je již v ControlCollectionsouboru .
Příklady
Následující příklad kódu přidá nový DatePickerContentControl na začátek dokumentu. Příklad také upraví formát, ve kterém ovládací prvek zobrazuje kalendářní data.
Tato verze je pro přizpůsobení na úrovni dokumentu. Pokud chcete tento kód použít, vložte ho ThisDocument
do třídy v projektu a volejte metodu AddDatePickerControlAtSelection
ThisDocument_Startup
z metody .
private Microsoft.Office.Tools.Word.DatePickerContentControl datePickerControl1;
private void AddDatePickerControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
datePickerControl1 = this.Controls.AddDatePickerContentControl("datePickerControl1");
datePickerControl1.DateDisplayFormat = "MMMM d, yyyy";
datePickerControl1.PlaceholderText = "Choose a date";
}
Dim datePickerControl1 As Microsoft.Office.Tools.Word.DatePickerContentControl
Private Sub AddDatePickerControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
datePickerControl1 = Me.Controls.AddDatePickerContentControl("datePickerControl1")
datePickerControl1.DateDisplayFormat = "MMMM d, yyyy"
datePickerControl1.PlaceholderText = "Choose a date"
End Sub
Tato verze je určena pro doplněk na úrovni aplikace, který cílí na rozhraní .NET Framework 4 nebo .NET Framework 4.5. Pokud chcete tento kód použít, vložte ho ThisAddIn
do třídy v projektu a volejte metodu AddDatePickerControlAtSelection
ThisAddIn_Startup
z metody .
private Microsoft.Office.Tools.Word.DatePickerContentControl datePickerControl1;
private void AddDatePickerControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
datePickerControl1 = vstoDoc.Controls.AddDatePickerContentControl("datePickerControl1");
datePickerControl1.DateDisplayFormat = "MMMM d, yyyy";
datePickerControl1.PlaceholderText = "Choose a date";
}
Dim datePickerControl1 As Microsoft.Office.Tools.Word.DatePickerContentControl
Private Sub AddDatePickerControlAtSelection()
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()
datePickerControl1 = vstoDoc.Controls.AddDatePickerContentControl("datePickerControl1")
datePickerControl1.DateDisplayFormat = "MMMM d, yyyy"
datePickerControl1.PlaceholderText = "Choose a date"
End Sub
Poznámky
Tato metoda slouží k přidání nového DatePickerContentControl do aktuálního výběru v dokumentu za běhu. Další informace najdete v tématu Přidání ovládacích prvků do dokumentů Office za běhu.
Platí pro
AddDatePickerContentControl(ContentControl, String)
Přidá do kolekce nový DatePickerContentControl . Nový ovládací prvek je založen na nativním ovládacím prvku obsahu, který je již v dokumentu.
public:
Microsoft::Office::Tools::Word::DatePickerContentControl ^ AddDatePickerContentControl(Microsoft::Office::Interop::Word::ContentControl ^ contentControl, System::String ^ name);
public Microsoft.Office.Tools.Word.DatePickerContentControl AddDatePickerContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);
abstract member AddDatePickerContentControl : Microsoft.Office.Interop.Word.ContentControl * string -> Microsoft.Office.Tools.Word.DatePickerContentControl
Public Function AddDatePickerContentControl (contentControl As ContentControl, name As String) As DatePickerContentControl
Parametry
- contentControl
- ContentControl
To ContentControl je základ nového ovládacího prvku.
- name
- String
Název nového ovládacího prvku
Návraty
Hodnota DatePickerContentControl přidaná do dokumentu.
Výjimky
contentControl
je null
.-or- name
je null
nebo má nulovou délku.
Ovládací prvek se stejným názvem je již v ControlCollectionsouboru .
contentControl
není galerie stavebních contentControl
bloků (to znamená, Type že vlastnost nemá hodnotu Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlDate).
Příklady
Následující příklad kódu vytvoří nový DatePickerContentControl pro každý ovládací prvek nativního data, který je v dokumentu.
Tato verze je pro přizpůsobení na úrovni dokumentu. Pokud chcete tento kód použít, vložte ho ThisDocument
do třídy v projektu a volejte metodu CreateDatePickerControlsFromNativeControls
ThisDocument_Startup
z metody .
private System.Collections.Generic.List
<Microsoft.Office.Tools.Word.DatePickerContentControl> datePickerControls;
private void CreateDatePickerControlsFromNativeControls()
{
datePickerControls = new System.Collections.Generic.List
<Microsoft.Office.Tools.Word.DatePickerContentControl>();
int count = 0;
foreach (Word.ContentControl nativeControl in this.ContentControls)
{
if (nativeControl.Type == Word.WdContentControlType.wdContentControlDate)
{
count++;
Microsoft.Office.Tools.Word.DatePickerContentControl tempControl =
this.Controls.AddDatePickerContentControl(nativeControl,
"VSTODatePickerContentControl" + count.ToString());
datePickerControls.Add(tempControl);
}
}
}
Private datePickerControls As New System.Collections.Generic.List _
(Of Microsoft.Office.Tools.Word.DatePickerContentControl)
Private Sub CreateDatePickerControlsFromNativeControls()
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.wdContentControlDate Then
count += 1
Dim tempControl As Microsoft.Office.Tools.Word.DatePickerContentControl = _
Me.Controls.AddDatePickerContentControl(nativeControl, _
"VSTODatePickerContentControl" + count.ToString())
datePickerControls.Add(tempControl)
End If
Next nativeControl
End Sub
Tato verze je určena pro doplněk na úrovni aplikace, který cílí na rozhraní .NET Framework 4 nebo .NET Framework 4.5. Pokud chcete tento kód použít, vložte ho ThisAddIn
do třídy v projektu a volejte metodu CreateDatePickerControlsFromNativeControls
ThisAddIn_Startup
z metody .
private System.Collections.Generic.List
<Microsoft.Office.Tools.Word.DatePickerContentControl> datePickerControls;
private void CreateDatePickerControlsFromNativeControls()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
datePickerControls = new System.Collections.Generic.List
<Microsoft.Office.Tools.Word.DatePickerContentControl>();
int count = 0;
foreach (Word.ContentControl nativeControl in vstoDoc.ContentControls)
{
if (nativeControl.Type == Word.WdContentControlType.wdContentControlDate)
{
count++;
Microsoft.Office.Tools.Word.DatePickerContentControl tempControl =
vstoDoc.Controls.AddDatePickerContentControl(nativeControl,
"VSTODatePickerContentControl" + count.ToString());
datePickerControls.Add(tempControl);
}
}
}
Private datePickerControls As New System.Collections.Generic.List _
(Of Microsoft.Office.Tools.Word.DatePickerContentControl)
Private Sub CreateDatePickerControlsFromNativeControls()
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.wdContentControlDate Then
count += 1
Dim tempControl As Microsoft.Office.Tools.Word.DatePickerContentControl = _
vstoDoc.Controls.AddDatePickerContentControl(nativeControl, _
"VSTODatePickerContentControl" + count.ToString())
datePickerControls.Add(tempControl)
End If
Next nativeControl
End Sub
Následující příklad kódu vytvoří nový DatePickerContentControl pro každý ovládací prvek nativního data, který uživatel přidá do dokumentu.
Tato verze je pro přizpůsobení na úrovni dokumentu. Pokud chcete tento kód použít, vložte ho ThisDocument
do třídy v projektu. Pro jazyk C# musíte také připojit obslužnou rutinu ThisDocument_DatePickerContentControlAfterAdd
události k ContentControlAfterAdd události ThisDocument
třídy.
void ThisDocument_DatePickerContentControlAfterAdd(Word.ContentControl NewContentControl, bool InUndoRedo)
{
if (NewContentControl.Type == Word.WdContentControlType.wdContentControlDate)
{
this.Controls.AddDatePickerContentControl(NewContentControl,
"DatePickerControl" + NewContentControl.ID);
}
}
Private Sub ThisDocument_DatePickerContentControlAfterAdd(ByVal NewContentControl As Word.ContentControl, _
ByVal InUndoRedo As Boolean) Handles Me.ContentControlAfterAdd
If NewContentControl.Type = Word.WdContentControlType.wdContentControlDate Then
Me.Controls.AddDatePickerContentControl(NewContentControl, _
"DatePickerControl" + NewContentControl.ID)
End If
End Sub
Pokud chcete tento kód použít, vložte ho ThisAddIn
do třídy v projektu. Také musíte připojit obslužnou rutinu ActiveDocument_DatePickerContentControlAfterAdd
události k ContentControlAfterAdd události aktivního dokumentu.
void ActiveDocument_DatePickerContentControlAfterAdd(
Word.ContentControl NewContentControl, bool InUndoRedo)
{
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
if (NewContentControl.Type == Word.WdContentControlType.wdContentControlDate)
{
vstoDoc.Controls.AddDatePickerContentControl(NewContentControl,
"DatePickerControl" + NewContentControl.ID);
}
}
Private Sub ActiveDocument_DatePickerContentControlAfterAdd( _
ByVal NewContentControl As Word.ContentControl, _
ByVal InUndoRedo As Boolean)
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
If NewContentControl.Type = Word.WdContentControlType. _
wdContentControlDate Then
vstoDoc.Controls.AddDatePickerContentControl(NewContentControl, _
"DatePickerControl" + NewContentControl.ID)
End If
End Sub
Poznámky
Tato metoda slouží k přidání nového DatePickerContentControl , který je založen na nativním ovládacím prvku obsahu v dokumentu za běhu. To je užitečné, když vytvoříte DatePickerContentControl za běhu a chcete stejný ovládací prvek znovu vytvořit při příštím otevření dokumentu. Další informace najdete v tématu Přidání ovládacích prvků do dokumentů Office za běhu.
Platí pro
AddDatePickerContentControl(Range, String)
Přidá nový DatePickerContentControl v zadaném rozsahu v dokumentu.
public:
Microsoft::Office::Tools::Word::DatePickerContentControl ^ AddDatePickerContentControl(Microsoft::Office::Interop::Word::Range ^ range, System::String ^ name);
public Microsoft.Office.Tools.Word.DatePickerContentControl AddDatePickerContentControl (Microsoft.Office.Interop.Word.Range range, string name);
abstract member AddDatePickerContentControl : Microsoft.Office.Interop.Word.Range * string -> Microsoft.Office.Tools.Word.DatePickerContentControl
Public Function AddDatePickerContentControl (range As Range, name As String) As DatePickerContentControl
Parametry
- name
- String
Název nového ovládacího prvku
Návraty
Hodnota DatePickerContentControl přidaná do dokumentu.
Výjimky
name
je null
nebo má nulovou délku.
Ovládací prvek se stejným názvem je již v ControlCollectionsouboru .
Příklady
Následující příklad kódu přidá nový DatePickerContentControl na začátek dokumentu. Příklad také upraví formát, ve kterém ovládací prvek zobrazuje kalendářní data.
Tato verze je pro přizpůsobení na úrovni dokumentu. Pokud chcete tento kód použít, vložte ho ThisDocument
do třídy v projektu a volejte metodu AddDatePickerControlAtRange
ThisDocument_Startup
z metody .
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";
}
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
Tato verze je určena pro doplněk na úrovni aplikace, který cílí na rozhraní .NET Framework 4 nebo .NET Framework 4.5. Pokud chcete tento kód použít, vložte ho ThisAddIn
do třídy v projektu a volejte metodu AddDatePickerControlAtRange
ThisAddIn_Startup
z metody .
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";
}
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
Poznámky
Tato metoda slouží k přidání nového DatePickerContentControl do zadaného rozsahu v dokumentu za běhu. Další informace najdete v tématu Přidání ovládacích prvků do dokumentů Office za běhu.