RichTextContentControl – rozhraní

Článek
05/14/2013

Představuje blok textu nebo jiných typů obsahu v dokumentu.

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

Syntaxe

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

Typ RichTextContentControl 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 RichTextContentControl 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 RichTextContentControl.
	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 RichTextContentControl lze odstranit z dokumentu.
	LockContents	Získá nebo nastaví hodnotu, která určuje, zda obsah RichTextContentControl lze upravovat.
	Parent	Získá rodiče RichTextContentControl.
	ParentContentControl	Získá nadřazený ovládací prvek z obsahu RichTextContentControl který je vnořen do jiného ovládacího prvku obsahu.
	PlaceholderText	Získá nebo nastaví text, který je zobrazen v RichTextContentControl dokud text se změní akce uživatele nebo některé operace.
	Range	Získá Range , která představuje obsah RichTextContentControl.
	ShowingPlaceholderText	Získá hodnotu označující, zda RichTextContentControl 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 RichTextContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda RichTextContentControl je automaticky odstraněn z dokumentu, když upravíte ovládací prvek.
	Text	Získá nebo nastaví text RichTextContentControl.
	Title	Získá nebo nastaví název RichTextContentControl.

Nahoru

Metody

	Název	Popis
	BeginInit	Signály objekt spouštění dané inicializace. (Zděděno z ISupportInitialize.)
	Copy	Kopie RichTextContentControl z dokumentu do schránky.
	Cut	Odebere RichTextContentControl 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 RichTextContentControl.

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 RichTextContentControl může obsahovat text, stejně jako mnoho jiných typů obsahu, včetně tabulek, obrázků nebo jiných ovládacích prvků obsahu.Kombinace formátování a styly můžete aplikovat na text RichTextContentControl.

Chcete-li vytvořit oblast dokumentu, který může obsahovat pouze text, použijte PlainTextContentControl.

[!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

RichTextContentControl 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 RichTextContentControl 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í AddRichTextControlAtSelection metoda z ThisDocument_Startup metoda.

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

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í AddRichTextControlAtSelection metoda z ThisAddIn_Startup metoda.

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