Interface PictureContentControl
Representa uma região de documento que exibe uma imagem.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)
Sintaxe
'Declaração
<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
O tipo PictureContentControl expõe os membros a seguir.
Propriedades
Nome | Descrição | |
---|---|---|
![]() |
Application | Obtém um Microsoft.Office.Interop.Word.Application que representa a instância atual do Word de Microsoft Office. |
![]() |
BindingContext | Obtém ou define uma coleção dos gerenciadores de moeda para o IBindableComponent. (Herdado de IBindableComponent.) |
![]() |
Container | Infraestrutura. (Herdado de ContentControlBase.) |
![]() |
ContainerComponent | Infraestrutura. (Herdado de ContentControlBase.) |
![]() |
Creator | Obtém um inteiro de 32 bits que indica o aplicativo no qual o PictureContentControl foi criado. |
![]() |
DataBindings | Obtém a coleção de objetos de ligação de dados para este IBindableComponent. (Herdado de IBindableComponent.) |
![]() |
DefaultDataSourceUpdateMode | Obtém ou define o padrão DataSourceUpdateMode para o ContentControlBase. (Herdado de ContentControlBase.) |
![]() |
ID | Obtém um número exclusivo que identifica o controle de conteúdo. (Herdado de ContentControlBase.) |
![]() |
Image | Obtém ou define a imagem que é exibida, o PictureContentControl. |
![]() |
InnerObject | Obtém a base Microsoft.Office.Interop.Word.ContentControl de objeto para o Microsoft.Office.Tools.Word.ContentControlBase. (Herdado de ContentControlBase.) |
![]() |
LockContentControl | Obtém ou define um valor que especifica se o PictureContentControl pode ser excluído do documento. |
![]() |
LockContents | Obtém ou define um valor que especifica se o conteúdo da PictureContentControl pode ser editado. |
![]() |
Parent | Obtém o pai do PictureContentControl. |
![]() |
ParentContentControl | Obtém o pai de controle de conteúdo uma PictureContentControl que está aninhado em outro controle de conteúdo. |
![]() |
Range | Obtém um Range que representa o conteúdo do PictureContentControl. |
![]() |
ShowInsertPictureIcon | Obtém ou define um valor que especifica se deve exibir a interface do usuário que os usuários podem clicar para selecionar uma imagem para exibir no controle em tempo de execução. |
![]() |
Site | Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.) |
![]() |
Tag | Obtém ou define uma seqüência de caracteres que você deseja associar a PictureContentControl. |
![]() |
Temporary | Obtém ou define um valor que especifica se o PictureContentControl é excluído automaticamente do documento quando o controle é editado. |
![]() |
Title | Obtém ou define o título da PictureContentControl. |
![]() |
XMLMapping | Obtém um XMLMapping que representa a ligação entre o PictureContentControl e um elemento em um part. XML personalizado |
Início
Métodos
Nome | Descrição | |
---|---|---|
![]() |
BeginInit | Sinaliza o objeto que a inicialização está iniciando. (Herdado de ISupportInitialize.) |
![]() |
Copy | Cópias do PictureContentControl do documento para a área de transferência. |
![]() |
Cut | Remove o PictureContentControl do documento e o adiciona à área de transferência. |
![]() |
Delete | Exclui um controle criado dinamicamente do conteúdo do documento e remove a partir do ControlCollection do documento. (Herdado de ContentControlBase.) |
![]() |
Dispose | Executa tarefas de definição de aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.) |
![]() |
EndInit | Sinaliza o objeto que a inicialização for concluída. (Herdado de ISupportInitialize.) |
Início
Eventos
Nome | Descrição | |
---|---|---|
![]() |
Added | Ocorre após o controle de conteúdo é adicionado ao documento. (Herdado de ContentControlBase.) |
![]() |
BindingContextChanged | Ocorre quando o valor da BindingContext propriedade da ContentControlBase alterações. (Herdado de ContentControlBase.) |
![]() |
ContentUpdating | Ocorre antes de Microsoft Office o Word atualiza o texto no controle content, se o controle de conteúdo está vinculado a um componente XML personalizado. (Herdado de ContentControlBase.) |
![]() |
Deleting | Ocorre antes do controle de conteúdo é excluído do documento. (Herdado de ContentControlBase.) |
![]() |
Disposed | Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.) |
![]() |
Entering | Ocorre quando o usuário clica no controle content, ou quando o cursor é movido para o controle de conteúdo por meio de programação. (Herdado de ContentControlBase.) |
![]() |
Exiting | Ocorre quando o usuário clica fora do controle de conteúdo, ou quando o cursor é movido programaticamente fora do controle de conteúdo. (Herdado de ContentControlBase.) |
![]() |
StoreUpdating | Ocorre antes de Microsoft Office o Word atualiza dados em uma parte XML personalizada vinculada ao conteúdo do controle (ou seja, depois que o texto no conteúdo de controle de alterações). (Herdado de ContentControlBase.) |
![]() |
Validated | Ocorre quando o controle de conteúdo foi validado com êxito. (Herdado de ContentControlBase.) |
![]() |
Validating | Ocorre quando o conteúdo do controle de conteúdo está sendo validado. (Herdado de ContentControlBase.) |
Início
Comentários
A PictureContentControl exibe uma imagem. Você pode especificar a imagem no tempo de design ou tempo de execução, ou os usuários podem clicar esse controle para selecionar uma imagem para inserir no documento.
Para obter ou definir a imagem, use o Image propriedade. Por padrão, os usuários não podem alterar a imagem de PictureContentControl em tempo de execução. Se você quiser que os usuários possam escolher a imagem para exibir no controle, defina a ShowInsertPictureIcon propriedade para true.
![]() |
---|
Esta interface é implementada pelo Visual Studio Tools for Office runtime. Ela não se destina a ser implementada em seu código. Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução. |
Controles de conteúdo
O PictureContentControl é um dos oito tipos de controles de conteúdo que você pode usar para criar documentos e modelos do Word de Microsoft Office. Conteúdo de controles possuem uma interface de usuário (UI) que foi controlada entrada como um formulário. Você pode usar controles de conteúdo para impedir que usuários editem seções protegidas do documento ou modelo, e você também pode vincular controles de conteúdo a uma fonte de dados. For more information, see Controles de conteúdo.
Usage
Esta documentação descreve a versão deste tipo que é usada em projetos do Office destinados ao .NET Framework 4. Em projetos destinados ao .NET Framework 3.5, este tipo poderá ter membros diferentes, e os exemplos de código fornecidos para o tipo talvez não funcionem. Para obter documentação sobre este tipo em projetos destinados ao .NET Framework 3.5, consulte a seguinte seção de referência na documentação do Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.
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 Picture. bmp existe na pasta %USERPROFILE%\Meus documentos (para Windows XP e versões anteriores) ou na pasta de %UserProfile%\Documents (para Windows Vista).
Esta versão é para uma personalização em nível de documento. Para usar esse código, colá-lo na ThisDocument classe em seu projeto e a chamada 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
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;
}
Esta versão é um suplemento em nível de aplicativo. Para usar esse código, colá-lo na ThisAddIn classe em seu projeto e a chamada 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
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;
}
Consulte também
Referência
Namespace Microsoft.Office.Tools.Word
Outros recursos
Como: Adicionar controles de conteúdo para documentos do Word
Como: Proteger partes de documentos usando os controles de conteúdo
Demonstra Passo a passo: Criando um modelo usando os controles de conteúdo
Demonstra Passo a passo: Controles de conteúdo de ligação para partes do XML personalizado