ControlCollection.AddDatePickerContentControl Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Word

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

AddDatePickerContentControl(String)	Aggiunge un nuovo DatePickerContentControl in corrispondenza della selezione corrente nel documento.
AddDatePickerContentControl(ContentControl, String)	Aggiunge un nuovo oggetto DatePickerContentControl alla raccolta. Il nuovo controllo è basato su un controllo contenuto nativo che è già nel documento.
AddDatePickerContentControl(Range, String)	Aggiunge un nuovo DatePickerContentControl all'intervallo specificato nel documento.

AddDatePickerContentControl(String)

Aggiunge un nuovo DatePickerContentControl in corrispondenza della selezione corrente nel documento.

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

Parametri

name: String

Nome del nuovo controllo.

Restituisce

DatePickerContentControl

Oggetto DatePickerContentControl aggiunto al documento.

Eccezioni

ArgumentNullException

name è null o ha lunghezza zero.

ControlNameAlreadyExistsException

È già presente un controllo con lo stesso nome in ControlCollection.

Esempio

Nell'esempio di codice seguente viene aggiunto un nuovo oggetto DatePickerContentControl all'inizio del documento. Nell'esempio viene inoltre modificato il formato in cui il controllo Visualizza le date.

Questa versione è per una personalizzazione a livello di documento. Per usare questo codice, incollarlo nella ThisDocument classe nel progetto e chiamare il AddDatePickerControlAtSelection metodo dal ThisDocument_Startup metodo.

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

Questa versione è per un componente aggiuntivo a livello di applicazione destinato a .NET Framework 4 o .NET Framework 4.5. Per usare questo codice, incollarlo nella ThisAddIn classe nel progetto e chiamare il AddDatePickerControlAtSelection metodo dal ThisAddIn_Startup metodo.

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

Commenti

Utilizzare questo metodo per aggiungere un nuovo DatePickerContentControl oggetto alla selezione corrente nel documento in fase di esecuzione. Per altre informazioni, vedere Adding Controls to Office Documents at Run Time.

Si applica a

AddDatePickerContentControl(ContentControl, String)

Aggiunge un nuovo oggetto DatePickerContentControl alla raccolta. Il nuovo controllo è basato su un controllo contenuto nativo che è già nel documento.

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

Parametri

contentControl: ContentControl

Oggetto ContentControl che rappresenta la base per il nuovo controllo.

name: String

Nome del nuovo controllo.

Restituisce

DatePickerContentControl

Oggetto DatePickerContentControl aggiunto al documento.

Eccezioni

ArgumentNullException

contentControl è . null-oppure- name è null o ha una lunghezza zero.

ControlNameAlreadyExistsException

È già presente un controllo con lo stesso nome in ControlCollection.

ArgumentException

contentControlnon è una raccolta blocchi predefiniti, ovvero la Type proprietà di contentControl non ha il valore Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlDate).

Esempio

Nell'esempio di codice seguente viene creato un nuovo DatePickerContentControl oggetto per ogni controllo data nativo presente nel documento.

Questa versione è per una personalizzazione a livello di documento. Per usare questo codice, incollarlo nella ThisDocument classe nel progetto e chiamare il CreateDatePickerControlsFromNativeControls metodo dal ThisDocument_Startup metodo.

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

Questa versione è per un componente aggiuntivo a livello di applicazione destinato a .NET Framework 4 o .NET Framework 4.5. Per usare questo codice, incollarlo nella ThisAddIn classe nel progetto e chiamare il CreateDatePickerControlsFromNativeControls metodo dal ThisAddIn_Startup metodo.

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

Nell'esempio di codice seguente viene creato un nuovo DatePickerContentControl oggetto per ogni controllo data nativo aggiunto dall'utente al documento.

Questa versione è per una personalizzazione a livello di documento. Per usare questo codice, incollarlo nella ThisDocument classe nel progetto. Per C#, è anche necessario associare il ThisDocument_DatePickerContentControlAfterAdd gestore eventi all'evento ContentControlAfterAdd della ThisDocument classe .

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

Per usare questo codice, incollarlo nella ThisAddIn classe nel progetto. Inoltre, è necessario associare il ActiveDocument_DatePickerContentControlAfterAdd gestore eventi all'evento ContentControlAfterAdd del documento attivo.

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

Commenti

Utilizzare questo metodo per aggiungere un nuovo DatePickerContentControl oggetto basato su un controllo contenuto nativo nel documento in fase di esecuzione. Ciò è utile quando si crea un oggetto DatePickerContentControl in fase di esecuzione e si vuole ricreare lo stesso controllo alla successiva apertura del documento. Per altre informazioni, vedere Adding Controls to Office Documents at Run Time.

Si applica a

AddDatePickerContentControl(Range, String)

Aggiunge un nuovo DatePickerContentControl all'intervallo specificato nel documento.

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

Parametri

range: Range

Oggetto Range che specifica i limiti per il nuovo controllo.

name: String

Nome del nuovo controllo.

Restituisce

DatePickerContentControl

Oggetto DatePickerContentControl aggiunto al documento.

Eccezioni

ArgumentNullException

name è null o ha lunghezza zero.

ControlNameAlreadyExistsException

È già presente un controllo con lo stesso nome in ControlCollection.

Esempio

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

Commenti

Utilizzare questo metodo per aggiungere un nuovo DatePickerContentControl oggetto in un intervallo specificato nel documento in fase di esecuzione. Per altre informazioni, vedere Adding Controls to Office Documents at Run Time.

Si applica a

Condividi tramite

ControlCollection.AddDatePickerContentControl Metodo

Definizione

Overload

AddDatePickerContentControl(String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

AddDatePickerContentControl(ContentControl, String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

AddDatePickerContentControl(Range, String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Si applica a

Risorse aggiuntive