PictureContentControl, interface

Article
01/06/2014

Représente une région de document qui affiche une image.

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
<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

Le type PictureContentControl expose les membres suivants.

Propriétés

	Nom	Description
	Application	Obtient une Microsoft.Office.Interop.Word.Application qui représente l'instance actuelle de Microsoft Office Word.
	BindingContext	Obtient ou définit la collection de gestionnaires de devise pour IBindableComponent. (Hérité de IBindableComponent.)
	Container	Infrastructure. (Hérité de ContentControlBase.)
	ContainerComponent	Infrastructure. (Hérité de ContentControlBase.)
	Creator	Obtient un entier 32 bits qui indique l'application dans laquelle le PictureContentControl a été créé.
	DataBindings	Obtient la collection d'objets de liaison de données pour ce IBindableComponent. (Hérité de IBindableComponent.)
	DefaultDataSourceUpdateMode	Obtient ou définit la valeur DataSourceUpdateMode par défaut de ContentControlBase. (Hérité de ContentControlBase.)
	ID	Obtient un nombre unique qui identifie le contrôle de contenu. (Hérité de ContentControlBase.)
	Image	Obtient ou définit l'image affichée par le PictureContentControl.
	InnerObject	Obtient l'objet Microsoft.Office.Interop.Word.ContentControl sous-jacent de Microsoft.Office.Tools.Word.ContentControlBase. (Hérité de ContentControlBase.)
	LockContentControl	Obtient ou définit une valeur qui spécifie si le PictureContentControl peut être supprimé du document.
	LockContents	Obtient ou définit une valeur qui spécifie si le contenu de PictureContentControl peut être modifié.
	Parent	Définit le parent du PictureContentControl.
	ParentContentControl	Obtient le contrôle de contenu parent d'un PictureContentControl imbriqué dans un autre contrôle de contenu.
	Range	Obtient une Range qui représente le contenu du PictureContentControl.
	ShowInsertPictureIcon	Obtient ou définit une valeur qui spécifie s'il faut afficher l'interface utilisateur sur laquelle les utilisateurs peuvent cliquer pour sélectionner une image à afficher dans le contrôle au moment de l'exécution.
	Site	Obtient ou définit le ISite associé à IComponent. (Hérité de IComponent.)
	Tag	Obtient ou définit une chaîne à associer au PictureContentControl.
	Temporary	Obtient ou définit une valeur qui spécifie si le PictureContentControl est supprimé automatiquement du document lorsque le contrôle est modifié.
	Title	Obtient ou définit le titre de la PictureContentControl.
	XMLMapping	Obtient un XMLMapping qui représente la liaison entre le PictureContentControl et un élément dans une partie XML personnalisée.

Début

Méthodes

	Nom	Description
	BeginInit	Signale à l'objet que l'initialisation démarre. (Hérité de ISupportInitialize.)
	Copy	Copie le PictureContentControl du document vers le Presse-papiers.
	Cut	Supprime le PictureContentControl du document et l'ajoute au Presse-papiers.
	Delete	Supprime un contrôle de contenu créé dynamiquement du document et le retire de ControlCollection dans le document. (Hérité de ContentControlBase.)
	Dispose	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de IDisposable.)
	EndInit	Signale à l'objet que l'initialisation est terminée. (Hérité de ISupportInitialize.)

Début

Événements

	Nom	Description
	Added	Se produit après l'ajout du contrôle de contenu au document. (Hérité de ContentControlBase.)
	BindingContextChanged	Se produit lorsque la valeur de la propriété BindingContext de ContentControlBase est modifiée. (Hérité de ContentControlBase.)
	ContentUpdating	Se produit juste avant que Microsoft Office Word mette à jour le texte dans le contrôle de contenu, si ce dernier est lié à une partie XML personnalisée. (Hérité de ContentControlBase.)
	Deleting	Se produit juste avant que le contrôle de contenu soit supprimé du document. (Hérité de ContentControlBase.)
	Disposed	Représente la méthode qui gère l'événement Disposed d'un composant. (Hérité de IComponent.)
	Entering	Se produit lorsque l'utilisateur clique dans le contrôle de contenu ou lorsque le curseur est amené par programme dans le contrôle de contenu. (Hérité de ContentControlBase.)
	Exiting	Se produit lorsque l'utilisateur clique en dehors du contrôle de contenu, ou lorsque le curseur quitte le contrôle de contenu par programme. (Hérité de ContentControlBase.)
	StoreUpdating	Se produit juste avant que Microsoft Office Word mette à jour les données dans une partie XML personnalisée liée au contrôle de contenu (à savoir, après la modification du texte dans le contrôle de contenu). (Hérité de ContentControlBase.)
	Validated	Se produit lorsque le contrôle de contenu a été validé. (Hérité de ContentControlBase.)
	Validating	Se produit lorsque le contenu du contrôle est validé. (Hérité de ContentControlBase.)

Début

Notes

Un PictureContentControl affiche une image. Vous pouvez spécifier l'image au moment du design ou de l'exécution, ou les utilisateurs peuvent cliquer sur ce contrôle pour sélectionner une image à insérer dans le document.

Pour obtenir ou définir l'image, utilisez la propriété Image. Par défaut, les utilisateurs ne peuvent pas modifier l'image dans le PictureContentControl au moment de l'exécution. Si vous souhaitez permettre aux utilisateurs de choisir l'image à afficher dans le contrôle, affectez à la propriété ShowInsertPictureIcon la valeur true.

Notes

Cette interface est implémentée par Visual Studio Tools pour Office Runtime. Elle n'est pas destinée à être implémentée dans votre code. Pour plus d'informations, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime.

Contrôles de contenu

Le PictureContentControl est l'un des huit types de contrôles de contenu que vous pouvez utiliser pour créer des documents et des modèles dans Microsoft Office Word. Les contrôles de contenu ont une interface utilisateur (IU) dont les entrées sont contrôlées comme dans le cas d'un formulaire. Vous pouvez utiliser des contrôles de contenu pour empêcher les utilisateurs de modifier des sections protégées du document ou du modèle et vous pouvez également lier des contrôles de contenu à une source de données. Pour plus d'informations, consultez Contrôles de contenu.

Utilisation

Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent .NET Framework 4 et .NET Framework 4.5. Dans les projets qui ciblent .NET Framework 3.5, ce type peut contenir d'autres membres, et les exemples de code qui y figurent sont susceptibles de ne pas fonctionner. Pour obtenir de la documentation sur ce type dans les projets ciblant .NET Framework 3.5, consultez la section de référence suivante dans la documentation Visual Studio 2008 : https://go.microsoft.com/fwlink/?LinkId=160658.

Exemples

L'exemple de code suivant ajoute un nouveau PictureContentControl au début du document. Cet exemple suppose que le fichier picture.bmp existe dans le dossier %UserProfile%\Mes documents (pour Windows XP et versions antérieures) ou le dossier %UserProfile%\Documents (pour Windows Vista).

Cette version est destinée à une personnalisation au niveau du document. Pour utiliser ce code, collez-le dans la classe ThisDocument de votre projet, puis appelez la méthode AddPictureControlAtSelection à partir de la méthode 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;
}

Cette version est destinée à un complément d'application. Pour utiliser ce code, collez-le dans la classe ThisAddIn de votre projet, puis appelez la méthode AddPictureControlAtSelection à partir de la méthode 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;
}