BuildingBlockGalleryContentControl – rozhraní

Článek
08/11/2011

Představuje Galerie dokumentu stavební bloky, 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á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.)
	BuildingBlockCategory	Získá nebo nastaví stavební bloky, které jsou zobrazeny v kategorie 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	32Bitové integer označující, ve kterém aplikace získává BuildingBlockGalleryContentControl 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 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.ContentControlproobjekt 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 mohou být upravovány.
	Parent	Rodiče získává BuildingBlockGalleryContentControl.
	ParentContentControl	Získá kontrolu obsahu nadřazeného BuildingBlockGalleryContentControl který je vnořen do jiného obsahu ovládacího prvku.
	PlaceholderText	Získá nebo nastaví text, který se zobrazí BuildingBlockGalleryContentControl dokud změněn akce uživatele nebo některé jiné operace.
	Range	Získává Range , 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 BuildingBlockGalleryContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda BuildingBlockGalleryContentControl je automaticky odstraněn z dokumentu po úpravě ovládací.
	Text	Získá nebo nastaví textu BuildingBlockGalleryContentControl.
	Title	Získá nebo nastaví název BuildingBlockGalleryContentControl.

Na začátek

Metody

	Název	Popis
	BeginInit	Objekt signály spuš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í 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 Microsoft.Office.Interop.Word.BuildingBlock, Range, nebo řetězce jako zástupný text BuildingBlockGalleryContentControl.

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 BuildingBlockGalleryContentControl zobrazí seznam stavební bloky dokumentů , že uživatelé mohou vložit do dokumentu. Stavební blok dokumentu je obsah použít vícekrát jako společné titulní stránky, formátované tabulce nebo hlavičkabyla vytvořena. Zvolte stavební bloky, které chcete zobrazit, použijte BuildingBlockCategory a BuildingBlockType Vlastnosti.

Další informace o dokumentu stavební bloky, viz Co je Nový pro vývojáře v aplikaci Word 2007.

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

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

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í 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- doplněkúroveň. Tento kód použít, vložte ji 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;
}