ControlCollection.AddPlainTextContentControl Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| AddPlainTextContentControl(String) |
Adiciona um novo PlainTextContentControl na seleção atual no documento. |
| AddPlainTextContentControl(ContentControl, String) |
Adiciona um novo PlainTextContentControl que se baseia em um controle de conteúdo nativo no documento. |
| AddPlainTextContentControl(Range, String) |
Adiciona um novo PlainTextContentControl no intervalo especificado no documento. |
AddPlainTextContentControl(String)
Adiciona um novo PlainTextContentControl na seleção atual no documento.
public Microsoft.Office.Tools.Word.PlainTextContentControl AddPlainTextContentControl (string name);
Parâmetros
- name
- String
O nome do novo controle.
Retornos
O PlainTextContentControl adicionado ao documento.
Exceções
name é null ou tem tamanho zero.
Um controle com o mesmo nome já está no ControlCollection.
Exemplos
O exemplo de código a seguir adiciona um novo PlainTextContentControl ao início do documento.
Esta versão destina-se a uma personalização no nível de documento. Para usar esse código, cole-o na classe ThisDocument do projeto e chame o método AddTextControlAtSelection no método ThisDocument_Startup.
private Microsoft.Office.Tools.Word.PlainTextContentControl textControl1;
private void AddTextControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
textControl1 = this.Controls.AddPlainTextContentControl("textControl1");
textControl1.PlaceholderText = "Enter your first name";
}
Dim plainTextControl1 As Microsoft.Office.Tools.Word.PlainTextContentControl
Private Sub AddPlainTextControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
plainTextControl1 = Me.Controls.AddPlainTextContentControl("plainTextControl1")
plainTextControl1.PlaceholderText = "Enter your first name"
End Sub
Esta versão destina-se a um suplemento no nível do aplicativo que segmenta o .NET Framework 4 ou o .NET Framework 4.5. Para usar esse código, cole-o na classe ThisAddIn do projeto e chame o método AddTextControlAtSelection no método ThisAddIn_Startup.
private Microsoft.Office.Tools.Word.PlainTextContentControl textControl1;
private void AddTextControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
textControl1 = vstoDoc.Controls.AddPlainTextContentControl("textControl1");
textControl1.PlaceholderText = "Enter your first name";
}
Dim plainTextControl1 As Microsoft.Office.Tools.Word.PlainTextContentControl
Private Sub AddPlainTextControlAtSelection()
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()
plainTextControl1 = vstoDoc.Controls.AddPlainTextContentControl("plainTextControl1")
plainTextControl1.PlaceholderText = "Enter your first name"
End Sub
Comentários
Use este método para adicionar um novo PlainTextContentControl na seleção atual no documento em tempo de execução. Para obter mais informações, consulte adicionando controles a documentos do Office em tempo de execução.
Aplica-se a
AddPlainTextContentControl(ContentControl, String)
Adiciona um novo PlainTextContentControl que se baseia em um controle de conteúdo nativo no documento.
public Microsoft.Office.Tools.Word.PlainTextContentControl AddPlainTextContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);
Parâmetros
- contentControl
- ContentControl
O ContentControl que é a base do novo controle.
- name
- String
O nome do novo controle.
Retornos
O PlainTextContentControl adicionado ao documento.
Exceções
Um controle com o mesmo nome já está no ControlCollection.
contentControl não é uma galeria de blocos de construção (ou seja, a propriedade Type de contentControl não tem o valor Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlText).
Exemplos
O exemplo de código a seguir cria um novo PlainTextContentControl para cada controle de texto sem formatação nativo que está no documento.
Esta versão destina-se a uma personalização no nível de documento. Para usar esse código, cole-o na classe ThisDocument do projeto e chame o método CreateTextControlsFromNativeControls no método ThisDocument_Startup.
private System.Collections.Generic.List<Microsoft.Office.Tools.Word.PlainTextContentControl> plainTextControls;
private void CreateTextControlsFromNativeControls()
{
if (this.ContentControls.Count <= 0)
return;
plainTextControls = new System.Collections.Generic.List
<Microsoft.Office.Tools.Word.PlainTextContentControl>();
int count = 0;
foreach (Word.ContentControl nativeControl in this.ContentControls)
{
if (nativeControl.Type == Word.WdContentControlType.wdContentControlText)
{
count++;
Microsoft.Office.Tools.Word.PlainTextContentControl tempControl =
this.Controls.AddPlainTextContentControl(nativeControl,
"VSTOPlainTextContentControl" + count.ToString());
plainTextControls.Add(tempControl);
}
}
}
Private plainTextControls As New System.Collections.Generic.List _
(Of Microsoft.Office.Tools.Word.PlainTextContentControl)
Private Sub CreatePlainTextControlsFromNativeControls()
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.wdContentControlText Then
count += 1
Dim tempControl As Microsoft.Office.Tools.Word.PlainTextContentControl = _
Me.Controls.AddPlainTextContentControl(nativeControl, _
"VSTOPlainTextContentControl" + count.ToString())
plainTextControls.Add(tempControl)
End If
Next nativeControl
End Sub
Esta versão destina-se a um suplemento no nível do aplicativo que segmenta o .NET Framework 4 ou o .NET Framework 4.5. Para usar esse código, cole-o na classe ThisAddIn do projeto e chame o método CreateTextControlsFromNativeControls no método ThisAddIn_Startup.
private System.Collections.Generic.List<Microsoft.Office.Tools.Word.PlainTextContentControl> plainTextControls;
private void CreateTextControlsFromNativeControls()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
if (vstoDoc.ContentControls.Count <= 0)
return;
plainTextControls = new System.Collections.Generic.List
<Microsoft.Office.Tools.Word.PlainTextContentControl>();
int count = 0;
foreach (Word.ContentControl nativeControl in vstoDoc.ContentControls)
{
if (nativeControl.Type == Word.WdContentControlType.wdContentControlText)
{
count++;
Microsoft.Office.Tools.Word.PlainTextContentControl tempControl =
vstoDoc.Controls.AddPlainTextContentControl(nativeControl,
"VSTOPlainTextContentControl" + count.ToString());
plainTextControls.Add(tempControl);
}
}
}
Private plainTextControls As New System.Collections.Generic.List _
(Of Microsoft.Office.Tools.Word.PlainTextContentControl)
Private Sub CreatePlainTextControlsFromNativeControls()
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.wdContentControlText Then
count += 1
Dim tempControl As Microsoft.Office.Tools.Word.PlainTextContentControl = _
vstoDoc.Controls.AddPlainTextContentControl(nativeControl, _
"VSTOPlainTextContentControl" + count.ToString())
plainTextControls.Add(tempControl)
End If
Next nativeControl
End Sub
O exemplo de código a seguir cria um novo PlainTextContentControl para cada controle de texto sem formatação nativo que o usuário adiciona ao documento.
Esta versão destina-se a uma personalização no nível de documento. Para usar esse código, cole-o na classe ThisDocument do projeto. Para o C#, você também deve anexar o ThisDocument_PlainTextContentControlAfterAdd manipulador de eventos ao ContentControlAfterAdd evento da ThisDocument classe.
void ThisDocument_PlainTextContentControlAfterAdd(Word.ContentControl NewContentControl, bool InUndoRedo)
{
if (NewContentControl.Type == Word.WdContentControlType.wdContentControlText)
{
this.Controls.AddPlainTextContentControl(NewContentControl,
"PlainTextControl" + NewContentControl.ID);
}
}
Private Sub ThisDocument_PlainTextContentControlAfterAdd(ByVal NewContentControl As Word.ContentControl, _
ByVal InUndoRedo As Boolean) Handles Me.ContentControlAfterAdd
If NewContentControl.Type = Word.WdContentControlType.wdContentControlText Then
Me.Controls.AddPlainTextContentControl(NewContentControl, _
"PlainTextControl" + NewContentControl.ID)
End If
End Sub
Esta versão destina-se a um suplemento no nível do aplicativo que segmenta o .NET Framework 4 ou o .NET Framework 4.5. Para usar esse código, cole-o na classe ThisAddIn do projeto. Além disso, você deve anexar o ActiveDocument_PlainTextContentControlAfterAdd manipulador de eventos ao ContentControlAfterAdd evento do documento ativo.
void ActiveDocument_PlainTextContentControlAfterAdd(
Word.ContentControl NewContentControl, bool InUndoRedo)
{
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
if (NewContentControl.Type == Word.WdContentControlType.wdContentControlText)
{
vstoDoc.Controls.AddPlainTextContentControl(NewContentControl,
"PlainTextControl" + NewContentControl.ID);
}
}
Private Sub ActiveDocument_PlainTextContentControlAfterAdd( _
ByVal NewContentControl As Word.ContentControl, _
ByVal InUndoRedo As Boolean)
Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
If NewContentControl.Type = Word.WdContentControlType. _
wdContentControlText Then
vstoDoc.Controls.AddPlainTextContentControl(NewContentControl, _
"PlainTextControl" + NewContentControl.ID)
End If
End Sub
Comentários
Use esse método para adicionar um novo PlainTextContentControl que se baseia em um controle de conteúdo nativo no documento em tempo de execução. Isso é útil quando você cria um PlainTextContentControl em tempo de execução e deseja recriar o mesmo controle na próxima vez em que o documento for aberto. Para obter mais informações, consulte adicionando controles a documentos do Office em tempo de execução.
Aplica-se a
AddPlainTextContentControl(Range, String)
Adiciona um novo PlainTextContentControl no intervalo especificado no documento.
public Microsoft.Office.Tools.Word.PlainTextContentControl AddPlainTextContentControl (Microsoft.Office.Interop.Word.Range range, string name);
Parâmetros
- name
- String
O nome do novo controle.
Retornos
O PlainTextContentControl adicionado ao documento.
Exceções
name é null ou tem tamanho zero.
Um controle com o mesmo nome já está no ControlCollection.
Exemplos
O exemplo de código a seguir adiciona um novo PlainTextContentControl ao início do documento.
Esta versão destina-se a uma personalização no nível de documento. Para usar esse código, cole-o na classe ThisDocument do projeto e chame o método AddTextControlAtRange no método ThisDocument_Startup.
private Microsoft.Office.Tools.Word.PlainTextContentControl textControl2;
private void AddTextControlAtRange()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
textControl2 = this.Controls.AddPlainTextContentControl(this.Paragraphs[1].Range,
"textControl2");
textControl2.PlaceholderText = "Enter your first name";
}
Dim plainTextControl2 As Microsoft.Office.Tools.Word.PlainTextContentControl
Private Sub AddPlainTextControlAtRange()
Me.Paragraphs(1).Range.InsertParagraphBefore()
plainTextControl2 = Me.Controls.AddPlainTextContentControl(Me.Paragraphs(1).Range, "plainTextControl2")
plainTextControl2.PlaceholderText = "Enter your first name"
End Sub
Esta versão destina-se a um suplemento no nível do aplicativo que segmenta o .NET Framework 4 ou o .NET Framework 4.5. Para usar esse código, cole-o na classe ThisAddIn do projeto e chame o método AddTextControlAtRange no método ThisAddIn_Startup.
private Microsoft.Office.Tools.Word.PlainTextContentControl textControl2;
private void AddTextControlAtRange()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
textControl2 = vstoDoc.Controls.AddPlainTextContentControl(
vstoDoc.Paragraphs[1].Range,
"textControl2");
textControl2.PlaceholderText = "Enter your first name";
}
Dim plainTextControl2 As Microsoft.Office.Tools.Word.PlainTextContentControl
Private Sub AddPlainTextControlAtRange()
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()
plainTextControl2 = vstoDoc.Controls.AddPlainTextContentControl( _
vstoDoc.Paragraphs(1).Range, "plainTextControl2")
plainTextControl2.PlaceholderText = "Enter your first name"
End Sub
Comentários
Use este método para adicionar um novo PlainTextContentControl em um intervalo especificado no documento em tempo de execução. Para obter mais informações, consulte adicionando controles a documentos do Office em tempo de execução.