PictureContentControl – rozhraní

Článek
08/11/2011

Představuje oblast dokumentu, která zobrazí bitová kopie.

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á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á PictureContentControl 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.)
	ID	Získá jedinečné číslo identifikující obsah ovládacího prvku. (Zděděno z ContentControlBase.)
	Image	Získá nebo nastaví, že bitová kopie PictureContentControl.
	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 PictureContentControl lze odstranit z dokumentu.
	LockContents	Získá nebo nastaví hodnotu, která určuje, zda obsah PictureContentControl mohou být upravovány.
	Parent	Rodiče získává PictureContentControl.
	ParentContentControl	Získá kontrolu obsahu nadřazeného PictureContentControl který je vnořen do jiného obsahu ovládacího prvku.
	Range	Získává Range , představuje obsah PictureContentControl.
	ShowInsertPictureIcon	Získá nebo nastaví hodnotu, která určuje, zda bude zobrazen, klepnutím vyberte bitová kopie v ovládacím prvku zobrazit při spuštění uživatelského rozhraní.
	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 PictureContentControl.
	Temporary	Získá nebo nastaví hodnotu, která určuje, zda PictureContentControl je automaticky odstraněn z dokumentu po úpravě ovládací.
	Title	Získá nebo nastaví název PictureContentControl.
	XMLMapping	Získává XMLMapping , představuje vazbu mezi PictureContentControl a prvek vlastní XML part.

Na začátek

Metody

	Název	Popis
	BeginInit	Objekt signály spuš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í 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.)

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 PictureContentControl zobrazí bitová kopie. Můžete určit bitová kopie v době návrhu nebo běhu nebo klepnutím vyberte bitová kopie do dokumentu vložit tento ovládací prvek.

Získat nebo nastavit bitová kopie Image vlastnost. Standardně uživatelé nemohou změnit bitová kopie PictureContentControl v čase zpracování. Pokud chcete povolit uživatelům zvolit bitová kopie v ovládacím prvku zobrazit, nastavte ShowInsertPictureIcon vlastnost true.

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

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

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

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 aplikace- doplněkúroveň. Tento kód použít, vložte ji do ThisAddIn třídy v projektu a volání AddPictureControlAtSelection Metoda z ThisAddIn_Startup metody.

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