Compartilhar via

Demonstra Passo a passo: Criar uma guia personalizada usando XML da Faixa de Opções

  • Artigo

Este passo a passo demonstra como criar uma guia personalizada da Faixa de Opções usando o item Faixa de Opções (XML).

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para os seguintes aplicativos: Excel; InfoPath 2013 e InfoPath 2010; Perspectiva; PowerPoint; Projeto; Visio; Palavra. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Este passo a passo ilustra as seguintes tarefas:

  • Adicionar botões à guia Suplementos . A guia Suplementos é a guia padrão definida no arquivo XML da Faixa de Opções.

  • Automatizando o Microsoft Office Word usando os botões na guia Suplementos .

Observação

Seu computador pode mostrar diferentes nomes ou locais 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, confira Personalizar o IDE do Visual Studio.

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

Criar o projeto

A primeira etapa é criar um projeto de suplemento VSTO do Word. Posteriormente, você personalizará a guia Suplementos deste documento.

Criar um novo projeto

  1. Crie um projeto de suplemento do Word com o nome MyRibbonAddIn.

    Para obter mais informações, consulte Como: Criar projetos do Office no Visual Studio.

    O Visual Studio abre o arquivo de código ThisAddIn.cs ou ThisAddIn.vb e adiciona o projeto MyRibbonAddIn ao Gerenciador de Soluções.

Criar a guia Suplementos do VSTO

Para criar a guia Suplementos , adicione um item da Faixa de Opções (XML) ao seu projeto. Mais adiante neste passo a passo, você adicionará alguns botões a essa guia.

Para criar a guia Suplementos

  1. No menu Projeto , clique em Adicionar Novo Item.

  2. Na caixa de diálogo Adicionar Novo Item, selecione Faixa de Opções (XML).

  3. Altere o nome da nova Faixa de Opções para Minha Faixa de Opções e clique em Adicionar.

    O arquivo MyRibbon.cs ou MyRibbon.vb é aberto no designer. Um arquivo XML chamado MyRibbon.xml também é adicionado ao seu projeto.

  4. No Gerenciador de Soluções, clique com o botão direito do mouse em ThisAddin.cs ou ThisAddin.vb e clique em Exibir Código.

  5. Adicione o seguinte código à classe ThisAddin . Esse código substitui o método e retorna a classe XML da Faixa de Opções para o CreateRibbonExtensibilityObject aplicativo do Office.

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
{
    return new MyRibbon();
}

  6. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto MyRibbonAddIn e clique em Compilar. Verifique se o projeto é compilado sem erros.

Adicionar botões à guia Suplementos

O objetivo deste suplemento VSTO é fornecer aos usuários uma maneira de adicionar texto clichê e uma tabela específica ao documento ativo. Para fornecer a interface do usuário, adicione dois botões à guia Suplementos modificando o arquivo XML da Faixa de Opções. Mais adiante neste passo a passo, você definirá métodos de retorno de chamada para os botões. Para obter mais informações sobre o arquivo XML da Faixa de Opções, consulte XML da Faixa de Opções.

Para adicionar botões à guia Suplementos

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em Minha Faixa de Opções e clique em Abrir.xml em Abrir.

  2. Substitua o conteúdo do elemento tab pelo seguinte XML. Esse XML altera o rótulo do grupo de controle padrão para Conteúdo e adiciona dois novos botões com os rótulos Inserir Texto e Inserir Tabela.

    <tab idMso="TabAddIns">
    <group id="ContentGroup" label="Content">
        <button id="textButton" label="Insert Text"
             screentip="Text" onAction="OnTextButton"
             supertip="Inserts text at the cursor location."/>
        <button id="tableButton" label="Insert Table"
             screentip="Table" onAction="OnTableButton"
             supertip="Inserts a table at the cursor location."/>
    </group>
</tab>

Automatizar o documento usando os botões

Você deve adicionar onAction métodos de retorno de chamada para os botões Inserir Texto e Inserir Tabela para executar ações quando o usuário clicar neles. Para obter mais informações sobre métodos de retorno de chamada para controles da Faixa de Opções, consulte XML da Faixa de Opções.

Para adicionar métodos de retorno de chamada para os botões

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em MyRibbon.cs ou MyRibbon.vb e clique em Abrir.

  2. Adicione o seguinte código à parte superior do arquivo MyRibbon.cs ou MyRibbon.vb . Esse código cria um alias para o Microsoft.Office.Interop.Word namespace.

    using Word = Microsoft.Office.Interop.Word;

  3. Adicione o método a seguir à classe MyRibbon. Este é um método de retorno de chamada para o botão Inserir Texto que adiciona uma cadeia de caracteres ao documento ativo no local atual do cursor.

    public void OnTextButton(Office.IRibbonControl control)
{
    Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
    currentRange.Text = "This text was added by the Ribbon.";
}

  4. Adicione o método a seguir à classe MyRibbon. Este é um método de retorno de chamada para o botão Inserir Tabela que adiciona uma tabela ao documento ativo no local atual do cursor.

    public void OnTableButton(Office.IRibbonControl control)
{
    object missing = System.Type.Missing;
    Word.Range currentRange = Globals.ThisAddIn.Application.Selection.Range;
    Word.Table newTable = Globals.ThisAddIn.Application.ActiveDocument.Tables.Add(
    currentRange, 3, 4, ref missing, ref missing);

    // Get all of the borders except for the diagonal borders.
    Word.Border[] borders = new Word.Border[6];
    borders[0] = newTable.Borders[Word.WdBorderType.wdBorderLeft];
    borders[1] = newTable.Borders[Word.WdBorderType.wdBorderRight];
    borders[2] = newTable.Borders[Word.WdBorderType.wdBorderTop];
    borders[3] = newTable.Borders[Word.WdBorderType.wdBorderBottom];
    borders[4] = newTable.Borders[Word.WdBorderType.wdBorderHorizontal];
    borders[5] = newTable.Borders[Word.WdBorderType.wdBorderVertical];

    // Format each of the borders.
    foreach (Word.Border border in borders)
    {
        border.LineStyle = Word.WdLineStyle.wdLineStyleSingle;
        border.Color = Word.WdColor.wdColorBlue;
    }
}

Testando o suplemento VSTO

Quando você executa o projeto, o Word é aberto e a guia chamada Suplementos aparece na faixa de opções. Clique nos botões Inserir Texto e Inserir Tabela na guia Suplementos para testar o código.

Para testar o suplemento VSTO

  1. Pressione F5 para executar o projeto.

  2. Confirme se a guia Suplementos está visível na faixa de opções.

  3. Clique na guia Suplementos .

  4. Confirme se o grupo Conteúdo está visível na faixa de opções.

  5. Clique no botão Inserir texto no grupo Conteúdo .

    Uma cadeia de caracteres é adicionada ao documento no local atual do cursor.

  6. Clique no botão Inserir Tabela no grupo Conteúdo .

    Uma tabela é adicionada ao documento no local atual do cursor.

Próximas etapas

Você pode saber mais sobre como personalizar a interface do usuário do Office a partir destes tópicos:

  • Personalize a faixa de opções de um aplicativo do Office diferente. Para obter mais informações sobre os aplicativos que oferecem suporte à personalização da faixa de opções, consulte Visão geral da faixa de opções.

  • Personalize a faixa de opções de um aplicativo do Office usando o Designer da Faixa de Opções. Para obter mais informações, consulte Fitas.

  • Crie um painel de ações personalizado. Para obter mais informações, consulte Visão geral do painel Ações.

  • Personalize a interface do usuário do Microsoft Office Outlook usando as Regiões de Formulário do Outlook. Para obter mais informações, consulte Demonstra Passo a passo: Criar uma região de formulário do Outlook.

Conteúdo relacionado