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

Artigo
02/25/2013

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

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

Essa explicação passo a passo mostra as seguintes tarefas:

Criando uma interface usando controles de formulários do windows em um controle do painel ações.
Exibindo o painel de ações quando o aplicativo abrir.

Observação
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário Visual Studio nas instruções a seguir.A edição Visual Studio que você possui e as configurações que você usa determinam esses elementos.Para obter mais informações, consulte Configurações de Visual Studio.

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).

Word 2013 ou Word 2010.

Criando o projeto

A primeira etapa é criar um projeto do documento do word.

para criar um novo projeto

Crie um projeto do documento do word com o nome básico meu painel de ações.Em o assistente, selecione Criar um novo documento.Para obter mais informações, consulte Como: criar projetos do Office em Visual Studio.

O Visual Studio abre o novo documento do word no designer e adiciona o projeto de Meu painel de ações básico a Gerenciador de Soluções.

Adicionando texto e marcadores para o documento

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

Para adicionar texto a seu documento

Digite o seguinte texto em seu documento do word:

21 de março de 2008

Nome

Endereço

Este é um exemplo de um painel básico de ações em palavras.

Você pode adicionar um controle de Bookmark no seu documento arrastando o de Caixa de Ferramentas no Visual Studio ou usando a caixa de diálogo de Indicador em palavras.

Para adicionar um controle do indexador no seu documento

De a guia de Controles do word de Caixa de Ferramentas, arraste um controle de Bookmark no seu documento.

a caixa de diálogo de Adicione o controle do indexador aparece.

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

Observação
A marca de parágrafo deve estar fora do indexador.Se as marcas de parágrafo não são visíveis no documento, clique no menu de FerramentasFerramentas do Microsoft Office Word , aponte para e então clique em Opções.Clique na guia de Modo de Visualização , e selecione a caixa de seleção de Marcas de Parágrafo na seção de Marcas de Formatação da caixa de diálogo de Opções .

A marca de parágrafo deve estar fora do indexador.Se as marcas de parágrafo não são visíveis no documento, clique no menu de FerramentasFerramentas do Microsoft Office Word , aponte para e então clique em Opções.Clique na guia de Modo de Visualização , e selecione a caixa de seleção de Marcas de Parágrafo na seção de Marcas de Formatação da caixa de diálogo de Opções .

Em a janela de Propriedades , altere a propriedade de Nome de Bookmark1 a showName.
Selecione a palavra Endereço, sem selecionar a marca de parágrafo.
Em a guia de Inserir de fita, no grupo de Links , clique em Indicador.
Em a caixa de diálogo de Indicador , digite showAddress na caixa de Nome do marcador e clique Adicionar.

Adicionando controles para o painel de ações

Para criar a interface do painel ações, adicione um controle do painel ações ao projeto e então adicione controles de formulários do windows para o controle do painel ações.

Para adicionar um controle do painel ações

Selecione o projeto de Meu painel de ações básico em Gerenciador de Soluções.
No menu Project, clique em Add New Item.
Em a caixa de diálogo de Adicionar novo item , clique Controle do Painel Ações, nomeie o controle InsertTextControl, e clique Adicionar.

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

Se o controle do painel ações não estiver visível no designer, clique duas vezes InsertTextControl.
De a guia de Controles Comuns de Caixa de Ferramentas, arraste um controle de Rótulo ao controle do painel ações.
Altere a propriedade de Text do controle label a Nome.
Adicionar um controle de Caixa de Texto ao controle do painel ações, e altere as propriedades a seguir.

Propriedade

Valor

Nome

getName

Size (Tamanho)

130, 20
Adicionar um controle de Rótulo do segundo ao controle do painel ações, e altere a propriedade de Texto a Endereço.
Adicionar um controle de Caixa de Texto do segundo ao controle do painel ações, e altere as propriedades a seguir.

Propriedade

Valor

Nome

getAddress

aceita o retorno

True

Multiline (de múltiplas linhas)

True

Size (Tamanho)

130, 40
Adicionar um controle de Botão ao controle do painel ações, e altere as propriedades a seguir.

Propriedade

Valor

Nome

addText

Texto

Inserir

Propriedade	Valor
Nome	getName
Size (Tamanho)	130, 20

Propriedade	Valor
Nome	getAddress
aceita o retorno	True
Multiline (de múltiplas linhas)	True
Size (Tamanho)	130, 40

Propriedade	Valor
Nome	addText
Texto	Inserir

Adicionando código para inserir texto em um documento

Em o painel ações, escreva código que insere o texto das caixas de texto apropriados em controles de Bookmark no documento.Você pode usar a classe para controles de Globals de acesso no documento dos controles no painel ações.Para obter mais informações, consulte Acesso global a objetos em projetos do Office.

Para inserir texto do painel ações em um marcador no documento

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

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

Em C#, você deve adicionar um manipulador de eventos do clique de botão.Você pode colocar esse código no construtor de InsertTextControl após a chamada a 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 do controle.

Para mostrar o painel de ações

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

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

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

Me.ActionsPane.Controls.Add(insertText)

this.ActionsPane.Controls.Add(insertText);

Testando o aplicativo

Teste seu documento para verificar que o painel de ações abre quando o documento está aberto e que o texto digitado nas caixas de texto é inserido nos indicadores quando o botão é clicado.

para testar seu documento

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

Próximas etapas

Aqui estão algumas tarefas que podem vie em seguida:

Criando um painel de ações do excel.Para obter mais informações, consulte How to: Add an Actions Pane to Excel Workbooks.
Associando dados a controles em um painel de ações.Para obter mais informações, consulte Passo a passo: Ligação de dados a controles em um painel de ações do Word.

Consulte também

Compartilhar via