PlainTextContentControl – rozhraní

Článek
05/14/2013

Představuje blok textu v dokumentu.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
<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

Typ PlainTextContentControl zveřejňuje následující členy.

Vlastnosti

	Název	Popis
	Application	Získá Microsoft.Office.Interop.Word.Application , která představuje aktuální instance aplikace Microsoft Office Word.
	BindingContext	Získá nebo nastaví kolekce vedoucích měny IBindableComponent. (Zděděno z IBindableComponent.)
	Container	Infrastruktura. (Zděděno z ContentControlBase.)
	ContainerComponent	Infrastruktura. (Zděděno z ContentControlBase.)
	Creator	Získá 32bitové celé číslo, které označuje aplikace, ve kterém PlainTextContentControl byla vytvořena.
	DataBindings	Získá kolekci objektů vázání dat pro tento IBindableComponent. (Zděděno z IBindableComponent.)
	DefaultDataSourceUpdateMode	Získá nebo nastaví výchozí DataSourceUpdateMode u ContentControlBase. (Zděděno z ContentControlBase.)
	DefaultTextStyle	Získá název znakový styl, který chcete použít k formátování textu v PlainTextContentControl.
	ID	Získá jedinečné číslo identifikující obsah ovládacího prvku. (Zděděno z ContentControlBase.)
	InnerObject	Získá základní Microsoft.Office.Interop.Word.ContentControl pro objekt Microsoft.Office.Tools.Word.ContentControlBase. (Zděděno z ContentControlBase.)
	LockContentControl	Získá nebo nastaví hodnotu, která určuje, zda PlainTextContentControl lze odstranit z dokumentu.
	LockContents	Získá nebo nastaví hodnotu, která určuje, zda obsah PlainTextContentControl lze upravovat.
	MultiLine	Získá nebo nastaví hodnotu, která určuje, zda PlainTextContentControl může obsahovat zalomení řádků.
	Parent	Získá rodiče PlainTextContentControl.
	ParentContentControl	Získá nadřazený ovládací prvek z obsahu PlainTextContentControl který je vnořen do jiného ovládacího prvku obsahu.
	PlaceholderText	Získá nebo nastaví text, který je zobrazen v PlainTextContentControl dokud text se změní akce uživatele nebo některé operace.
	Range	Získá Range , která představuje obsah PlainTextContentControl.
	ShowingPlaceholderText	Získá hodnotu, která určuje, zda PlainTextContentControl aktuálně zobrazuje zástupný text.
	Site	Získá nebo nastaví ISite přidružené IComponent. (Zděděno z IComponent.)
	Tag	Získá nebo nastaví řetězec, který chcete přidružit k PlainTextContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda PlainTextContentControl je automaticky odstraněn z dokumentu, když upravíte ovládací prvek.
	Text	Získá nebo nastaví text PlainTextContentControl.
	Title	Získá nebo nastaví název PlainTextContentControl.
	XMLMapping	Získá XMLMapping , která představuje vazbu mezi PlainTextContentControl a element ve vlastní části XML.

Nahoru

Metody

	Název	Popis
	BeginInit	Signály objekt spouštění dané inicializace. (Zděděno z ISupportInitialize.)
	Copy	Kopie PlainTextContentControl z dokumentu do schránky.
	Cut	Odebere PlainTextContentControl z dokumentu a přidá jej do schránky.
	Delete	Odstraní dynamicky vytvořených ovládacích obsahu z dokumentu a odebere ji z ControlCollection v dokumentu. (Zděděno z ContentControlBase.)
	Dispose	Provádí úkoly definované aplikací spojených s uvolněním, uvolnění nebo obnovení nespravované prostředky. (Zděděno z IDisposable.)
	EndInit	Signály objekt inicializace, že je dokončena. (Zděděno z ISupportInitialize.)
	SetPlaceholderText	Zobrazí text, který je v BuildingBlock, Range, nebo řetězce jako zástupný text PlainTextContentControl.

Nahoru

Události

	Název	Popis
	Added	Nastane poté, co je ovládací prvek obsahu do dokumentu. (Zděděno z ContentControlBase.)
	BindingContextChanged	Dochází při hodnotu BindingContext vlastnost ContentControlBase změny. (Zděděno z ContentControlBase.)
	ContentUpdating	Pokud ovládací prvek obsahu je vázán k vlastní části XML dochází těsně před aktualizací Microsoft Office Word text v ovládacím prvku obsahu. (Zděděno z ContentControlBase.)
	Deleting	Vyvolá se těsně před ovládací prvek obsahu je odstranit z dokumentu. (Zděděno z ContentControlBase.)
	Disposed	Představuje metodu, která zpracovává Disposed události komponenty. (Zděděno z IComponent.)
	Entering	Dojde, když uživatel klikne na ovládací prvek obsahu, nebo pokud kurzor je přesunut do obsahu ovládacího prvku programově. (Zděděno z ContentControlBase.)
	Exiting	Dochází při kliknutí na tlačítko mimo ovládací prvek obsahu, nebo když kurzor se přesune mimo ovládací prvek obsahu programově. (Zděděno z ContentControlBase.)
	StoreUpdating	Právě dříve, než aplikace Microsoft Office Word aktualizuje data ve vlastní části XML, který je vázán na obsah ovládacího prvku (po textu v obsahu řízení změn). (Zděděno z ContentControlBase.)
	Validated	Vyvolá se v případě, že ovládací prvek obsahu byla úspěšně ověřen. (Zděděno z ContentControlBase.)
	Validating	Vyvolá se v případě ověřuje obsah ovládacího prvku obsahu. (Zděděno z ContentControlBase.)

Nahoru

Poznámky

A PlainTextContentControl může obsahovat pouze text.Můžete formátovat text v PlainTextContentControl, ale celý text v ovládacím prvku automaticky má stejné formátování.Například kurzívu jednoho slova, věty, která je PlainTextContentControl, kurzívou veškerý text v ovládacím prvku.

Přístup k textu v PlainTextContentControl, použít Text vlastnost.Ve výchozím nastavení PlainTextContentControl nemůže obsahovat zalomení řádků.Chcete-li toto chování změnit, použijte MultiLine vlastnost.

Chcete-li vytvořit oblast dokumentu obsahující text a mnoho dalších typů obsahu, včetně tabulek, obrázků nebo jiných ovládacích prvků obsahu použijte RichTextContentControl.

[!POZNÁMKA]

Toto rozhraní je implementováno modulem Visual Studio Tools for Office Runtime. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Visual Studio Tools pro přehled Runtime sady Office.

Ovládací prvky obsahu

PlainTextContentControl Je jedním z osmi typů ovládacích prvků obsahu, které můžete použít k návrhu dokumenty a šablony aplikace Microsoft Office Word.Obsahu, že ovládací prvky uživatelského rozhraní (UI), je řízen vstupní formulář, atd.Chcete-li zabránit uživatelům v úpravách chráněné oddíly dokumentu nebo šablony, můžete použít ovládací prvky obsahu a ke zdroji dat můžete také navázat ovládací prvky obsahu.Další informace naleznete v tématu Ovládací prvky obsahu.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených pro rozhraní .NET Framework 4 a .NET Framework 4.5. V projektech cílených pro rozhraní .NET Framework 3.5 může mít tento typ jiné členy a ukázky kódu, poskytnuté pro tento typ, nemusejí fungovat. Dokumentaci k tomuto typu v projektech cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k aplikaci Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

Následující příklad kódu přidá novou PlainTextContentControl na začátek dokumentu.

Tato verze je pro přizpůsobení úroveň dokument.Chcete-li použít tento kód, vložte jej do ThisDocument třídy v projektu a volání AddTextControlAtSelection metoda z ThisDocument_Startup metoda.

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

Tato verze je pro doplněk aplikační úrovni.Chcete-li použít tento kód, vložte jej do ThisAddIn třídy v projektu a volání AddTextControlAtSelection metoda z ThisAddIn_Startup metoda.

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