Demonstra Passo a passo: Atualizar um gráfico em um documento usando os botões de Rádio

Esta explicação passo a passo demonstra como usar botões de Rádio em uma personalização de nível de documento do Microsoft Office Word para dar aos usuários o Rádio para selecionar estilos de gráfico no documento.

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

• Adicionar um gráfico ao documento em um projeto de nível de documento em tempo de design.

• Agrupamento botões de Rádio adicionando-os a um Controlarar de usuário.

• Alterando o estilo de gráfico quando uma opção é Selecionadoda.

Para ver o resultado como um exemplo completo, consulte Exemplo de controles do Word.

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.

Esta explicação passo a passo usa os menus no Word 2003, mas as mesmas opções estão disponíveis na Faixa de Opções do Word 2007.

Criando o projeto

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

Para criar um novo projeto

• Criar um projeto de documento do Word com o nome Minhas opções de gráfico.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 Minhas opções de gráfico para Gerenciador de Soluções.

Adicionar um gráfico ao documento

Em projetos do Word 2003, o menu de inserir a barra de ferramentas Visual Studio contém os comandos de Word para adicionar um gráfico.

Para adicionar um gráfico

1. No menu Inserir, clique em Objeto.

   A caixa de diálogo de objeto é aberta.

   Observação:
   Se a Inserir menu não estiver visível, você deve primeiro Clique dentro do documento para que ele foco.Para obter mais informações, consulte: Menus do Office no ambiente do Visual Studio.

2. Na lista Objeto tipo na guia Criar novo , Selecionar De gráfico do Microsoft Graph e clique em OK de .

   Um gráfico é adicionado ao documento no ponto de inserção, e a janela de folha de dados aparece com alguns dados padrão.

3. Fechar a janela de De folha de dados para aceite os valores padrão no gráfico e clique em dentro do documento para mover o foco fora do gráfico.

4. Clique com o botão direito do mouse o gráfico e clique em Formatar objeto.

5. Na guia Layout da Formatar objeto caixa de diálogo, Selecionar Quadrado e clique em OK.

Adicionar um controle de usuário ao projeto

Botões de Rádio em um documento não são mutuamente Exclusivo por padrão.Você pode torná-los Função corretamente, adicionando-os para um controle de usuário e, em seguida, escrever código para controlar a seleção.

Para adicionar um Controlarar de usuário

1. Selecionar o projeto de Minhas opções de gráfico na Gerenciador de Soluções.

2. No menu Project, clique em Add New Item.

3. Em Add Novo Item Caixa de Diálogo, clique em do Controlarar de usuário, nomeie o Controlarar ChartOptions, e clique em Adicionar.

Para Adicionar Windows Formulário controles para o controle de usuário

1. Se o Controlarar de usuário não estiver visível no designer, clique Duplo ChartOptions em Gerenciador de Soluções.

2. Na guia Controles ComumComumum de De caixa de ferramentas, arraste a Primeiro Controle de botão de Rádio para o controle de usuário, e Alterar as propriedades a seguir.

   Propriedade	Value (Valor)
   Nome	columnChart
   Texto	Gráfico de colunas

3. Adicionar um segundo De botão de Rádio para o Controlarar de usuário e alterar as propriedades a seguir.

   Propriedade	Value (Valor)
   Nome	barChart
   Texto	Gráfico de barras

4. Adicionar um terceiro De botão de Rádio para o Controlarar de usuário e alterar as propriedades a seguir.

   Propriedade	Value (Valor)
   Nome	lineChart
   Texto	Gráfico de linhas

5. Adicionar uma quarta De botão de Rádio para o Controlarar de usuário e alterar as propriedades a seguir.

   Propriedade	Value (Valor)
   Nome	areaBlockChart
   Texto	Gráfico de Bloquear de área

Adicionar Referências

Para acessar o gráfico do Controlarar de usuário em um documento, você deve ter uma referência à biblioteca de objetos do Microsoft gráfico 11.0 em seu projeto.

Para adicionar uma referência à biblioteca de objetos do Microsoft Graph 11.0

1. No menu Project, escolha Add Reference.

   O Adicionar Referência caixa de diálogo é exibida.

2. Clique na guia de COM.

3. Selecionar De biblioteca de objetos do Microsoft Graph 11.0 na lista nome do componente e clique em OK.

Alterar o estilo de gráfico quando um botão de Rádio é selecionado

Para tornar os botões funcionem corretamente, criar um evento público sobre o Controlarar de usuário, adicionar uma propriedade para definir o tipo de seleção e crie um procedimento para o evento CheckedChanged de cada um dos botões de Rádio.

Para criar um evento e a propriedade em um Controlarar de usuário

1. Em Gerenciador de Soluções, clique com o botão direito do mouse o Controlare de usuário e clique em Exibir Code.

2. Adicionar código para criar um evento de SelectionChanged e a propriedade Selection à classe ChartOptions.

   Public Event SelectionChanged(ByVal sender As System.Object, ByVal e As System.EventArgs)
   
   Private selectedType As Microsoft.Office.Interop.Graph.XlChartType = _
       Microsoft.Office.Interop.Graph.XlChartType.xlColumnClustered
   
   Public Property Selection() As Microsoft.Office.Interop.Graph.XlChartType
       Get
           Return Me.selectedType
       End Get
       Set(ByVal value As Microsoft.Office.Interop.Graph.XlChartType)
           Me.selectedType = value
       End Set
   End Property
   

   public event EventHandler SelectionChanged;
   
   private Microsoft.Office.Interop.Graph.XlChartType selectedType =
       Microsoft.Office.Interop.Graph.XlChartType.xlColumnClustered;
   
   public Microsoft.Office.Interop.Graph.XlChartType Selection
   {
       get
       {
           return this.selectedType;
       }
       set
       {
           this.selectedType = value;
       }
   }
   

Para manipular o evento CheckedChange dos botões de rádio

1. Defina o tipo de gráfico no manipulador de eventos de CheckedChanged do botão de Rádio areaBlockChart e, em seguida, aumentar o evento.

   Private Sub areaBlockChart_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles areaBlockChart.CheckedChanged
   
       If (CType(sender, RadioButton).Checked) Then
   
           Me.selectedType = Microsoft.Office.Interop.Graph.XlChartType.xlAreaStacked
           RaiseEvent SelectionChanged(Me, EventArgs.Empty)
       End If
   End Sub
   

   private void areaBlockChart_CheckedChanged(object sender, EventArgs e)
   {
       if (((RadioButton)sender).Checked)
       {
           this.selectedType = Microsoft.Office.Interop.Graph.XlChartType.xlAreaStacked;
           if (this.SelectionChanged != null)
           {
               this.SelectionChanged(this, EventArgs.Empty);
           }
       }
   }
   

2. Defina o tipo de gráfico no manipulador de eventos de CheckedChanged do botão de Rádio barChart.

   Private Sub barChart_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles barChart.CheckedChanged
   
       If (CType(sender, RadioButton).Checked) Then
   
           Me.selectedType = Microsoft.Office.Interop.Graph.XlChartType.xlBarClustered
           RaiseEvent SelectionChanged(Me, EventArgs.Empty)
       End If
   End Sub
   

   private void barChart_CheckedChanged(object sender, EventArgs e)
   {
       if (((RadioButton)sender).Checked)
       {
           this.selectedType = Microsoft.Office.Interop.Graph.XlChartType.xlBarClustered;
           if (this.SelectionChanged != null)
           {
               this.SelectionChanged(this, EventArgs.Empty);
           }
       }
   }
   

3. Defina o tipo de gráfico no manipulador de eventos de CheckedChanged do botão de Rádio columnChart.

   Private Sub columnChart_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles columnChart.CheckedChanged
   
       If (CType(sender, RadioButton).Checked) Then
   
           Me.selectedType = Microsoft.Office.Interop.Graph.XlChartType.xlColumnClustered
           RaiseEvent SelectionChanged(Me, EventArgs.Empty)
       End If
   End Sub
   

   private void columnChart_CheckedChanged(object sender, EventArgs e)
   {
       if (((RadioButton)sender).Checked)
       {
           this.selectedType = Microsoft.Office.Interop.Graph.XlChartType.xlColumnClustered;
           if (this.SelectionChanged != null)
           {
               this.SelectionChanged(this, EventArgs.Empty);
           }
       }
   }
   

4. Defina o tipo de gráfico no manipulador de eventos de CheckedChanged do botão de Rádio lineChart.

   Private Sub lineChart_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) _
       Handles lineChart.CheckedChanged
   
       If (CType(sender, RadioButton).Checked) Then
           Me.selectedType = Microsoft.Office.Interop.Graph.XlChartType.xlLineMarkers
           RaiseEvent SelectionChanged(Me, EventArgs.Empty)
       End If
   End Sub
   

   private void lineChart_CheckedChanged(object sender, EventArgs e)
   {
       if (((RadioButton)sender).Checked)
       {
           this.selectedType = Microsoft.Office.Interop.Graph.XlChartType.xlLineMarkers;
           if (this.SelectionChanged != null)
           {
               this.SelectionChanged(this, EventArgs.Empty);
           }
       }
   }
   

5. Em C#, você deve adicionar manipuladores de eventos para os botões de Rádio.Você pode adicionar o código para o construtor, sob a chamada ChartOptionsInitializeComponent.Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos no Visual Studio Tools for Office.

   public ChartOptions()
   {
       InitializeComponent();
   
       areaBlockChart.CheckedChanged += new EventHandler(areaBlockChart_CheckedChanged);
       barChart.CheckedChanged += new EventHandler(barChart_CheckedChanged);
       columnChart.CheckedChanged += new EventHandler(columnChart_CheckedChanged);
       lineChart.CheckedChanged += new EventHandler(lineChart_CheckedChanged);
   }
   

Adicionando o Controlarar de usuário para o documento

Quando você Compilação a solução, o novo Controlarar de usuário é Adicionado automaticamente ao De caixa de ferramentas.Em seguida, você pode arrastar o Controlarar de De caixa de ferramentas ao seu documento.

Para adicionar o Controlarar de usuário do documento

1. On the menu ComCompilação, clique em Compilar solução.

   O Controlarar de usuário do ChartOptions é Adicionado ao De caixa de ferramentas.

2. Em Gerenciador de Soluções, clique com o botão direito do mouse ThisDocument.vb ou ThisDocument.cse clique em Exibir Designer.

3. Arraste o Controlarar de ChartOptions da caixa de ferramentas para o documento.

   Um novo Controlarar chamado ChartOptions1 é adicionado ao seu projeto.

Alterar o tipo de gráfico

Criar um manipulador de eventos para alterar o tipo de gráfico acordo com para a opção Selecionadoda no Controlarar de usuário.

Para alterar o tipo de gráfico que é exibido no documento

1. Adicionar o seguinte manipulador de eventos à classe ThisDocument.

   Private Sub ChartOptions1_SelectionChanged(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles ChartOptions1.SelectionChanged
   
       Try
           'first object is the runtime storage control
           Dim index As Object = 2
           Dim shape As Word.Shape = Me.Shapes.Item(index)
   
           'Activate the shape
           shape.Activate()
   
           Dim dataChart As Graph.Chart = CType(shape.OLEFormat.Object, Graph.Chart)
           dataChart.ChartType = Me.ChartOptions1.Selection
   
           'Deactivate the shape
           Me.ChartOptions1.Select()
   
       Catch ex As Exception
           MessageBox.Show(ex.Message)
       End Try
   End Sub
   

   private void ChartOptions1_SelectionChanged(object sender, EventArgs e)
   {
       try
       {
           //first object is the runtime storage control
           object index = 2;
           Word.Shape shape = this.Shapes.get_Item(ref index);
   
           //Activate the shape
           shape.Activate();
   
           Microsoft.Office.Interop.Graph.Chart dataChart = 
               (Microsoft.Office.Interop.Graph.Chart)shape.OLEFormat.Object;
   
           dataChart.ChartType = this.ChartOptions1.Selection;
   
           //Deactivate the shape
           this.ChartOptions1.Select();
       }
       catch (Exception ex)
       {
           MessageBox.Show(ex.Message);
       }
   }
   

2. Em C#, você deve Adicionar um manipulador de eventos para o Controlarar usuário para o evento Startup.

   this.ChartOptions1.SelectionChanged += new EventHandler(ChartOptions1_SelectionChanged);
   

Testando o aplicativo

Você pode agora teste seu documento para certificar-se que o estilo de gráfico é atualizado corretamente quando você Selecionar um botão de Rádio.

Para testar seu documento

1. Pressionarionar F5 para executar seu projeto.

2. Selecionar vários botões de Rádio.

3. Confirme que o estilo do gráfico muda de acordo com a seleção.

Próximas etapas

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

• Usando um botão para preencher uma caixa de texto.For more information, see Demonstra Passo a passo: Exibindo texto em uma caixa de texto em um documento usando um botão.

• Alterar formatação selecionando um estilo em uma caixa de combinação.For more information, see Demonstra Passo a passo: Alterar a formatação do documento usando controles de caixa de seleção.

Consulte também

Conceitos

O Word Usando Explicações Passo a passo

Usando controles Windows Forms em documentos do Word

Limitações do Windows Forms Controls em documentos do Office

Outros recursos

Exemplos de desenvolvimento do Office e Walkthroughs