RichTextContentControl – rozhraní

Článek
08/11/2011

Představuje blok textu nebo jiných typů obsah do 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ává Microsoft.Office.Interop.Word.Application , představuje aktuální instance aplikace Word systém Microsoft Office .
	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	32Bitové integer označující, ve kterém aplikace získává RichTextContentControl byl vytvořen.
	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 pro ContentControlBase. (Zděděno z ContentControlBase.)
	DefaultTextStyle	Získá název znakový styl pro formátování textu 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.ContentControlproobjekt 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 mohou být upravovány.
	Parent	Rodiče získává RichTextContentControl.
	ParentContentControl	Získá kontrolu obsahu nadřazeného RichTextContentControl který je vnořen do jiného obsahu ovládacího prvku.
	PlaceholderText	Získá nebo nastaví text, který se zobrazí RichTextContentControl dokud změněn akce uživatele nebo některé jiné operace.
	Range	Získává Range , 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 RichTextContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda RichTextContentControl je automaticky odstraněn z dokumentu po úpravě ovládací.
	Text	Získá nebo nastaví textu RichTextContentControl.
	Title	Získá nebo nastaví název RichTextContentControl.

Na začátek

Metody

	Název	Popis
	BeginInit	Objekt signály spuš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í prvek dynamicky vytvořený obsah z dokumentu a odebere ji ze 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	Objekt signály že Inicializace byla dokončena. (Zděděno z ISupportInitialize.)
	SetPlaceholderText	Zobrazí text v BuildingBlock, Range, nebo řetězce jako zástupný text RichTextContentControl.

Na začátek

Události

	Název	Popis
	Added	Vyvolá se po přidání ovládacího prvku obsah do dokumentu. (Zděděno z ContentControlBase.)
	BindingContextChanged	Dochází při hodnotu BindingContext Vlastnost ContentControlBase změny. (Zděděno z ContentControlBase.)
	ContentUpdating	Dojde před aktualizací systém Microsoft Office Word text v ovládacím prvku obsah obsah ovládací prvek vázán na vlastní části jazyk XML . (Zděděno z ContentControlBase.)
	Deleting	Dochází právě před odstraněním ovládacího prvku obsah 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 klepne v ovládacím prvku obsah nebo kurzor programově přesunuta do ovládacího prvku obsah . (Zděděno z ContentControlBase.)
	Exiting	Dojde, když uživatel klepne mimo kontrolu obsah nebo kurzor programově přesunuta mimo kontrolu obsah . (Zděděno z ContentControlBase.)
	StoreUpdating	Nastane těsně před systém Microsoft Office Word aktualizuje data ve vlastní svázané s obsah jazyk XML části řízení (po text v obsah řízení změn). (Zděděno z ContentControlBase.)
	Validated	Vyvolá se při řízení obsah byl úspěšně ověřen. (Zděděno z ContentControlBase.)
	Validating	Vyvolá se při ověřuje obsah ovládacího prvku obsah . (Zděděno z ContentControlBase.)

Na začátek

Poznámky

A RichTextContentControl mohou obsahovat text, stejně jako mnoho jiných typů obsah, včetně tabulek, obrázků nebo jiných ovládacích prvků obsah . Můžete párovat formátování a styly textu v kombinaci RichTextContentControl.

vytvořit oblast dokumentu, která může obsahovat pouze text, použijte PlainTextContentControl.

Poznámka

Toto rozhraní je implementováno modulem runtime nástrojů Visual Studio Tools for Office. Rozhraní není určeno k implementaci do vašeho kódu. Další informace naleznete v tématu Visual Studio Tools for Office Runtime Overview.

Ovládací prvky obsahu

RichTextContentControl Je jedním z osmi typů ovládacích prvků obsahu lze navrhnout dokumenty a šablony aplikace Microsoft Office Word. Obsahu mají ovládací prvky uživatel rozhraní (UI), byla řízena vstupní formulář, atd. Ovládací prvky obsah můžete zabránit uživatelům v úpravách chráněné oddíly dokumentu nebo šablonaa svázat ovládací prvky obsah zdroj dat. Další informace naleznete v tématu Content Controls.

Použití

Tato dokumentace popisuje verzi tohoto typu, který je používán v projektech systému Office cílených na rozhraní .NET Framework 4. V projektech cílených na rozhraní .NET Framework 3.5 může mít tento typ rozdílné členy a příklady kódů pro tento typ nemusí 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á nový RichTextContentControl na začátku dokumentu.

Tato verze je přizpůsobení úrovni dokumentu. Tento kód použít, vložte ji 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- doplněkúroveň. Tento kód použít, vložte ji 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";
}