ControlCollection.AddPlainTextContentControl Yöntem

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools.Word

Bütünleştirilmiş Kodlar:: Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Aşırı Yüklemeler

AddPlainTextContentControl(String)	Belgedeki geçerli seçime yeni PlainTextContentControl bir ekler.
AddPlainTextContentControl(ContentControl, String)	Belgedeki yerel içerik denetimini temel alan yeni PlainTextContentControl bir ekler.
AddPlainTextContentControl(Range, String)	Belgede belirtilen aralıkta yeni PlainTextContentControl bir ekler.

AddPlainTextContentControl(String)

Belgedeki geçerli seçime yeni PlainTextContentControl bir ekler.

public:
 Microsoft::Office::Tools::Word::PlainTextContentControl ^ AddPlainTextContentControl(System::String ^ name);

public Microsoft.Office.Tools.Word.PlainTextContentControl AddPlainTextContentControl (string name);

abstract member AddPlainTextContentControl : string -> Microsoft.Office.Tools.Word.PlainTextContentControl

Public Function AddPlainTextContentControl (name As String) As PlainTextContentControl

Parametreler

name: String

Yeni denetimin adı.

Döndürülenler

PlainTextContentControl

Belgeye PlainTextContentControl eklenen.

Özel durumlar

ArgumentNullException

name veya null uzunluğu sıfırdır.

ControlNameAlreadyExistsException

Aynı ada sahip bir denetim zaten içindedir ControlCollection.

Örnekler

Aşağıdaki kod örneği, belgenin başına yeni PlainTextContentControl bir ekler.

Bu sürüm, belge düzeyinde özelleştirme içindir. Bu kodu kullanmak için, bunu projenizdeki sınıfına ThisDocument yapıştırın ve yönteminden yöntemini çağırın AddTextControlAtSelectionThisDocument_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

Bu sürüm, .NET Framework 4 veya .NET Framework 4.5'i hedefleyen bir uygulama düzeyi eklentisi içindir. Bu kodu kullanmak için, bunu projenizdeki sınıfına ThisAddIn yapıştırın ve yönteminden yöntemini çağırın AddTextControlAtSelectionThisAddIn_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

Açıklamalar

Çalışma zamanında belgedeki geçerli seçime yeni PlainTextContentControl bir eklemek için bu yöntemi kullanın. Daha fazla bilgi için bkz. Çalışma Zamanında Office Belgelerine Denetim Ekleme.

Şunlara uygulanır

AddPlainTextContentControl(ContentControl, String)

Belgedeki yerel içerik denetimini temel alan yeni PlainTextContentControl bir ekler.

public:
 Microsoft::Office::Tools::Word::PlainTextContentControl ^ AddPlainTextContentControl(Microsoft::Office::Interop::Word::ContentControl ^ contentControl, System::String ^ name);

public Microsoft.Office.Tools.Word.PlainTextContentControl AddPlainTextContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);

abstract member AddPlainTextContentControl : Microsoft.Office.Interop.Word.ContentControl * string -> Microsoft.Office.Tools.Word.PlainTextContentControl

Public Function AddPlainTextContentControl (contentControl As ContentControl, name As String) As PlainTextContentControl

Parametreler

contentControl: ContentControl

ContentControl Bu, yeni denetimin temelini oluşturur.

name: String

Yeni denetimin adı.

Döndürülenler

PlainTextContentControl

Belgeye PlainTextContentControl eklenen.

Özel durumlar

ArgumentNullException

contentControl is null.-or- name is null or has zero length.

ControlNameAlreadyExistsException

Aynı ada sahip bir denetim zaten içindedir ControlCollection.

ArgumentException

contentControlbir yapı taşı galerisi değildir (yani özelliği TypecontentControl Microsoft.Office.Interop.Word değerine sahip değildir. WdContentControlType.wdContentControlText).

Örnekler

Aşağıdaki kod örneği, belgedeki her yerel düz metin denetimi için yeni PlainTextContentControl bir oluşturur.

Bu sürüm, belge düzeyinde özelleştirme içindir. Bu kodu kullanmak için, bunu projenizdeki sınıfına ThisDocument yapıştırın ve yönteminden yöntemini çağırın CreateTextControlsFromNativeControlsThisDocument_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

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

Aşağıdaki kod örneği, kullanıcının belgeye eklediği her yerel düz metin denetimi için yeni PlainTextContentControl bir oluşturur.

Bu sürüm, belge düzeyinde özelleştirme içindir. Bu kodu kullanmak için projenizdeki sınıfına ThisDocument yapıştırın. C# için, olay işleyicisini ThisDocument_PlainTextContentControlAfterAdd sınıfının olayına ContentControlAfterAddThisDocument da eklemeniz gerekir.

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

Bu sürüm, .NET Framework 4 veya .NET Framework 4.5'i hedefleyen bir uygulama düzeyi eklentisi içindir. Bu kodu kullanmak için projenizdeki sınıfına ThisAddIn yapıştırın. Ayrıca, olay işleyicisini ActiveDocument_PlainTextContentControlAfterAdd etkin belgenin ContentControlAfterAdd olayına eklemeniz gerekir.

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

Açıklamalar

Çalışma zamanında belgedeki yerel içerik denetimini temel alan yeni PlainTextContentControl bir eklemek için bu yöntemi kullanın. Bu, çalışma zamanında bir PlainTextContentControl oluşturduğunuzda ve belgenin bir sonraki açılışında aynı denetimi yeniden oluşturmak istediğinizde kullanışlıdır. Daha fazla bilgi için bkz. Çalışma Zamanında Office Belgelerine Denetim Ekleme.

Şunlara uygulanır

AddPlainTextContentControl(Range, String)

Belgede belirtilen aralıkta yeni PlainTextContentControl bir ekler.

public:
 Microsoft::Office::Tools::Word::PlainTextContentControl ^ AddPlainTextContentControl(Microsoft::Office::Interop::Word::Range ^ range, System::String ^ name);

public Microsoft.Office.Tools.Word.PlainTextContentControl AddPlainTextContentControl (Microsoft.Office.Interop.Word.Range range, string name);

abstract member AddPlainTextContentControl : Microsoft.Office.Interop.Word.Range * string -> Microsoft.Office.Tools.Word.PlainTextContentControl

Public Function AddPlainTextContentControl (range As Range, name As String) As PlainTextContentControl

Parametreler

range: Range

Range Yeni denetim için sınırları sağlayan bir.

name: String

Yeni denetimin adı.

Döndürülenler

PlainTextContentControl

Belgeye PlainTextContentControl eklenen.

Özel durumlar

ArgumentNullException

name veya null uzunluğu sıfırdır.

ControlNameAlreadyExistsException

Aynı ada sahip bir denetim zaten içindedir ControlCollection.

Örnekler

Aşağıdaki kod örneği, belgenin başına yeni PlainTextContentControl bir ekler.

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

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

Açıklamalar

Çalışma zamanında belgede belirtilen aralıkta yeni PlainTextContentControl bir eklemek için bu yöntemi kullanın. Daha fazla bilgi için bkz. Çalışma Zamanında Office Belgelerine Denetim Ekleme.

Şunlara uygulanır

Aracılığıyla paylaş

ControlCollection.AddPlainTextContentControl Yöntem

Tanım

Aşırı Yüklemeler

AddPlainTextContentControl(String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

AddPlainTextContentControl(ContentControl, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

AddPlainTextContentControl(Range, String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar