ControlCollection.AddRichTextContentControl Yöntem (Range, String)

Makale
08/01/2011

Yeni bir ekler RichTextContentControl adresinde belirtilen aralıkta belge.

Ad alanı: Microsoft.Office.Tools.Word
Derleme: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll içinde)

Sözdizimi

'Bildirim
Function AddRichTextContentControl ( _
    range As Range, _
    name As String _
) As RichTextContentControl

RichTextContentControl AddRichTextContentControl(
    Range range,
    string name
)

Parametreler

range
Tür: Microsoft.Office.Interop.Word.Range
A Range sağlayan sınırları için yeni bir denetim.

name
Tür: System.String
Yeni denetimin adı.

Dönüş Değeri

Tür: Microsoft.Office.Tools.Word.RichTextContentControl
RichTextContentControl , Eklenmiştir belge.

Özel Durumlar

Exception	Koşul
ArgumentNullException	nameİş nullnull başvuru (Visual Basic\'te Nothing) veya sıfır uzunluk.
ControlNameAlreadyExistsException	Aynı ada sahip bir denetim söz ControlCollection.

Açıklamalar

Yeni eklemek için bu yöntemi kullanın RichTextContentControl adresinde belirtilen aralığı belgede çalışma zamanı. Daha fazla bilgi için bkz. Belgeye Çalışma Zamanında Denetim Ekleme.

Örnekler

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

Belge düzeyinde özelleştirme için değil. Bu kodu kullanmak için içine Yapıştır ThisDocument sınıfı proje ve çağrı AddRichTextControlAtRange yönteminden ThisDocument_Startup yöntemi.

Dim richTextControl2 As Microsoft.Office.Tools.Word.RichTextContentControl

Private Sub AddRichTextControlAtRange()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    richTextControl2 = Me.Controls.AddRichTextContentControl(Me.Paragraphs(1).Range, _
        "richTextControl2")
    richTextControl2.PlaceholderText = "Enter your first name"
End Sub

private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl2;

private void AddRichTextControlAtRange()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();

    richTextControl2 = this.Controls.AddRichTextContentControl(this.Paragraphs[1].Range,
        "richTextControl2");
    richTextControl2.PlaceholderText = "Enter your first name";
}

Bir uygulama düzeyinde hedefleyen eklentisi için değil .NET Framework 4. Bu kodu kullanmak için içine Yapıştır ThisAddIn sınıfı proje ve çağrı AddRichTextControlAtRange yönteminden ThisAddIn_Startup yöntemi.

Dim richTextControl2 As Microsoft.Office.Tools.Word.RichTextContentControl

Private Sub AddRichTextControlAtRange()
    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()
    richTextControl2 = vstoDoc.Controls.AddRichTextContentControl( _
        vstoDoc.Paragraphs(1).Range, _
        "richTextControl2")
    richTextControl2.PlaceholderText = "Enter your first name"
End Sub

private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl2;

private void AddRichTextControlAtRange()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();

    richTextControl2 = vstoDoc.Controls.AddRichTextContentControl(vstoDoc.Paragraphs[1].Range,
        "richTextControl2");
    richTextControl2.PlaceholderText = "Enter your first name";
}

.NET Framework Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. kısmen güvenilir kod tarafından Kitaplıklar kullanma.