Método ControlCollection.AddDatePickerContentControl (ContentControl, String)
Adiciona um novo DatePickerContentControl à coleção. O novo controle baseia-se em um controle de conteúdo nativo que já está no documento.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)
Sintaxe
'Declaração
Function AddDatePickerContentControl ( _
contentControl As ContentControl, _
name As String _
) As DatePickerContentControl
DatePickerContentControl AddDatePickerContentControl(
ContentControl contentControl,
string name
)
Parâmetros
- contentControl
Tipo: Microsoft.Office.Interop.Word.ContentControl
O Microsoft.Office.Interop.Word.ContentControl ou seja, a base para o novo controle.
- name
Tipo: System.String
O nome do novo controle.
Valor de retorno
Tipo: Microsoft.Office.Tools.Word.DatePickerContentControl
O DatePickerContentControl que foi adicionado ao documento.
Exceções
Exceção | Condição |
---|---|
ArgumentNullException | contentControl is nulluma referência nula (Nothing no Visual Basic). - ou - nameé nulluma referência nula (Nothing no Visual Basic) ou tem comprimento zero. |
ControlNameAlreadyExistsException | Um controle com o mesmo nome já está na ControlCollection. |
ArgumentException | contentControlnão é uma Galeria de bloco de construção (isto é, o Type propriedade de contentControl não tem o valor Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlDate). |
Comentários
Use esse método para adicionar um novo DatePickerContentControl que se baseia em um controle de conteúdo nativo no documento no tempo de execução. Isso é útil quando você cria um DatePickerContentControl em tempo de execução, e você quiser recriar o mesmo controle na próxima vez em que o documento for aberto. For more information, see Adicionar controles a documentos do Office em tempo de execução.
Exemplos
O exemplo de código a seguir cria um novo DatePickerContentControl para cada controle nativo de data que está no documento.
Esta versão é para uma personalização em nível de documento. Para usar esse código, colá-lo na ThisDocument classe em seu projeto e a chamada a CreateDatePickerControlsFromNativeControls método a partir do ThisDocument_Startup método.
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
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);
}
}
}
Esta versão é um suplemento de nível de aplicativo que se destina a .NET Framework 4. Para usar esse código, colá-lo na ThisAddIn classe em seu projeto e a chamada a CreateDatePickerControlsFromNativeControls método a partir do ThisAddIn_Startup método.
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
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);
}
}
}
O exemplo de código a seguir cria um novo DatePickerContentControl para cada controle nativo de data que o usuário adiciona ao documento.
Esta versão é para uma personalização em nível de documento. Para usar esse código, colá-lo para o ThisDocument classe no projeto. Para C#, você também deve anexar o ThisDocument_DatePickerContentControlAfterAdd o manipulador de eventos para o ContentControlAfterAdd o evento da ThisDocument classe.
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
void ThisDocument_DatePickerContentControlAfterAdd(Word.ContentControl NewContentControl, bool InUndoRedo)
{
if (NewContentControl.Type == Word.WdContentControlType.wdContentControlDate)
{
this.Controls.AddDatePickerContentControl(NewContentControl,
"DatePickerControl" + NewContentControl.ID);
}
}
Para usar esse código, colá-lo para o ThisAddIn classe no projeto. Além disso, você deve anexar o ActiveDocument_DatePickerContentControlAfterAdd o manipulador de eventos para o ContentControlAfterAdd eventos do documento ativo.
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
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);
}
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.
Consulte também
Referência
Sobrecargas AddDatePickerContentControl
Namespace Microsoft.Office.Tools.Word
Outros recursos
Adicionar controles a documentos do Office em tempo de execução
Métodos auxiliares para controles de Host
Como: Adicionar controles de conteúdo para documentos do Word