PictureContentControl Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente une zone du document qui affiche une image.
[System.Runtime.InteropServices.Guid("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")]
public interface PictureContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
- Attributs
- Implémente
Exemples
L’exemple de code suivant ajoute un nouveau PictureContentControl au début du document. Cet exemple suppose qu’un fichier nommé picture.bmp existe dans le dossier%UserProfile%\My 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 ThisDocument classe de votre projet, puis appelez la AddPictureControlAtSelection méthode à partir de la ThisDocument_Startup méthode.
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;
}
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
Cette version est destinée à un complément au niveau de l’application. Pour utiliser ce code, collez-le dans la ThisAddIn classe de votre projet, puis appelez la AddPictureControlAtSelection méthode à partir de la ThisAddIn_Startup méthode.
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;
}
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
Remarques
Un PictureContentControl affiche une image. Vous pouvez spécifier l'image au moment du design ou au moment de l'exécution, ou les utilisateurs peuvent cliquer sur ce contrôle pour sélectionner une image à insérer dans le document.
Pour récupérer ou définir l’image, utilisez la Image propriété. Par défaut, les utilisateurs ne peuvent pas modifier l’image au moment de l' PictureContentControl exécution. Si vous souhaitez permettre aux utilisateurs de choisir l’image à afficher dans le contrôle, affectez la valeur ShowInsertPictureIcon à la propriété 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 Visual Studio Tools for Office Runtime Overview.
Contrôles de contenu
PictureContentControlEst l’un des huit types de contrôles de contenu que vous pouvez utiliser pour concevoir des documents et des modèles dans Microsoft Office Word. Les contrôles de contenu ont une interface utilisateur qui a des entrées contrôlées comme 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 Content Controls.
Utilisation
Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent le .NET Framework 4 ou ultérieur. 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 : http://go.microsoft.com/fwlink/?LinkId=160658.
Propriétés
| Application |
Obtient une Application qui représente l'instance actuelle de Microsoft Office Word. |
| Container | (Hérité de ContentControlBase) |
| ContainerComponent | (Hérité de ContentControlBase) |
| Creator |
Obtient un entier 32 bits qui indique l'application dans laquelle le PictureContentControl a été créé. |
| 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 ContentControl sous-jacent pour le ContentControlBase. (Hérité de ContentControlBase) |
| LockContentControl |
Obtient ou définit une valeur qui indique si le PictureContentControl peut être supprimé du document. |
| LockContents |
Obtient ou définit une valeur qui indique si le contenu du PictureContentControl peut être modifié. |
| Parent |
Obtient 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. |
| 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 d’une partie XML personnalisée. |
Méthodes
| Copy() |
Copie le PictureContentControl du document vers le Presse-papiers. |
| Cut() |
Supprime le PictureContentControl du document et l'ajoute au Presse-papiers. |
| Delete(Boolean) |
Supprime un contrôle de contenu créé dynamiquement dans le document et le supprime de la ControlCollection contenue dans le document. (Hérité de ContentControlBase) |
Événements
| 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) |
| 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 ne mette à jour les données dans une partie XML personnalisée liée au contrôle de contenu (autrement dit, après que le texte du contrôle de contenu a été modifié). (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) |