Partilhar via

Demonstra Passo a passo: Criando um guia Personalizar com o XML da Faixa de Opções

  • Artigo

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

  • Projetos de nível de aplicativo

Versão do Microsoft Office

  • O Excel 2007

  • Word 2007

  • Outlook 2007

  • PowerPoint 2007

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

Esta explicação passo a passo demonstra como criar uma guia da Faixa de Opções Personalizar usando o item de da Faixa de Opções (XML).

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

  • Adicionando botões à guia de A Add-ins.A guia de De Adicionar-ins é a guia padrão que é definida no arquivo XML da Faixa de Opções.

  • Automatizar o Microsoft Office Word 2007 usando os botões da guia Adicionar-ins.

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).

  • 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 Word 2007 Adicionar no projeto.Depois você irá personalizar a guia de Adicionar-ins deste documento.

Para criar um novo projeto

  • Criar um projeto de suplemento do Word com o nome MyRibbonAddIn.

    Garantir o uso de Word Adicionar no modelo de projeto para o Microsoft Office Sistema de 2007.For more information, see Como: Criar o Visual Studio Tools para projetos do Office.

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

Criando a guia Adicionar-ins

Para criar a guia de Adicionar-ins, adicione um item de da Faixa de Opções (XML) ao seu projeto.Posteriormente nesta explicação passo a passo, você irá adicionar alguns botões para esta guia.

Para criar a guia Adicionar-ins

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

  2. No Adicionar Novo Item caixa de diálogo, Selecionar Da Faixa de Opções (XML).

  3. Alterar o nome da Novo fita para MyRibbone clique em Adicionar.

    O MyRibbon.cs ou MyRibbon.vb arquivo é aberta no designer.Um arquivo XML que é denominado MyRibbon.xml também é adicionado ao seu projeto.

  4. Em Gerenciador de Soluções, clique com o botão direito do mouse ThisAddin.cs ou ThisAddin.vbe clique em Exibir Code.

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

    Protected Overrides Function CreateRibbonExtensibilityObject() As  _
Microsoft.Office.Core.IRibbonExtensibility
    Return New MyRibbon()
End Function

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

  6. Em Gerenciador de Soluções, clique com o botão direito do mouse no projeto de MyRibbonAddIn e clique em Compilação.Verifique se que o projeto compila sem erros.

Adicionar botões para a guia Add-ins

O objetivo para este suplemento é 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 Adicionar-ins modificando o arquivo XML da Faixa de Opções.Posteriormente nesta explicação passo a passo, você irá 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 na guia Add-ins

  1. Em Gerenciador de Soluções, clique com o botão direito do mouse MyRibbon.xml e clique em Abrir do .

  2. Substituir o conteúdo do elemento tab com o seguinte XML.Este XML altera o rótulo do AAgruparar de Controlarar padrão para conteúdo de , e adiciona dois novos botões com rótulos Inserir texto e Insert 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>

Automatizando o documento usando os botões

Você deve adicionar métodos de retorno de chamada onAction para o de inserir texto Insert Tabela botões e para executar ações quando o usuário clica-los.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. Em Gerenciador de Soluções, clique com o botão direito do mouse MyRibbon.cs ou MyRibbon.vbe clique em Abrir do .

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

    Imports Word = Microsoft.Office.Interop.Word

    using Word = Microsoft.Office.Interop.Word;

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

    Public Sub OnTextButton(ByVal control As Office.IRibbonControl)
    Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
    currentRange.Text = "This text was added by the Ribbon."
End Sub

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

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

    Public Sub OnTableButton(ByVal control As Office.IRibbonControl)
    Dim missing As Object = System.Type.Missing

    Dim currentRange As Word.Range = Globals.ThisAddIn.Application.Selection.Range
    Dim newTable As Word.Table = Globals.ThisAddIn.Application.ActiveDocument.Tables.Add( _
               currentRange, 3, 4)

    ' Get all of the borders except for the diagonal borders.
    Dim borders() As Word.Border = 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.
    For Each border As Word.Border In borders
        border.LineStyle = Word.WdLineStyle.wdLineStyleSingle
        border.Color = Word.WdColor.wdColorBlue
    Next
End Sub

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

Teste o Adicionar - no

Quando você executa o projeto, abre do Word 2007 e a guia chamada Adicionar-ins aparece na faixa de opções.Clique Botões de de inserir tabela na guia Adicionar-ins para testar o código e de inserir texto .

Para testar o Adicionar-in

  1. Pressionarionar F5 para executar seu projeto.

  2. Confirme se a guia de Adicionar-ins é visível na Faixa de Opções.

  3. Clique na guia de Adicionar-ins.

  4. Confirme se o AAgruparar de conteúdo é visível na Faixa de Opções.

  5. Clique no botão de inserir texto no AAgruparar de conteúdo .

    Uma Cadeia de Caracteres é Adicionado ao documento no local atual do cursor.

  6. Clique no botão de inserir tabela no AAgruparar de conteúdo .

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

Próximas etapas

Você pode saber mais sobre como personalizar a INTERFACE do Office destes tópicos:

Consulte também

Tarefas

Demonstra Passo a passo: Criando um guia Personalizar usando o Designer de Faixa de Opções

Conceitos

Visão geral da Faixa de Opções

XML da Faixa de Opções