ControlCollection.AddDatePickerContentControl Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Word

Zestawy:: Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

AddDatePickerContentControl(String)	Dodaje nowy DatePickerContentControl element do bieżącego zaznaczenia w dokumencie.
AddDatePickerContentControl(ContentControl, String)	Dodaje nowy DatePickerContentControl element do kolekcji. Nowy formant opiera się na macierzystym formancie zawartości, który już znajduje się w dokumencie.
AddDatePickerContentControl(Range, String)	Dodaje nowy DatePickerContentControl w określonym zakresie w dokumencie.

AddDatePickerContentControl(String)

Dodaje nowy DatePickerContentControl element do bieżącego zaznaczenia w dokumencie.

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

Nazwa nowego formantu.

Zwraca

DatePickerContentControl

Element DatePickerContentControl , który został dodany do dokumentu.

Wyjątki

ArgumentNullException

name jest null lub ma zerową długość.

ControlNameAlreadyExistsException

Kontrolka o tej samej nazwie znajduje się już w elemecie ControlCollection.

Przykłady

Poniższy przykład kodu dodaje nowy DatePickerContentControl element na początku dokumentu. Przykład modyfikuje również format, w którym kontrolka wyświetla daty.

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołaj metodę AddDatePickerControlAtSelection z ThisDocument_Startup 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

Ta wersja dotyczy dodatku na poziomie aplikacji przeznaczonego dla .NET Framework 4 lub .NET Framework 4.5. Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie i wywołaj metodę AddDatePickerControlAtSelection z ThisAddIn_Startup 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

Uwagi

Ta metoda służy do dodawania nowego DatePickerContentControl do bieżącego zaznaczenia w dokumencie w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Dodawanie kontrolek do dokumentów pakietu Office w czasie wykonywania.

Dotyczy

AddDatePickerContentControl(ContentControl, String)

Dodaje nowy DatePickerContentControl element do kolekcji. Nowy formant opiera się na macierzystym formancie zawartości, który już znajduje się w dokumencie.

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

Jest ContentControl to podstawa nowej kontrolki.

name: String

Nazwa nowego formantu.

Zwraca

DatePickerContentControl

Element DatePickerContentControl , który został dodany do dokumentu.

Wyjątki

ArgumentNullException

contentControl jest null.-or- name lub null ma zerową długość.

ControlNameAlreadyExistsException

Kontrolka o tej samej nazwie znajduje się już w elemecie ControlCollection.

ArgumentException

contentControlnie jest galerią bloków konstrukcyjnych (czyli Type właściwością contentControl nie ma wartości Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlDate).

Przykłady

Poniższy przykład kodu tworzy nowy DatePickerContentControl dla każdej natywnej kontrolki daty, która znajduje się w dokumencie.

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołaj metodę CreateDatePickerControlsFromNativeControls z ThisDocument_Startup 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

Ta wersja dotyczy dodatku na poziomie aplikacji przeznaczonego dla .NET Framework 4 lub .NET Framework 4.5. Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie i wywołaj metodę CreateDatePickerControlsFromNativeControls z ThisAddIn_Startup 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

Poniższy przykład kodu tworzy nowy DatePickerContentControl dla każdej natywnej kontrolki daty, którą użytkownik dodaje do dokumentu.

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie. W języku C# należy również dołączyć ThisDocument_DatePickerContentControlAfterAdd program obsługi zdarzeń do ContentControlAfterAdd zdarzenia ThisDocument klasy .

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

Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie. Ponadto należy dołączyć procedurę ActiveDocument_DatePickerContentControlAfterAdd obsługi zdarzeń do ContentControlAfterAdd zdarzenia aktywnego 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

Uwagi

Użyj tej metody, aby dodać nową DatePickerContentControl , która jest oparta na natywnej kontrolce zawartości w dokumencie w czasie wykonywania. Jest to przydatne podczas tworzenia DatePickerContentControl w czasie wykonywania i chcesz ponownie utworzyć tę samą kontrolkę przy następnym otwarciu dokumentu. Aby uzyskać więcej informacji, zobacz Dodawanie kontrolek do dokumentów pakietu Office w czasie wykonywania.

Dotyczy

AddDatePickerContentControl(Range, String)

Dodaje nowy DatePickerContentControl w określonym zakresie w dokumencie.

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

range: Range

Element Range , który zapewnia ograniczenia dla nowej kontrolki.

name: String

Nazwa nowego formantu.

Zwraca

DatePickerContentControl

Element DatePickerContentControl , który został dodany do dokumentu.

Wyjątki

ArgumentNullException

name jest null lub ma zerową długość.

ControlNameAlreadyExistsException

Kontrolka o tej samej nazwie znajduje się już w elemecie ControlCollection.

Przykłady

Poniższy przykład kodu dodaje nowy DatePickerContentControl element na początku dokumentu. Przykład modyfikuje również format, w którym kontrolka wyświetla daty.

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołaj metodę AddDatePickerControlAtRange z ThisDocument_Startup 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

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

Uwagi

Ta metoda służy do dodawania nowego DatePickerContentControl w określonym zakresie w dokumencie w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Dodawanie kontrolek do dokumentów pakietu Office w czasie wykonywania.

Dotyczy

Udostępnij za pośrednictwem

ControlCollection.AddDatePickerContentControl Metoda

Definicja

Przeciążenia

AddDatePickerContentControl(String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

AddDatePickerContentControl(ContentControl, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

AddDatePickerContentControl(Range, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby