BuildingBlockGalleryContentControl – rozhraní

Článek
05/14/2013

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

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 BuildingBlockGalleryContentControl zobrazí seznam stavební bloky dokumentů , že uživatelé mohou vkládat do dokumentu.Stavební blok dokumentu je část obsahu, který byl vytvořen pro použití více než jednou, například společné titulní stránky, formátované tabulky 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 Visual Studio Tools pro přehled Runtime sady Office.

Ovládací prvky obsahu

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

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

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

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