PlainTextContentControl Arabirim

Makale
10/29/2012

Bir belgedeki metin bloğunu temsil eder.

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

Sözdizimi

'Bildirim
<GuidAttribute("a8c46931-fa10-4760-8b46-0f2d881e269f")> _
Public Interface PlainTextContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("a8c46931-fa10-4760-8b46-0f2d881e269f")]
public interface PlainTextContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

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

Özellikler

	Ad	Açıklama
	Application	Alır bir Microsoft.Office.Interop.Word.Application Microsoft Office Word'ün geçerli örneğinin temsil eden.
	BindingContext	Alır veya ayarlar için para birimi yöneticileri topluluğu IBindableComponent. (IBindableComponent kaynağından devralındı.)
	Container	Altyapı. (ContentControlBase kaynağından devralındı.)
	ContainerComponent	Altyapı. (ContentControlBase kaynağından devralındı.)
	Creator	Uygulaması belirten 32 bitlik bir tamsayı alır PlainTextContentControl oluşturuldu.
	DataBindings	Bu veri bağlama nesneler topluluğu alır IBindableComponent. (IBindableComponent kaynağından devralındı.)
	DefaultDataSourceUpdateMode	Alır veya ayarlar varsayılan DataSourceUpdateMode için ContentControlBase. (ContentControlBase kaynağından devralındı.)
	DefaultTextStyle	Metni biçimlendirmek için kullanılacak karakter stilinin adını alır PlainTextContentControl.
	ID	İçerik denetimi tanımlayan benzersiz bir numara alır. (ContentControlBase kaynağından devralındı.)
	InnerObject	Temel alır Microsoft.Office.Interop.Word.ContentControl için nesne Microsoft.Office.Tools.Word.ContentControlBase. (ContentControlBase kaynağından devralındı.)
	LockContentControl	Belirten bir değeri alır veya ayarlar olup olmadığını PlainTextContentControl belgeden silindi.
	LockContents	Belirten bir değeri alır veya ayarlar olup olmadığını içeriğini PlainTextContentControl düzenlenebilir.
	MultiLine	Belirten bir değeri alır veya ayarlar olup olmadığını PlainTextContentControl satır sonları içerebilir.
	Parent	Üst alır PlainTextContentControl.
	ParentContentControl	En üst içerik denetimini bir PlainTextContentControl başka bir içerik denetimi içinde yuvalanmış.
	PlaceholderText	Alır veya ayarlar içinde görüntülenen metin PlainTextContentControl metin kullanıcı eylemi veya başka bir işlem tarafından değiştirilene kadar.
	Range	Alır bir Range içeriğini temsil eden PlainTextContentControl.
	ShowingPlaceholderText	Belirten bir değeri alır mı PlainTextContentControl yer tutucu metin görüntülüyor demektir.
	Site	Alır veya ayarlar ISite ile ilgili IComponent. (IComponent kaynağından devralındı.)
	Tag	Alır veya ayarlar ile ilişkilendirmek istediğiniz bir dize PlainTextContentControl.
	Temporary	Belirten bir değeri alır veya ayarlar olup olmadığını PlainTextContentControl denetim düzenlendiğinde belgenin otomatik olarak silinir.
	Text	Alır veya ayarlar metin PlainTextContentControl.
	Title	Alır veya ayarlar başlığının PlainTextContentControl.
	XMLMapping	Alır bir XMLMapping arasında bir bağ temsil eden PlainTextContentControl ile özel bir xml parçası bir öğe.

Üst

Yöntemler

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

Üst

Olaylar

	Ad	Açıklama
	Added	İçerik denetimi belgeye ekledikten sonra oluşur. (ContentControlBase kaynağından devralındı.)
	BindingContextChanged	Oluşur, değeri BindingContext özelliðinin ContentControlBase değişiklikler. (ContentControlBase kaynağından devralındı.)
	ContentUpdating	Yalnızca Microsoft Office Word içerik denetimindeki metni güncelleştirir önce içerik denetimi için özel bir xml parçası bağlıysa oluşur. (ContentControlBase kaynağından devralındı.)
	Deleting	Belgeden içerik denetimi yalnızca silinmeden önce oluşur. (ContentControlBase kaynağından devralındı.)
	Disposed	İşleme yöntemini gösteren Disposed bir bileşenin olay. (IComponent kaynağından devralındı.)
	Entering	Kullanıcı içerik denetimi tıklattığında veya imleci içerik denetime programlı hareket ettiğinde gerçekleşir. (ContentControlBase kaynağından devralındı.)
	Exiting	Kullanıcı dışında içerik denetimi tıklattığında veya imleci programlı olarak içerik denetimi dışında hareket ettiğinde gerçekleşir. (ContentControlBase kaynağından devralındı.)
	StoreUpdating	Yalnızca Microsoft Office Word içeriğine bağlı özel bir xml bölümündeki verileri güncelleştirir önce oluşur (yani, metin içeriği kontrol sonra değişiklikleri) kontrol. (ContentControlBase kaynağından devralındı.)
	Validated	İçerik denetimi başarıyla doğrulandı oluşur. (ContentControlBase kaynağından devralındı.)
	Validating	İçerik denetim içeriğini doğrulandığı zaman ortaya çıkar. (ContentControlBase kaynağından devralındı.)

Üst

Notlar

A PlainTextContentControl yalnızca metin içerebilir.Metni biçimlendirebilirsiniz bir PlainTextContentControl, ancak denetimdeki metnin tümünü otomatik olarak aynı biçimlendirme.Örneğin, bir sözcük, cümle italik bir PlainTextContentControl, denetimin içindeki tüm metni italik.

Metinde erişmek için bir PlainTextContentControl, kullanma Text özelliği.Varsayılan olarak, bir PlainTextContentControl satır sonları içeremez.Bu davranışı değiştirmek için MultiLine özelliği.

Metin ve diğer birçok tablolar, resimler veya diğer içerik denetimleri de dahil olmak üzere içerik türlerini içeren bir belge bölge oluşturmak için bir RichTextContentControl.

[!NOT]

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

İçerik Denetimleri

PlainTextContentControl , Tasarım belgeleri ve şablonları, Microsoft Office Word için kullanabileceğiniz içerik denetimlerinin sekiz türlerinden biridir.İçerik denetimleri, bir kullanıcı arabirimi (UI) sahip, form gibi giriş kontrol.İçerik denetimleri bir veri kaynağına bağlayabilir ve kullanıcıların belgeyi veya şablonu korumalı bölümleri düzenlemesini engellemek için içerik denetimleri kullanabilirsiniz.Daha fazla bilgi için bkz. İçerik Denetimleri.

Kullanım

Bu belgelerde, .NET Framework 4'ü hedefleyen projelerde 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 PlainTextContentControl belgenin başına.

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

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";
}

Bir uygulama düzeyinde eklenti değildir.Bu kodu kullanmak için içine Yapıştır ThisAddIn sınıfı proje ve çağrı AddTextControlAtSelection yönteminden ThisAddIn_Startup yöntemi.

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

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";
}