PictureContentControl Classe (sistema de 2007)

Artigo
08/25/2010

Representa uma região de documento que exibe uma imagem.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (em Microsoft.Office.Tools.Word.v9.0.dll)

Sintaxe

<DefaultBindingPropertyAttribute("Image")> _
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class PictureContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As PictureContentControl

[DefaultBindingPropertyAttribute("Image")]
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class PictureContentControl : ContentControlBase, 
    ISupportInitializeControl, ISupportInitialize

Comentários

A PictureContentControl Exibe uma imagem. Você pode especificar a imagem no time de design ou time de execução ou os usuários podem clicar neste controle para selecionar uma imagem a ser inserida no documento.

Para obter ou conjunto a imagem, use o Image propriedade. Por padrão, os usuários não podem alterar a imagem no PictureContentControl em time de execução. Se você desejar permitir que os usuários escolher a imagem a ser exibida no controle, defina o ShowInsertPictureIcon propriedade para true.

Controles de conteúdo

The PictureContentControl é um dos oito tipos de controles de conteúdo que você pode usar para documentos de design e modelos no Microsoft Office palavra. Conteúdo controles possuem uma interface de usuário (UI) que tem controlada entrada como um formulário.Você pode usar controles de conteúdo para impedir que os usuários editem seções protegidas do documento ou modelo e você também pode BIND controles de conteúdo a uma fonte de dados.Para obter mais informações, consulte Os controles de conteúdo.

Exemplos

O exemplo de código a seguir adiciona um novo PictureContentControl para o início do documento. Este exemplo assume que um arquivo chamado imagem.bmp existe na pasta Documents %UserProfile%\My (para Windows XP e anterior) ou a pasta %UserProfile%\Documents (para Windows Vista).

Esta versão é para uma personalização em nível de documento.Para usar esse código, cole-o no ThisDocument classe em seu projeto e a telefonar a AddPictureControlAtSelection método a partir do ThisDocument_Startup método.

Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap

PrivateSub AddPictureControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    pictureControl1 = Me.Controls.AddPictureContentControl("pictureControl1")
    Dim imagePath AsString = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
            "\picture.bmp"
    bitmap1 = New System.Drawing.Bitmap(imagePath, True)
    pictureControl1.Image = bitmap1
EndSub

private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;

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

Esta versão é para um suplemento no nível de aplicativo.Para usar esse código, cole-o no ThisAddIn classe em seu projeto e a telefonar a AddPictureControlAtSelection método a partir do ThisAddIn_Startup método.

Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap

PrivateSub AddPictureControlAtSelection()
    IfMe.Application.ActiveDocument IsNothingThenReturnEndIfDim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1")
    Dim imagePath AsString = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
            "\picture.bmp"
    bitmap1 = New System.Drawing.Bitmap(imagePath, True)
    pictureControl1.Image = bitmap1
EndSub

private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;

privatevoid AddPictureControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = this.Application.ActiveDocument.GetVstoObject();
    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;
}

Hierarquia de herança

System.Object
  Microsoft.VisualStudio.Tools.Office.RemoteComponent
    Microsoft.VisualStudio.Tools.Office.RemoteBindableComponent
      Microsoft.Office.Tools.Word.ContentControlBase
        Microsoft.Office.Tools.Word.PictureContentControl

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.