PictureContentControl – rozhraní
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, označující aplikaci, ve které 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 k ContentControlBase. (Zděděno z ContentControlBase.) |
![]() |
ID | Získá jedinečné číslo, které identifikuje ovládací prvek obsahu. (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 | Načte nadřazený PictureContentControl. |
![]() |
ParentContentControl | Získá obsah nadřazeného řízení 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 mají být zobrazeny uživatelské rozhraní, které mohou uživatelé klepnout a vybrat obrázek, který chcete zobrazit v ovládacím prvku za 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 PictureContentControl. |
![]() |
Temporary | Získá nebo nastaví hodnotu, která určuje, zda PictureContentControl když upravíte ovládací prvek je automaticky odstraněn z dokumentu. |
![]() |
Title | Získá nebo nastaví název PictureContentControl. |
![]() |
XMLMapping | Získá XMLMapping , který představuje vazbu mezi PictureContentControl a prvek 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ý 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.) |
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 PictureContentControl zobrazí obrázek.Můžete určit bitovou kopii v době návrhu nebo běhu nebo klepnutím na tento ovládací prvek vyberte obrázek, který chcete vložit do dokumentu.
Pro získání nebo nastavení obrazu, použijte Image vlastnost.Ve výchozím nastavení, uživatelé nebudou moci změnit obrázek v PictureContentControl v době běhu.Pokud chcete, aby uživatelé mohli zvolit obrázek, který chcete zobrazit 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 Přehled nástrojů Visual Studio Tools for Office runtime.
Ovládací prvky obsahu
PictureContentControl 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ý PictureContentControl na začátku dokumentu.Tento příklad předpokládá, že soubor s názvem obrázek.bmp (pro Windows Vista) existuje ve složce %UserProfile%\Documents nebo %UserProfile%\My složky Dokumenty (pro systém Windows XP a starší).
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í 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 úroveň doplněk.Tento kód použít, vložte jej 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;
}
Viz také
Referenční dokumentace
Microsoft.Office.Tools.Word – obor názvů
Další zdroje
Postupy: Přidání ovládacích prvků obsahu do dokumentů aplikace Word
Postupy: Ochrana částí dokumentů pomocí ovládacích prvků obsahu
Návod: Vytvoření šablony s použitím ovládacích prvků obsahu
Návod: Svázání ovládacích prvků obsahu s vlastními částmi XML