Demonstra Passo a passo: Inserir um texto em um documento a partir de um painel de ações

Artigo
08/08/2011

Esta explicação passo a passo demonstra como criar um painel de ações em um documento do Word de Microsoft Office. O painel de ações contém dois controles que coletam a entrada e, em seguida, enviar o texto no documento.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento para Word 2007 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

This walkthrough illustrates the following tasks:

Projetando uma interface usando os controles Windows Forms em um controle de painel de ações.
Quando o aplicativo é aberto, exibindo o painel de ações.

Observação
Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Trabalhando com configurações.

Pré-requisitos

You need the following components to complete this walkthrough:

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).

Word 2007 ou Word 2010.

Creating the Project

A primeira etapa é criar um projeto de documento do Word.

Para criar um novo projeto.

Crie um projeto de documento do Word com o nome do meu painel de ações básicas. No assistente, selecione criar um novo documento. For more information, see Como: Criar projetos do Office em Visual Studio.

Abre o novo documento do Word no designer de Visual Studio e adiciona o Meu painel de ações básicas de projeto para Solution Explorer.

Adicionando texto e os indicadores no documento

O painel de ações enviará o texto para indicadores do documento. Para criar o documento, digite algum texto para criar um formulário básico.

Para adicionar texto ao documento

Digite o seguinte texto no documento do Word:

Em 21 de março de 2008

Name

Address

Este é um exemplo de um painel de ações básicas no Word.

Você pode adicionar um Bookmark controle ao seu documento, arrastando-a partir de Toolbox no Visual Studio ou usando o indicador caixa de diálogo do Word.

Para adicionar um controle de indicador ao seu documento.

Do Controles do Word guia do Toolbox, arraste um Bookmark o controle para o seu documento.

O Adicionar indicador de controle caixa de diálogo aparece.

Selecione a palavra nome, sem selecionar a marca de parágrafo e clique em OK.

Observação
A marca de parágrafo deve ser fora do indicador. Se as marcas de parágrafo não estiverem visíveis no documento, clique o Ferramentas , aponte para Ferramentas de Word Microsoft Office e, em seguida, clique em Opções. Clique o Exibir guia e selecione o marcas de parágrafo caixa de seleção a marcas de formatação seção a Opções caixa de diálogo.

No Propriedades janela, alterar o nome propriedade de Bookmark1 para showName.
Selecione a palavra endereço, sem selecionar a marca de parágrafo.
No Inserir guia da faixa de opções, no Links de grupo, clique em indicador.
No indicador caixa de diálogo, digite showAddress na Nome do indicador caixa e clique em Add.

Adicionar controles ao painel Ações

Para criar a interface do painel de ações, adicione um controle do painel de ações ao projeto e adicione controles Windows Forms para o controle do painel de ações.

Para adicionar um controle de painel de ações

Selecione o Meu painel de ações básicas projeto em Solution Explorer.
On the Project menu, click Add New Item.
No Add New Item caixa de diálogo, clique em Controle de painel de ações, nome do controle InsertTextControl, e clique em Add.

Para adicionar controles de formulários do Windows para o controle do painel de ações

Se o controle do painel de ações não estiver visível no designer, clique duas vezes em InsertTextControl.
Do Controles comuns guia da caixa de ferramentas, arraste um rótulo controle para o controle do painel de ações.
Alterar o Text a propriedade do controle Label para nome.
Adicionar um caixa de texto o controle para o controle do painel de ações e alterar as propriedades a seguir.

Property

Value

Name

getName

Size

130, 20
Adicionar um segundo rótulo o controle para o controle do painel de ações e, em seguida, altere o texto propriedade para endereço.
Adicionar um segundo caixa de texto o controle para o controle do painel de ações e alterar as propriedades a seguir.

Property

Value

Name

getAddress

Aceita retorno

True

Multiline

True

Size

130, 40
Adicionar um botão o controle para o controle do painel de ações e alterar as propriedades a seguir.

Property

Value

Name

addText

Text

Insert

Property	Value
Name	getName
Size	130, 20

Property	Value
Name	getAddress
Aceita retorno	True
Multiline	True
Size	130, 40

Property	Value
Name	addText
Text	Insert

Adicionando código para inserir texto no documento

No painel de ações, escrever um código que insere o texto nas caixas de texto apropriado Bookmark controles no documento. Você pode usar o Globals a classe para acessar controles no documento dos controles no painel de ações. For more information, see Acesso global a objetos em projetos do Office.

Para inserir texto no painel de ações em um indicador no documento

Adicione o seguinte código para o Click o manipulador de eventos da addText botão.

Private Sub addText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles addText.Click

    If Me.getName.Text <> String.Empty Then
        Globals.ThisDocument.showName.Text = Me.getName.Text
    End If

    If Me.getAddress.Text <> String.Empty Then
        Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
    End If

    Me.getName.Text = String.Empty
    Me.getAddress.Text = String.Empty
End Sub

private void addText_Click(object sender, System.EventArgs e)
{
    if (this.getName.Text != String.Empty) 
    {
        Globals.ThisDocument.showName.Text = this.getName.Text;
    }

    if (this.getAddress.Text != String.Empty)
    {
        Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
    }

    this.getName.Text = String.Empty;
    this.getAddress.Text = String.Empty;
}

C#, você deve adicionar um manipulador para o clique do botão. Você pode colocar esse código de InsertTextControl construtor após a chamada para IntializeComponent. Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do Office.
```
public InsertTextControl()
{
    InitializeComponent();
    this.addText.Click += new EventHandler(addText_Click);
}
```

Adicionando código para mostrar o painel de ações

Para mostrar o painel de ações, adicione o controle que você criou para a coleção de controle.

Para mostrar o painel de ações

Criar uma nova instância do controle de painel de ações na ThisDocument classe.

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

Adicione o seguinte código para o Startup o manipulador de eventos de ThisDocument.

Me.ActionsPane.Controls.Add(insertText)

this.ActionsPane.Controls.Add(insertText);

Testing the Application

Teste seu documento para verificar se o painel de ações é aberta quando o documento é aberto e que o texto digitado nas caixas de texto é inserido nos marcadores quando o botão é clicado.

Para testar seu documento.

Pressione F5 para executar seu projeto.
Confirme se o painel de ações está visível.
Digite seu nome e endereço nas caixas de texto no painel de ações e clique em Inserir.

Próximas etapas

Here are some tasks that might come next:

Criando um painel de ações no Excel. For more information, see Como: Adicionar um painel de ações para pastas de trabalho do Excel.
Ligação de dados a controles em um painel de ações. For more information, see Demonstra Passo a passo: A vinculação de dados a controles em um painel de ações do Word.
Mostrar e ocultar controles no painel actions. For more information, see Demonstra Passo a passo: Alterando o painel de ações, de acordo com o contexto de usuário.

Consulte também

Partilhar via