RichTextContentControl Arabirim

Bir metin bloğunu veya diğer bir belgeye içerik türlerini temsil eder.

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

Sözdizimi

'Bildirim
<GuidAttribute("fe02ce7e-9ae7-444f-a5f8-af588716d06b")> _
Public Interface RichTextContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize
[GuidAttribute("fe02ce7e-9ae7-444f-a5f8-af588716d06b")]
public interface RichTextContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

RichTextContentControl türü aşağıdaki üyeleri ortaya koyar.

Özellikler

  Ad Açıklama
Genel özellik Application Alır bir Microsoft.Office.Interop.Word.Application , Microsoft Office Word'ün geçerli örneğini temsil eder.
Genel özellik BindingContext Alır veya ayarlar için para birimi yöneticileri topluluğu IBindableComponent. (IBindableComponent kaynağından devralındı.)
Genel özellik Container Altyapı. (ContentControlBase kaynağından devralındı.)
Genel özellik ContainerComponent Altyapı. (ContentControlBase kaynağından devralındı.)
Genel özellik Creator Alır, bir uygulamayı gösteren bir 32 bitlik tamsayı RichTextContentControl oluşturuldu.
Genel özellik DataBindings Bu veri bağlama nesneler topluluğu alır IBindableComponent. (IBindableComponent kaynağından devralındı.)
Genel özellik DefaultDataSourceUpdateMode Alır veya ayarlar varsayılan DataSourceUpdateMode için ContentControlBase. (ContentControlBase kaynağından devralındı.)
Genel özellik DefaultTextStyle Metni biçimlendirmek için kullanılacak karakter stilinin adını alır RichTextContentControl.
Genel özellik ID İçerik denetimi tanımlayan benzersiz bir numara alır. (ContentControlBase kaynağından devralındı.)
Genel özellik InnerObject Arka plandaki alır Microsoft.Office.Interop.Word.ContentControl için nesne Microsoft.Office.Tools.Word.ContentControlBase. (ContentControlBase kaynağından devralındı.)
Genel özellik LockContentControl Belirten bir değeri alır veya ayarlar olup olmadığını RichTextContentControl belgeden silinebilir.
Genel özellik LockContents Belirten bir değeri alır veya ayarlar olup olmadığını içeriğini RichTextContentControl düzenlenebilir.
Genel özellik Parent Üst alır RichTextContentControl.
Genel özellik ParentContentControl En üst içerik denetimini bir RichTextContentControl başka bir içerik denetiminde yuvalanmış.
Genel özellik PlaceholderText Alır veya ayarlar görüntülenen metni RichTextContentControl kadar metin kullanıcı eylemi veya başka bir işlem tarafından değiştirildi.
Genel özellik Range Alır bir Range içeriğini temsil eden RichTextContentControl.
Genel özellik ShowingPlaceholderText Gösteren değer alır mı RichTextContentControl şu anda yer tutucu metni görüntüleyen.
Genel özellik Site Alır veya ayarlar ISite ile ilgili IComponent. (IComponent kaynağından devralındı.)
Genel özellik Tag Alır veya ayarlar ile ilişkilendirmek istediğiniz bir dize RichTextContentControl.
Genel özellik Temporary Belirten bir değeri alır veya ayarlar olup olmadığını RichTextContentControl denetim düzenlendiğinde belgeden otomatik olarak silinir.
Genel özellik Text Alır veya ayarlar metin RichTextContentControl.
Genel özellik Title Alır veya ayarlar unvanını RichTextContentControl.

Üst

Yöntemler

  Ad Açıklama
Genel yöntem BeginInit Nesne sinyalleri bu başlatma başlatıyor. (ISupportInitialize kaynağından devralındı.)
Genel yöntem Copy Kopya RichTextContentControl Pano belgesinden.
Genel yöntem Cut Kaldırır RichTextContentControl belgeden ve panoya ekler.
Genel yöntem Delete Dinamik olarak oluşturulmuş içerik denetimi belgeden siler ve buradan kaldırır ControlCollection belge içinde. (ContentControlBase kaynağından devralındı.)
Genel yöntem Dispose Yönetilmeyen kaynakları boşaltma, serbest bırakma veya sıfırlama ile ilişkili uygulama tanımlı görevleri gerçekleştirir. (IDisposable kaynağından devralındı.)
Genel yöntem EndInit Nesne sinyalleri bu başlatma tamamlanır. (ISupportInitialize kaynağından devralındı.)
Genel yöntem SetPlaceholderText Görüntüler, metin bir BuildingBlock, Range, yer tutucu metni olarak bir dize veya RichTextContentControl.

Üst

Olaylar

  Ad Açıklama
Genel olay Added İçerik denetimini belgeye eklendikten sonra gerçekleşir. (ContentControlBase kaynağından devralındı.)
Genel olay BindingContextChanged Oluşur, değeri BindingContext özelliği ContentControlBase değişiklikler. (ContentControlBase kaynağından devralındı.)
Genel olay ContentUpdating Yalnızca Microsoft Office Word'ün içerik denetimindeki metni güncelleştirir önce içerik denetimi özel XML bölümüne bağlıysa oluşur. (ContentControlBase kaynağından devralındı.)
Genel olay Deleting Yalnızca içerik denetimi belgeden silinmeden önce oluşur. (ContentControlBase kaynağından devralındı.)
Genel olay Disposed İşleme yöntemini gösteren Disposed bir bileşenin olay. (IComponent kaynağından devralındı.)
Genel olay Entering Kullanıcı içerik denetimine tıkladığında veya imleç program aracılığıyla içerik denetimine hareket ettiğinde gerçekleşir. (ContentControlBase kaynağından devralındı.)
Genel olay Exiting Kullanıcı içerik denetiminin dışına tıkladığında veya imleç program aracılığıyla içerik denetiminin dışına hareket ettiğinde gerçekleşir. (ContentControlBase kaynağından devralındı.)
Genel olay StoreUpdating Yalnızca Microsoft Office Word'ün verileri, içeriğe bağlı özel XML bölümü güncellemeden önce oluşur (metin içerik denetimi değişiklikleri) sonra denetlemek. (ContentControlBase kaynağından devralındı.)
Genel olay Validated İçerik denetimi başarıyla doğrulandı oluşur. (ContentControlBase kaynağından devralındı.)
Genel olay Validating İçerik denetiminin içeriği doğrulama oluşur. (ContentControlBase kaynağından devralındı.)

Üst

Notlar

A RichTextContentControl birçok diğer tablo, resim veya diğer içerik denetimleri gibi içerik türlerinin, yanı sıra metin içerebilir.Metin biçimlendirme ve stilleri uygulayabileceğiniz bir RichTextContentControl.

Yalnızca metin içeren bir belge bölgesi oluşturmak için bir PlainTextContentControl.

[!NOT]

Bu arabirim, Office için Visual Studio Araçları çalışma zamanı modülü tarafından uygulanır. Kodunuzda gerçekleştirilmesi amaçlanmamıştır. Daha fazla bilgi için bkz. Office Çalışma Zamanı İçin Visual Studio Araçlarına Genel Bakış.

İçerik Denetimleri

RichTextContentControl Sekiz tasarım belgeleri ve şablonları Microsoft Office Word için kullanabileceğiniz içerik denetimi türü bulunan biridir.İçerik denetimleri, bir kullanıcı arabirimi (UI) sahiptir, girdileri form gibi kontrol.Kullanıcılar korumalı belgenin veya şablonun bölümlerini düzenlemesini engellemek için içerik denetimlerini kullanabilirsiniz ve içerik denetimlerini veri kaynağına bağlayabilirsiniz.Daha fazla bilgi için bkz. İçerik Denetimleri.

Kullanım

Bu belgelerde, .NET Framework 4 ve .NET Framework 4.5'i hedefleyen Office projelerinde kullanılan bu türün sürümü açıklanır. .NET Framework 3.5'i hedefleyen projelerde, bu türün üyeleri farklı olabilir ve bu tür için sağlanan kod örnekleri çalışmayabilir. .NET Framework 3.5'i hedefleyen projelerde bu tür hakkındaki belgeler için Visual Studio 2008 belgelerinde aşağıdaki başvuru bölümüne bakın: https://go.microsoft.com/fwlink/?LinkId=160658.

Örnekler

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

Belge düzeyi özelleştirmesinde sürümüdür.Bu kodu kullanmak için içine yapıştırın ThisDocument sınıfı proje ve çağrı AddRichTextControlAtSelection yönteminden ThisDocument_Startup yöntem.

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

Private Sub AddRichTextControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    richTextControl1 = Me.Controls.AddRichTextContentControl("richTextControl1")
    richTextControl1.PlaceholderText = "Enter your first name"
End Sub
private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl1;

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

    richTextControl1 = this.Controls.AddRichTextContentControl("richTextControl1");
    richTextControl1.PlaceholderText = "Enter your first name";
}

Bir uygulama düzeyi eklentisi değildir.Bu kodu kullanmak için içine yapıştırın ThisAddIn sınıfı proje ve çağrı AddRichTextControlAtSelection yönteminden ThisAddIn_Startup yöntem.

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

Private Sub AddRichTextControlAtSelection()
    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()
    richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1")
    richTextControl1.PlaceholderText = "Enter your first name"
End Sub
private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl1;

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

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

    richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1");
    richTextControl1.PlaceholderText = "Enter your first name";
}

Ayrıca bkz.

Başvuru

Microsoft.Office.Tools.Word Ad Alanı

Diğer Kaynaklar

İçerik Denetimleri

Nasıl Yapılır: Word Belgelerine İçerik Denetimleri Ekleme

Nasıl Yapılır: İçerik Denetimlerini Kullanarak Belge Bölümlerini Koruma

İzlenecek Yol: İçerik Denetimlerini Kullanarak Şablon Oluşturma