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

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de documento Versão do Microsoft Office Word 2007 Word 2003 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de documento

Versão do Microsoft Office

Word 2007
Word 2003

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

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

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

Criando uma interface usando controles Windows Forms em um controle de painel de ações.
Exibir o painel de ações quando o aplicativo é aberto.

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

Pré-requisitos

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

Ferramentas do Visual Studio para o Office (um componente opcional do O Visual Studio 2008 Professional e Visual Studio Team System).
O Microsoft Office Word 2003 ou Microsoft Office Word 2007.

Ferramentas do Visual Studio para o Office é instalado por padrão com as versões listadas do Visual Studio.Para Marcar se ele está instalado, Marcar Instalando o Visual Studio Tools para Office.

Criando o projeto

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

Para criar um novo projeto

Crie um projeto de documento do Word com o nome Meu Basic ações painel.No assistente, Selecionar Criar um documento novo.For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

O Visual Studio abre o novo documento do Word no designer e adiciona o projeto de meu painel de ações básica para Gerenciador de Soluções.

Adicionando texto e indicadores o documento

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

Para adicionar texto a seu documento

tipo o seguinte texto no seu documento do Word:

21.03.08

Nome

Endereço

Este é um exemplo de um Basic painel de ações no Word.

Você pode adicionar um Controlarar de Bookmark ao seu documento arrastando-o de Caixa de Ferramentas no Visual Studio ou usando a caixa de diálogo Indicador caixa no Word.

Para adicionar um Controlarar de indicador a seu documento

Na guia Controles do Word de De caixa de ferramentas, arraste um controle de Bookmark ao seu documento.

A caixa de diálogo Adicionar indicador Controlarar 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 estiverVisível no documento, clique na Menu de de ferramentas, aponte para Ferramentas do Microsoft Office Word e, em seguida, clique em Opções.Clique na guia de exibir e Selecionar De marcas de parágrafo Caixa de Marcar in the Formatação marca seção da Opções caixa de diálogo.

Na janela Properties, Alterar Propriedade Name Bookmark1 a showName.
Selecione a palavra Endereços, sem selecionar a marca de parágrafo.
Execute uma das seguintes etapas:
- Para o Word 2003: No menu Inserir, clique em Indicador.
- Para o Word 2007: No Guia de inserir da Faixa de Opções, no AAgruparar links, clique em Indicador.
Na caixa de diálogo Indicador , tipo showAddress no Nome do indicador caixa e clique em Adicionar.

Adicionando controles para o painel de ações

Para Design a interface do painel de ações, adicione um controle de painel de ações ao projeto e, em seguida, adicionar controles de Windows Forms o controle do painel de ações.

Para adicionar um Controlarar de painel de ações

Selecionar o projeto de meu painel de ações básicas no Gerenciador de Soluções.
No menu Project, clique em Add New Item.
Em Add Novo Item Caixa de Diálogo, clique em De controle do painel de ações, nomeie o controle InsertTextControl, e clique em Adicionar.

Para Adicionar Windows Formulário controles para o controle do painel de ações

Se o controle do painel de ações não estiver visível no designer, clique Duplo em InsertTextControl.
Na guia Controles ComComumComum de De caixa de ferramentas, arraste Comum controle do Rótulo para o controle de painel Ações.
Alterar a propriedade Text do Controlarar Rótulo para nome.
Adicionar um Controlarar do Caixa de Texto ao Controlarar do painel de ações e alterar as propriedades a seguir.

Propriedade

Value (Valor)

Nome

getName

Size (Tamanho)

130, 20
Adicionar um segundo Controlarar do Rótulo ao Controlarar do painel de ações e alterar Texto propriedade para endereços.
Adicionar um segundo Caixa de texto Controlarar ao Controlarar do painel de ações e alterar as propriedades a seguir.

Propriedade

Value (Valor)

Nome

getAddress

Aceita retornar

True

Multiline (de múltiplas linhas)

True

Size (Tamanho)

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

Propriedade

Value (Valor)

Nome

addText

Texto

Inserir

Propriedade	Value (Valor)
Nome	getName
Size (Tamanho)	130, 20

Propriedade	Value (Valor)
Nome	getAddress
Aceita retornar	True
Multiline (de múltiplas linhas)	True
Size (Tamanho)	130, 40

Propriedade	Value (Valor)
Nome	addText
Texto	Inserir

Adicionando código para inserir texto no documento

No painel de ações, Gravar código que insere o texto das caixas de texto nos controles apropriados Bookmark no documento.Você pode usar a classe de Globals para acessar controles no documento dos controles no painel de ações.For more information, see Global Acessar a objetos no Visual Studio Tools para projetos do Office.

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

Adicione o seguinte código ao manipulador de eventos do botão Click 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 para o clique do botão.Você pode colocar esse código no construtor InsertTextControl após a chamada para IntializeComponent.Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos no Visual Studio Tools for 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, Adicionar o Controlarar criado para a coleção de Controlarar.

Para mostrar o painel de ações

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

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

Adicionar o código a seguir ao manipulador de eventos de StartupThisDocument.

Me.ActionsPane.Controls.Add(insertText)

this.ActionsPane.Controls.Add(insertText);

Testando o aplicativo

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

Para testar seu documento

Pressionarionar F5 para executar seu projeto.
Confirme se o painel de ações é visível.
tipo seu nome e endereço nas caixas de texto on the ações painel e clique em Inserir.