Condividi tramite


Interfaccia PictureContentControl

Rappresenta un'area del documento in cui viene visualizzata un'immagine.

Spazio dei nomi:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
<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

Il tipo PictureContentControl espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica Application Ottiene un oggetto Microsoft.Office.Interop.Word.Application che rappresenta l'istanza corrente di Microsoft Office Word.
Proprietà pubblica BindingContext Ottiene o imposta la raccolta di l per IBindableComponent. (Ereditato da IBindableComponent)
Proprietà pubblica Container Infrastruttura. (Ereditato da ContentControlBase)
Proprietà pubblica ContainerComponent Infrastruttura. (Ereditato da ContentControlBase)
Proprietà pubblica Creator Ottiene un Integer a 32 bit che indica l'applicazione in cui l'oggetto PictureContentControl è stato creato.
Proprietà pubblica DataBindings Ottiene la raccolta di associazione dati oggetti per questo IBindableComponent. (Ereditato da IBindableComponent)
Proprietà pubblica DefaultDataSourceUpdateMode Ottiene o imposta l'oggetto DataSourceUpdateMode predefinito per ContentControlBase. (Ereditato da ContentControlBase)
Proprietà pubblica ID Ottiene un numero univoco che identifica il controllo contenuto. (Ereditato da ContentControlBase)
Proprietà pubblica Image Ottiene o imposta l'immagine visualizzata da PictureContentControl.
Proprietà pubblica InnerObject Ottiene l'oggetto Microsoft.Office.Interop.Word.ContentControl sottostante per l'oggetto Microsoft.Office.Tools.Word.ContentControlBase. (Ereditato da ContentControlBase)
Proprietà pubblica LockContentControl Ottiene o imposta un valore che specifica se è possibile eliminare PictureContentControl dal documento.
Proprietà pubblica LockContents Ottiene o imposta un valore che specifica la possibilità o meno di modificare il contenuto di PictureContentControl.
Proprietà pubblica Parent Ottiene l'elemento padre di PictureContentControl.
Proprietà pubblica ParentContentControl Ottiene il controllo contenuto padre di un oggetto PictureContentControl annidato all'interno di un altro controllo contenuto.
Proprietà pubblica Range Ottiene un oggetto Range che rappresenta il contenuto di PictureContentControl.
Proprietà pubblica ShowInsertPictureIcon Ottiene o imposta un valore che specifica se visualizzare o meno l'interfaccia utente su cui fare clic per selezionare un'immagine da visualizzare nel controllo in fase di esecuzione.
Proprietà pubblica Site ottiene o imposta ISite associato IComponent. (Ereditato da IComponent)
Proprietà pubblica Tag Ottiene o imposta una stringa da associare a PictureContentControl.
Proprietà pubblica Temporary Ottiene o imposta un valore che specifica se l'oggetto PictureContentControl viene o meno eliminato automaticamente dal documento in caso di modifica del controllo.
Proprietà pubblica Title Ottiene o imposta il titolo della classe PictureContentControl.
Proprietà pubblica XMLMapping Ottiene un oggetto XMLMapping che rappresenta l'associazione tra PictureContentControl e un elemento in una web part XML personalizzata.

In alto

Metodi

  Nome Descrizione
Metodo pubblico BeginInit Segnala l'oggetto che l'inizializzazione è iniziale. (Ereditato da ISupportInitialize)
Metodo pubblico Copy Effettua una copia di PictureContentControl dal documento e la aggiunge agli Appunti.
Metodo pubblico Cut Rimuove l'oggetto PictureContentControl dal documento e lo aggiunge agli Appunti.
Metodo pubblico Delete Elimina dal documento un controllo contenuto creato in modo dinamico e lo rimuove da ControlCollection nel documento. (Ereditato da ContentControlBase)
Metodo pubblico Dispose Esegue le attività definite dall'applicazione associate alla versione, il rilascio, o reimpostare le risorse non gestite. (Ereditato da IDisposable)
Metodo pubblico EndInit segnala l'oggetto che l'inizializzazione è completa. (Ereditato da ISupportInitialize)

In alto

Eventi

  Nome Descrizione
Evento pubblico Added Si verifica dopo l'aggiunta di un controllo contenuto al documento. (Ereditato da ContentControlBase)
Evento pubblico BindingContextChanged Si verifica quando il valore della proprietà BindingContext di ContentControlBase cambia. (Ereditato da ContentControlBase)
Evento pubblico ContentUpdating Si verifica poco prima che Microsoft Office Word aggiorni automaticamente il testo di un controllo contenuto associato a una web part XML personalizzata. (Ereditato da ContentControlBase)
Evento pubblico Deleting Si verifica poco prima dell'eliminazione del controllo contenuto dal documento. (Ereditato da ContentControlBase)
Evento pubblico Disposed rappresenta il metodo che gestisce Disposed evento di un componente. (Ereditato da IComponent)
Evento pubblico Entering Si verifica quando l'utente fa clic nel controllo contenuto oppure quando il cursore viene spostato nel controllo contenuto a livello di codice. (Ereditato da ContentControlBase)
Evento pubblico Exiting Si verifica quando l'utente fa clic all'esterno del controllo contenuto oppure quando il cursore viene spostato all'esterno del controllo contenuto a livello di codice. (Ereditato da ContentControlBase)
Evento pubblico StoreUpdating Si verifica poco prima che Microsoft Office Word aggiorni i dati in una web part XML personalizzata associata al controllo contenuto, vale a dire dopo la modifica del testo nel controllo contenuto. (Ereditato da ContentControlBase)
Evento pubblico Validated Si verifica in caso di esito positivo della convalida del controllo contenuto. (Ereditato da ContentControlBase)
Evento pubblico Validating Si verifica in caso di convalida del contenuto del controllo contenuto. (Ereditato da ContentControlBase)

In alto

Note

PictureContentControl consente di visualizzare un'immagine.È possibile specificare l'immagine in fase di progettazione o di esecuzione. In alternativa è possibile fare clic su questo controllo per selezionare un'immagine da inserire nel documento.

Per ottenere o impostare l'immagine, utilizzare la proprietà Image.Per impostazione predefinita, non è possibile modificare l'immagine in PictureContentControl in fase di esecuzione.Per consentire agli utenti di scegliere l'immagine da visualizzare nel controllo, impostare la proprietà ShowInsertPictureIcon su true.

[!NOTA]

Questa interfaccia è implementata dal Runtime di Visual Studio Tools per Office. Non deve essere implementata nel codice. Per ulteriori informazioni, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

Controlli del contenuto

PictureContentControl è uno degli otto tipi di controlli contenuto utilizzabili per la progettazione di documenti e modelli in Microsoft Office Word.I controlli contenuto dispongono di un'interfaccia utente (UI) con controllo di input come un form.Tali controlli contenuto possono essere utilizzati per impedire la modifica di sezioni protette del documento o del modello e inoltre possono essere associati a un'origine dati.Per ulteriori informazioni, vedere Controlli del contenuto.

Utilizzo

Nella presente documentazione viene descritta la versione di questo tipo utilizzata nei progetti di Office destinati a .NET Framework 4 e .NET Framework 4.5. Nei progetti destinati a .NET Framework 3.5 questo tipo potrebbe avere membri diversi e gli esempi di codice forniti per il tipo potrebbero non funzionare. Per la documentazione relativa a questo tipo nei progetti destinati a .NET Framework 3.5, vedere la sezione di riferimento seguente nella documentazione di Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Esempi

Nell'esempio di codice seguente viene aggiunto un nuovo oggetto PictureContentControl all'inizio del documento.Nell'esempio si presuppone la presenza di un file denominato picture.bmp nella cartella %UserProfile%\My Documents, in Windows XP e versioni precedenti, oppure nella cartella %UserProfile%\Documents, in Windows Vista.

Questa versione è valida per una personalizzazione a livello di documento.Per utilizzare questo codice, incollarlo nella classe ThisDocument del progetto e quindi chiamare il metodo AddPictureControlAtSelection dal metodo ThisDocument_Startup.

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

Questa versione è valida per un componente aggiuntivo a livello di applicazione.Per utilizzare questo codice, incollarlo nella classe ThisAddIn del progetto e quindi chiamare il metodo AddPictureControlAtSelection dal metodo ThisAddIn_Startup.

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

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools.Word

Altre risorse

Controlli del contenuto

Procedura: aggiungere controlli del contenuto ai documenti di Word

Procedura: proteggere parti di documenti mediante i controlli del contenuto

Procedura dettagliata: creazione di un modello utilizzando i controlli del contenuto

Procedura dettagliata: associazione dei controlli del contenuto a parti XML personalizzate