ControlCollection.AddPlainTextContentControl-Methode (String) (2007 System)
Aktualisiert: Juli 2008
Fügt bei der aktuellen Auswahl im Dokument ein neues PlainTextContentControl hinzu.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)
Syntax
'Declaration
Public Function AddPlainTextContentControl ( _
name As String _
) As PlainTextContentControl
'Usage
Dim instance As ControlCollection
Dim name As String
Dim returnValue As PlainTextContentControl
returnValue = instance.AddPlainTextContentControl(name)
public PlainTextContentControl AddPlainTextContentControl(
string name
)
Parameter
name
Typ: System.StringDer Name des neuen Steuerelements.
Rückgabewert
Typ: Microsoft.Office.Tools.Word.PlainTextContentControl
Das PlainTextContentControl, das dem Dokument hinzugefügt wurde.
Ausnahmen
Ausnahme | Bedingung |
---|---|
ArgumentNullException | name ist nullNULL-Verweis (Nothing in Visual Basic) oder hat die Länge 0 (null). |
ControlNameAlreadyExistsException | Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection vorhanden. |
Hinweise
Verwenden Sie diese Methode, um bei der aktuellen Auswahl im Dokument zur Laufzeit ein neues PlainTextContentControl hinzuzufügen. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.
Beispiele
Im folgenden Codebeispiel wird am Anfang des Dokuments ein neues PlainTextContentControl hinzugefügt.
Diese Version bezieht sich auf eine Anpassung auf Dokumentebene. Zum Verwenden dieses Codes fügen Sie ihn in der ThisDocument-Klasse in das Projekt ein und rufen in der ThisDocument_Startup-Methode die AddTextControlAtSelection-Methode auf.
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
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";
}
Diese Version bezieht sich auf ein Add-In auf Anwendungsebene. Zum Verwenden dieses Codes fügen Sie ihn in der ThisAddIn-Klasse in das Projekt ein und rufen in der ThisAddIn_Startup-Methode die AddTextControlAtSelection-Methode auf.
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 = Me.Application.ActiveDocument.GetVstoObject()
vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
vstoDoc.Paragraphs(1).Range.Select()
plainTextControl1 = vstoDoc.Controls.AddPlainTextContentControl("plainTextControl1")
plainTextControl1.PlaceholderText = "Enter your first name"
End Sub
private Microsoft.Office.Tools.Word.PlainTextContentControl textControl1;
private void AddTextControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = this.Application.ActiveDocument.GetVstoObject();
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
textControl1 = vstoDoc.Controls.AddPlainTextContentControl("textControl1");
textControl1.PlaceholderText = "Enter your first name";
}
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Siehe auch
Referenz
AddPlainTextContentControl-Überladung
Microsoft.Office.Tools.Word-Namespace
Weitere Ressourcen
Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit
Hilfsmethoden für Hoststeuerelemente
Gewusst wie: Hinzufügen von Inhaltssteuerelementen zu Word-Dokumenten
Änderungsprotokoll
Date |
Versionsgeschichte |
Grund |
---|---|---|
Juli 2008 |
Version des Codebeispiels für ein Add-In auf Anwendungsebene hinzugefügt. |
SP1-Featureänderung. |