Demonstra Passo a passo: A atualização de um gráfico em um documento usando os botões de rádio

Artigo
08/08/2011

Este passo a passo demonstra como usar os botões de opção uma personalização de nível de documento do Word de Microsoft Office para dar aos usuários a opção de selecionar os estilos de gráfico 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:

Adicionando um gráfico para o documento em um projeto de nível de documento em tempo de design.
O agrupamento de botões de rádio, adicionando-os para um controle de usuário.
Alterar o estilo de gráfico quando uma opção é selecionada.

Para ver o resultado como um exemplo completo, consulte Exemplos de controles do Word ao Exemplos de desenvolvimento do Office e Walkthroughs.

Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da 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

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.

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

Adicionando um gráfico no documento

Para adicionar um gráfico

No documento do Word que está hospedado no designer de Visual Studio, na faixa de opções, clique na Inserir guia.
No texto de grupo, clique no Inserir objeto botão suspenso e clique em objeto.

O objeto abre a caixa de diálogo.
No o tipo de objeto listar na Criar novo guia, selecione Gráfico do Microsoft Graph e, em seguida, clique em OK.

Um gráfico é adicionado ao documento no ponto de inserção e o folha de dados janela é exibida com alguns dados padrão.
Fechar o folha de dados janela para aceitar os valores padrão no gráfico e clique dentro do documento para mover o foco para fora do gráfico.
Clique com o botão direito do gráfico e, em seguida, clique em O objeto de formato.
Sobre o Layout guia da Formatar objeto caixa de diálogo, selecione quadrado e clique em OK.

Adding a User Control to the Project

Os botões de opção em um documento não são mutuamente exclusivos, por padrão. Você pode torná-los funcionar corretamente, adicionando-os para um controle de usuário e, em seguida, escrever o código para controlar a seleção.

Para adicionar um controle de usuário

Selecione o Minhas opções de gráfico projeto em Solution Explorer.
On the Project menu, click Add New Item.
No Add New Item caixa de diálogo, clique em O controle de usuário, nome do controle ChartOptions, e clique em Add.

Para adicionar controles de formulários do Windows para o controle de usuário

Se o controle de usuário não estiver visível no designer, clique duas vezes em ChartOptions na Solution Explorer.
Da Controles comuns guia do Toolbox, arraste o primeiro O botão de rádio o controle para o controle de usuário e alterar as propriedades a seguir.

Property

Value

Name

columnChart

Text

Gráfico de colunas
Adicionar um segundo O botão de rádio ao usuário controlar e alterar as propriedades a seguir.

Property

Value

Name

barChart

Text

Gráfico de barras
Adicionar um terceiro O botão de rádio ao usuário controlar e alterar as propriedades a seguir.

Property

Value

Name

lineChart

Text

Gráfico de linhas
Adicionar uma quarta O botão de rádio ao usuário controlar e alterar as propriedades a seguir.

Property

Value

Name

areaBlockChart

Text

Bloco gráfico de radar

Property	Value
Name	columnChart
Text	Gráfico de colunas

Property	Value
Name	barChart
Text	Gráfico de barras

Property	Value
Name	lineChart
Text	Gráfico de linhas

Property	Value
Name	areaBlockChart
Text	Bloco gráfico de radar

Adding References

Para acessar o gráfico do controle do usuário em um documento, você deve ter uma referência ao assembly Microsoft.Office.Interop.Graph em seu projeto.

Para adicionar uma referência ao assembly Microsoft.Office.Interop.Graph

On the Project menu, click Add Reference.

O Add Reference caixa de diálogo aparece.
Sobre o .NET guia, selecione Microsoft.Office.Interop.Graph e clique em OK. Se o seu projeto destina-se a Word 2007, selecione o 12.0.0.0 de versão do assembly; Se os destinos do projeto Word 2010, selecione o 14.0.0.0 versão.

Alterar o estilo de gráfico quando um botão de opção está selecionado.

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

Para criar um evento e uma propriedade em um controle de usuário

Em Solution Explorer, clique com o botão direito no controle de usuário e, em seguida, clique em Exibir código.

Adicione código para criar um SelectionChanged evento e o Selection propriedade para o ChartOptions classe.

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 de CheckedChange dos botões de opção

Definir o tipo de gráfico na CheckedChanged o manipulador de eventos da areaBlockChart botão de opção e, em seguida, disparar 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);
        }
    }
}

Definir o tipo de gráfico na CheckedChanged o manipulador de eventos da barChart botão de rádio.

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

Definir o tipo de gráfico na CheckedChanged o manipulador de eventos da columnChart botão de rádio.

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

Definir o tipo de gráfico na CheckedChanged o manipulador de eventos da lineChart botão de rádio.

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

C#, você deve adicionar manipuladores de eventos para os botões de opção. Você pode adicionar o código para o ChartOptions construtor, sob a chamada para InitializeComponent. Para obter informações sobre como criar manipuladores de eventos, consulte Como: Criar manipuladores de eventos em projetos do 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 controle de usuário para o documento.

Quando você constrói a solução, o novo controle de usuário é adicionado automaticamente para o caixa de ferramentas. Você pode então arrastar o controle a partir de Toolbox ao seu documento.

Para adicionar o controle de usuário em seu documento

Sobre o Build menu, clique em Build Solution.

O ChartOptions o controle de usuário é adicionado para o Toolbox.
Em Solution Explorer, com o botão direito ThisDocument. vb ou ThisDocument.cse em seguida, clique em View Designer.
Arrastar o ChartOptions de controle da caixa de ferramentas ao documento.

Um novo controle chamado ChartOptions1 é adicionado ao projeto.

Alterando o tipo de gráfico

Crie um manipulador de eventos para alterar o tipo de gráfico de acordo com a opção selecionada no controle de usuário.

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

Adiciona o manipulador de eventos para o ThisDocument classe.

Private Sub ChartOptions1_SelectionChanged(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles ChartOptions1.SelectionChanged

    Try
        Dim shape As Word.Shape = Me.Shapes.Item(1)

        ' 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
    {
        object index = 1;
        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);
    }
}

C#, você deve adicionar um manipulador de eventos para o controle de usuário para o Startup de evento.
```
this.ChartOptions1.SelectionChanged += new EventHandler(ChartOptions1_SelectionChanged);
```

Testing the Application

Agora você pode testar seu documento para certificar-se de que o estilo de gráfico é atualizado corretamente quando você seleciona um botão de opção.

Para testar seu documento.

Pressione F5 para executar seu projeto.
Selecione vários botões de rádio.
Confirme que o estilo de gráfico é alterado para corresponder à seleção.

Próximas etapas

Here are some tasks that might come next:

Usando um botão para preencher uma caixa de texto. For more information, see Demonstra Passo a passo: Exibir texto em uma caixa de texto em um documento usando um botão..
Alterar a formatação, selecionando um estilo a partir de uma caixa de combinação. For more information, see Demonstra Passo a passo: Alterar a formatação do documento usando os controles CheckBox.

Consulte também

Conceitos

O Word Usando Explicações Passo a passo

Usando os controles do Windows Forms em documentos do Word

Limitações dos controles do Windows Forms em documentos do Office

Outros recursos

Exemplos de desenvolvimento do Office e Walkthroughs

Compartilhar via