RichTextContentControl – rozhraní

Článek
01/03/2014

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, označující aplikaci, ve které 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 k 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, které identifikuje ovládací prvek obsahu. (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	Načte nadřazený RichTextContentControl.
	ParentContentControl	Získá obsah nadřazeného řízení RichTextContentControl který je vnořen do jiného ovládacího prvku obsahu.
	PlaceholderText	Získá nebo nastaví text zobrazený v RichTextContentControl dokud text se změní akce uživatele nebo jinou operaci.
	Range	Získá Range , která představuje obsah RichTextContentControl.
	ShowingPlaceholderText	Získá hodnotu, která označuje, zda RichTextContentControl 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 RichTextContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda RichTextContentControl když upravíte ovládací prvek je automaticky odstraněn z dokumentu.
	Text	Získá nebo nastaví text v 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ý ovládací prvek obsahu z dokumentu a odebere ji z ControlCollection v dokumentu. (Zděděno z ContentControlBase.)
	Dispose	Provádí úkoly definované aplikací, které jsou spojeny s uvolněním nebo obnovením nespravovaných prostředků. (Zděděno z IDisposable.)
	EndInit	Signály objekt inicializace, že je dokončena. (Zděděno z ISupportInitialize.)
	SetPlaceholderText	Zobrazí text, který je BuildingBlock, Range, nebo řetězec jako zástupný text RichTextContentControl.

Nahoru

Události

	Název	Popis
	Added	Vyvolá se po přidání ovládacího prvku 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	Nastane těsně před aktualizací aplikace Microsoft Office Word text v ovládacím prvku obsahu, pokud vlastní části XML je vázán ovládací prvek obsahu. (Zděděno z ContentControlBase.)
	Deleting	Nastane těsně před ovládací prvek obsahu z dokumentu odstraněn. (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 když je kurzor přesunut na ovládací prvek obsahu programově. (Zděděno z ContentControlBase.)
	Exiting	Vyvolá se při kliknutí na tlačítko mimo ovládací prvek obsahu, nebo pokud je kurzor přesunut mimo ovládací prvek obsahu programově. (Zděděno z ContentControlBase.)
	StoreUpdating	Dojde bezprostředně před 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ě úspěšně ověřen na ovládací prvek obsahu. (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 Přehled nástrojů Visual Studio Tools for Office runtime.

Ovládací prvky obsahu

RichTextContentControl Je jedním z osmi typů ovládací prvky, které slouží k návrhu dokumenty a šablony aplikace Microsoft Office Word.Obsahu, že ovládací prvky uživatelského rozhraní (UI), je řízen vstupní formulář.Ovládací prvky obsahu můžete uživatelům zabránit v provádění úprav chráněné oddíly dokumentu nebo šablony a zdroje 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 projektů cílených na rozhraní .NET Framework 3.5 naleznete v následující informační části dokumentace k sadě Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Příklady

Následující příklad kódu přidá nový RichTextContentControl na začátku dokumentu.

Tato verze je pro vlastní úpravy úrovni dokumentu.Tento kód použít, vložte jej do ThisDocument třídy v projektu a volání AddRichTextControlAtSelection metoda z ThisDocument_Startup metody.

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 aplikace úroveň doplněk.Tento kód použít, vložte jej do ThisAddIn třídy v projektu a volání AddRichTextControlAtSelection metoda z ThisAddIn_Startup metody.

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