BuildingBlockGalleryContentControl – rozhraní

Článek
01/03/2014

Představuje Galerie stavební bloky dokumentů, které mohou uživatelé vložit do dokumentu.

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

Syntaxe

'Deklarace
<GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")> _
Public Interface BuildingBlockGalleryContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")]
public interface BuildingBlockGalleryContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Typ BuildingBlockGalleryContentControl 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.)
	BuildingBlockCategory	Získá nebo nastaví kategorie stavební bloky, které jsou zobrazeny v BuildingBlockGalleryContentControl.
	BuildingBlockType	Získá nebo nastaví typ stavební bloky, které jsou zobrazeny v BuildingBlockGalleryContentControl.
	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é BuildingBlockGalleryContentControl 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 BuildingBlockGalleryContentControl.
	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 BuildingBlockGalleryContentControl lze odstranit z dokumentu.
	LockContents	Získá nebo nastaví hodnotu, která určuje, zda obsah BuildingBlockGalleryContentControl lze upravovat.
	Parent	Načte nadřazený BuildingBlockGalleryContentControl.
	ParentContentControl	Získá obsah nadřazeného řízení BuildingBlockGalleryContentControl který je vnořen do jiného ovládacího prvku obsahu.
	PlaceholderText	Získá nebo nastaví text zobrazený v BuildingBlockGalleryContentControl dokud text se změní akce uživatele nebo jinou operaci.
	Range	Získá Range , která představuje obsah BuildingBlockGalleryContentControl.
	ShowingPlaceholderText	Získá hodnotu, která označuje, zda BuildingBlockGalleryContentControl 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 BuildingBlockGalleryContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda BuildingBlockGalleryContentControl když upravíte ovládací prvek je automaticky odstraněn z dokumentu.
	Text	Získá nebo nastaví text v BuildingBlockGalleryContentControl.
	Title	Získá nebo nastaví název BuildingBlockGalleryContentControl.

Nahoru

Metody

	Název	Popis
	BeginInit	Signály objekt spouštění dané inicializace. (Zděděno z ISupportInitialize.)
	Copy	Kopie BuildingBlockGalleryContentControl z dokumentu do schránky.
	Cut	Odebere BuildingBlockGalleryContentControl 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 Microsoft.Office.Interop.Word.BuildingBlock, Range, nebo řetězec jako zástupný text BuildingBlockGalleryContentControl.

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 BuildingBlockGalleryContentControl zobrazí seznam stavební bloky dokumentů , že uživatelé mohou vkládat do dokumentu.Stavební blok dokumentu je obsah, který byl vytvořen pro použití více než jednou, například společné titulní stránky, formátované tabulce nebo záhlaví.Chcete-li zvolit stavební bloky, které chcete zobrazit, použijte BuildingBlockCategory a BuildingBlockType vlastnosti.

Další informace o stavební bloky dokumentů naleznete v tématu Co je nového pro vývojáře v aplikaci Word 2007.

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

BuildingBlockGalleryContentControl 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ý BuildingBlockGalleryContentControl na začátku dokumentu.BuildingBlockGalleryContentControl Zobrazí rovnice stavební bloky, které jsou k dispozici v aplikaci Microsoft Office Word.

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í AddBuildingBlockControlAtSelection metoda z ThisDocument_Startup metody.

Dim buildingBlockGalleryControl1 As Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl

Private Sub AddBuildingBlockGalleryControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    buildingBlockGalleryControl1 = Me.Controls.AddBuildingBlockGalleryContentControl( _
        "buildingBlockGalleryControl1")
    With buildingBlockGalleryControl1
        .PlaceholderText = "Choose an equation"
        .BuildingBlockCategory = "Built-In"
        .BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
    End With
End Sub

private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl1;

private void AddBuildingBlockControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    buildingBlockControl1 = this.Controls.AddBuildingBlockGalleryContentControl(
        "buildingBlockControl1");
    buildingBlockControl1.PlaceholderText = "Choose an equation";
    buildingBlockControl1.BuildingBlockCategory = "Built-In";
    buildingBlockControl1.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}

Tato verze je aplikace úroveň doplněk.Tento kód použít, vložte jej do ThisAddIn třídy v projektu a volání AddBuildingBlockControlAtSelection metoda z ThisAddIn_Startup metody.

Dim buildingBlockGalleryControl1 As BuildingBlockGalleryContentControl

Private Sub AddBuildingBlockGalleryControlAtSelection()
    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()
    buildingBlockGalleryControl1 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl( _
        "buildingBlockGalleryControl1")
    With buildingBlockGalleryControl1
        .PlaceholderText = "Choose an equation"
        .BuildingBlockCategory = "Built-In"
        .BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
    End With
End Sub

private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl1;

private void AddBuildingBlockControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    buildingBlockControl1 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl(
        "buildingBlockControl1");
    buildingBlockControl1.PlaceholderText = "Choose an equation";
    buildingBlockControl1.BuildingBlockCategory = "Built-In";
    buildingBlockControl1.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}