Interfejs PictureContentControl

Artykuł
01/08/2014

Reprezentuje obszar dokumentu, który wyświetla obraz.

Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
<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 uwidacznia następujące elementy członkowskie.

Właściwości

	Nazwa	Opis
	Application	Pobiera Microsoft.Office.Interop.Word.Application reprezentująca w bieżącym wystąpieniu programu Microsoft Office Word.
	BindingContext	Zwraca lub ustawia kolekcji menedżerów waluty IBindableComponent. (Odziedziczone z IBindableComponent).
	Container	Infrastruktura. (Odziedziczone z ContentControlBase).
	ContainerComponent	Infrastruktura. (Odziedziczone z ContentControlBase).
	Creator	Pobiera całkowita 32-bitowa, wskazująca aplikacji, w której PictureContentControl został utworzony.
	DataBindings	Zwraca kolekcję obiektów wiązania danych dla tej IBindableComponent. (Odziedziczone z IBindableComponent).
	DefaultDataSourceUpdateMode	Pobiera lub ustawia domyślną DataSourceUpdateMode dla ContentControlBase. (Odziedziczone z ContentControlBase).
	ID	Pobiera unikatowy numer, który identyfikuje formant zawartości. (Odziedziczone z ContentControlBase).
	Image	Pobiera lub ustawia obraz, który jest wyświetlany przez PictureContentControl.
	InnerObject	Pobiera podstawowych Microsoft.Office.Interop.Word.ContentControl dla obiektu Microsoft.Office.Tools.Word.ContentControlBase. (Odziedziczone z ContentControlBase).
	LockContentControl	Pobiera lub ustawia wartość określająca, czy PictureContentControl może być usunięty z dokumentu.
	LockContents	Pobiera lub ustawia wartość, która określa, czy zawartość PictureContentControl mogą być edytowane.
	Parent	Pobiera element nadrzędny z PictureContentControl.
	ParentContentControl	Pobiera nadrzędnego zawartości kontrolę nad PictureContentControl który jest zagnieżdżony w innym formancie zawartości.
	Range	Pobiera Range reprezentująca zawartość PictureContentControl.
	ShowInsertPictureIcon	Pobiera lub ustawia wartość określającą, czy do wyświetlania interfejsu użytkownika, które użytkownicy mogą klikać, aby wybrać obraz do wyświetlenia w formancie w czasie wykonywania.
	Site	Zwraca lub ustawia ISite związane z IComponent. (Odziedziczone z IComponent).
	Tag	Pobiera lub ustawia ciąg, który ma być skojarzony z PictureContentControl.
	Temporary	Pobiera lub ustawia wartość określająca, czy PictureContentControl jest automatycznie usuwany z dokumentu podczas edycji formantu.
	Title	Pobiera lub ustawia tytuł PictureContentControl.
	XMLMapping	Pobiera XMLMapping reprezentująca powiązania między PictureContentControl i element niestandardowa część kodu XML.

Początek

Metody

	Nazwa	Opis
	BeginInit	Sygnalizuje ten obiekt, że inicjowania jest uruchamiana. (Odziedziczone z ISupportInitialize).
	Copy	Kopie PictureContentControl z dokumentu do Schowka.
	Cut	Usuwa PictureContentControl z dokumentu i dodaje go do Schowka.
	Delete	Usuwa dynamicznie utworzony formant zawartości z dokumentu i usuwa go z ControlCollection w dokumencie. (Odziedziczone z ContentControlBase).
	Dispose	Wykonuje zadania zdefiniowane przez aplikację skojarzone z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów. (Odziedziczone z IDisposable).
	EndInit	Sygnalizuje ten obiekt, że inicjowanie zostanie zakończone. (Odziedziczone z ISupportInitialize).

Początek

Zdarzenia

	Nazwa	Opis
	Added	Występuje po dodaniu formantu zawartości do dokumentu. (Odziedziczone z ContentControlBase).
	BindingContextChanged	Występuje, gdy wartość BindingContext właściwości ContentControlBase zmiany. (Odziedziczone z ContentControlBase).
	ContentUpdating	Występuje tuż przed tekstu w formancie zawartości, aktualizacje programu Microsoft Office Word, jeśli niestandardowa część kodu XML jest powiązany formant zawartości. (Odziedziczone z ContentControlBase).
	Deleting	Występuje tuż przed formant zawartości jest usunięte z dokumentu. (Odziedziczone z ContentControlBase).
	Disposed	Metoda, która obsługuje reprezentuje Disposed zdarzeń składnika. (Odziedziczone z IComponent).
	Entering	Występuje, gdy użytkownik kliknie przycisk w formancie zawartości lub gdy kursor jest przesuwany do formantu zawartości programowo. (Odziedziczone z ContentControlBase).
	Exiting	Występuje, gdy użytkownik kliknie poza formant zawartości lub gdy kursor zostanie przeniesiony poza kontrolą zawartości programowo. (Odziedziczone z ContentControlBase).
	StoreUpdating	Występuje tuż przed programu Microsoft Office Word aktualizuje dane w niestandardowa część kodu XML, powiązaną z zawartością sterowania (po tekstu w treści kontrolować zmiany). (Odziedziczone z ContentControlBase).
	Validated	Występuje, gdy formant zawartości został pomyślnie sprawdzony. (Odziedziczone z ContentControlBase).
	Validating	Występuje, gdy trwa sprawdzanie poprawności zawartości formantu zawartości. (Odziedziczone z ContentControlBase).

Początek

Uwagi

A PictureContentControl Wyświetla obraz.Można określić obraz w czasie projektowania lub uruchomić czasu lub użytkownicy mogą kliknąć ten formant, aby wybrać obraz do wstawienia w dokumencie.

Aby uzyskać lub ustawić obraz, użyj Image właściwość.Domyślnie użytkownicy nie mogą zmieniać obraz w PictureContentControl w czasie wykonywania.Jeśli chcesz umożliwić użytkownikom wybrać obraz wyświetlany w formancie, należy ustawić ShowInsertPictureIcon właściwość, aby true.

[!UWAGA]

Ten interfejs jest implementowany przez Visual Studio Tools for Office Runtime. Nie jest on przeznaczony do implementacji w kodzie. Aby uzyskać więcej informacji, zobacz Visual Studio Tools for Office Runtime ― Przegląd.

Formanty zawartości

PictureContentControl Jest jednym z ośmiu typów formantów zawartości, których można użyć do projektowania dokumentów i szablonów w programie Microsoft Office Word.Zawartość formantów ma interfejs użytkownika (UI) który kontrolował wprowadzania, np.Formanty zawartości można użyć, aby uniemożliwić użytkownikom edytowanie chronionych sekcji dokumentu lub szablonu, a formanty zawartości można również powiązać ze źródłem danych.Aby uzyskać więcej informacji, zobacz Formanty zawartości.

Użycie

W dokumentacji opisano wersję typu używanego w projektach dla pakietu Office przeznaczonych do pracy z programem .NET Framework 4 i .NET Framework 4.5. W projektach przeznaczonych do pracy z programem .NET Framework 3.5 ten typ może mieć inne elementy członkowskie, a przykładowy kod podany dla tego typu może nie działać. Aby uzyskać dokumentację tego typu używanego w projektach przeznaczonych do działania z programem .NET Framework 3.5, zobacz następującą sekcję informacyjną w dokumentacji programu Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Przykłady

Poniższy kod dodaje nowy PictureContentControl do początku dokumentu.W tym przykładzie założono, że plik o nazwie obraz.bmp istnieje w folderze dokumenty %UserProfile%\My (dla systemu Windows XP i starszych) lub w folderze %UserProfile%\Documents (dla systemu Windows Vista).

Ta wersja jest dla dostosowania poziomu dokumentu.Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołanie AddPictureControlAtSelection metodę 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;
}

Ta wersja jest na poziomie aplikacji dodatek.Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie i wywołanie AddPictureControlAtSelection metodę 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;
}