PictureContentControl – rozhraní

Článek
05/14/2013

Představuje oblast dokumentu, které zobrazí obrázek.

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

Syntaxe

'Deklarace
<GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")> _
Public Interface PictureContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")]
public interface PictureContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Typ PictureContentControl 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, které označuje aplikace, ve kterém PictureContentControl 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.)
	ID	Získá jedinečné číslo identifikující obsah ovládacího prvku. (Zděděno z ContentControlBase.)
	Image	Získá nebo nastaví obrázek, který je zobrazen PictureContentControl.
	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 PictureContentControl lze odstranit z dokumentu.
	LockContents	Získá nebo nastaví hodnotu, která určuje, zda obsah PictureContentControl lze upravovat.
	Parent	Získá rodiče PictureContentControl.
	ParentContentControl	Získá nadřazený ovládací prvek z obsahu PictureContentControl který je vnořen do jiného ovládacího prvku obsahu.
	Range	Získá Range , která představuje obsah PictureContentControl.
	ShowInsertPictureIcon	Získá nebo nastaví hodnotu, která určuje, zda chcete-li zobrazit uživatelské rozhraní, které mohou uživatelé klepnout a vybrat obrázek, který se zobrazí v ovládacím prvku v době běhu.
	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 PictureContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda PictureContentControl je automaticky odstraněn z dokumentu, když upravíte ovládací prvek.
	Title	Získá nebo nastaví název PictureContentControl.
	XMLMapping	Získá XMLMapping , která představuje vazbu mezi PictureContentControl a element ve vlastní části XML.

Nahoru

Metody

	Název	Popis
	BeginInit	Signály objekt spouštění dané inicializace. (Zděděno z ISupportInitialize.)
	Copy	Kopie PictureContentControl z dokumentu do schránky.
	Cut	Odebere PictureContentControl 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.)

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 PictureContentControl zobrazí obrázek.Můžete určit bitovou kopii v době návrhu nebo za běhu, nebo mohou uživatelé kliknout tento ovládací prvek, vyberte obrázek, který chcete vložit do dokumentu.

Chcete-li získat nebo nastavit obrázek, použijte Image vlastnost.Ve výchozím nastavení, uživatelé nemohou změnit obrázek v PictureContentControl v době běhu.Chcete-li povolit uživatelům zvolit obrázek, který se zobrazí v ovládacím prvku, nastavte ShowInsertPictureIcon vlastnost true.

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

PictureContentControl 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 PictureContentControl na začátek dokumentu.Tento příklad předpokládá, že soubor s názvem obrázek.bmp existuje ve složce Dokumenty %UserProfile%\My (pro systém Windows XP a starší) nebo ve složce %UserProfile%\Documents (pro systém Windows Vista).

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

Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap

Private Sub AddPictureControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    pictureControl1 = Me.Controls.AddPictureContentControl("pictureControl1")
    Dim imagePath As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
            "\picture.bmp"
    bitmap1 = New System.Drawing.Bitmap(imagePath, True)
    pictureControl1.Image = bitmap1
End Sub

private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;

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

    pictureControl1 = this.Controls.AddPictureContentControl("pictureControl1");

    string imagePath = System.Environment.GetFolderPath(
        Environment.SpecialFolder.MyDocuments) + "\\picture.bmp";
    bitmap1 = new System.Drawing.Bitmap(imagePath, true);
    pictureControl1.Image = bitmap1;
}

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

Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap

Private Sub AddPictureControlAtSelection()
    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()
    pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1")
    Dim imagePath As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
            "\picture.bmp"
    bitmap1 = New System.Drawing.Bitmap(imagePath, True)
    pictureControl1.Image = bitmap1
End Sub

private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;

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

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

    pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1");

    string imagePath = System.Environment.GetFolderPath(
        Environment.SpecialFolder.MyDocuments) + "\\picture.bmp";
    bitmap1 = new System.Drawing.Bitmap(imagePath, true);
    pictureControl1.Image = bitmap1;
}