Demonstra Passo a passo: A criação de uma guia personalizado usando o XML da faixa de opções

Artigo
08/08/2011

Esta explicação passo a passo demonstra como criar uma guia da faixa de opções personalizada usando o Da faixa de opções (XML) item.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para os seguintes aplicativos: Excel 2007 e Excel 2010; InfoPath 2010; Outlook 2007 e Outlook 2010; PowerPoint 2007 e PowerPoint 2010; Project 2010; Visio 2010; 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 botões para o Add-Ins guia. O Add-Ins guia é a padrão que é definido no arquivo XML de faixa de opções.
Automatizar o Word de Microsoft Office usando os botões de Add-Ins guia.

Observação
Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. The Visual Studio edition that you have and the settings that you use determine these elements. For more information, see Trabalhando com configurações.

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

Microsoft Office Word 2007 ou Word 2010.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Fazer como i: Usar o Designer de faixa de opções para personalizar a faixa de opções no Excel?.

Creating the Project

A primeira etapa é criar um projeto de suplemento do Word. Posteriormente, você irá personalizar o Add-Ins guia deste documento.

Para criar um novo projeto.

Criar um Word Add-in o projeto com o nome MyRibbonAddIn.

For more information, see Como: Criar projetos do Office em Visual Studio.

Visual StudioAbre a ThisAddIn.cs ou ThisAddIn. vb arquivo de código e adiciona a MyRibbonAddIn de projeto para Solution Explorer.

Criando a guia de suplementos

Para criar o Add-Ins guia, adicione um Da faixa de opções (XML) item ao seu projeto. Posteriormente nesta explicação passo a passo, você irá adicionar alguns botões para este guia.

Para criar a guia Add-Ins

On the Project menu, click Add New Item.
No Add New Item caixa de diálogo, selecione Da faixa de opções (XML).
Alterar o nome da nova faixa de opções para MyRibbone clique em Add.

O MyRibbon.cs ou MyRibbon.vb arquivo abre no designer. Um arquivo XML chamado MyRibbon.xml também é adicionado ao seu projeto.
Em Solution Explorer, com o botão direito ThisAddin.cs ou ThisAddIn. vbe em seguida, clique em Exibir código.

Adicione o seguinte código para o ThisAddin classe. Este código substitui o CreateRibbonExtensibilityObject método e retorna o XML da faixa de opções de classe 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();
}

Em Solution Explorer, com o botão direito do MyRibbonAddIn de projeto e, em seguida, clique em Build. Verifique se o projeto é compilado sem erros.

Adicionar botões à guia Suplementos

O objetivo deste suplemento é dar aos usuários uma maneira de adicionar o timbre e uma tabela específica ao documento ativo. Para fornecer a interface do usuário, adicione dois botões para o Add-Ins guia modificando o arquivo XML de 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 de faixa de opções, consulte XML da faixa de opções.

Para adicionar botões para a guia Add-Ins.

Em Solution Explorer, com o botão direito MyRibbon.xml e, em seguida, clique em Abrir.

Substituir o conteúdo da tab elemento com o XML a seguir. Esse XML altera o rótulo do grupo de controle padrão para conteúdo, e adiciona dois novos botões com rótulos de Inserir texto de 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>

Automatizando o documento usando os botões

Você deve adicionar onAction métodos de retorno de chamada para o Inserir texto de e Inserir tabela botões para executar ações quando o usuário clica 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

Em Solution Explorer, com o botão direito MyRibbon.cs ou MyRibbon.vbe em seguida, clique em Abrir.
Adicione o seguinte código para o topo da MyRibbon.cs ou MyRibbon.vb arquivo. Esse código cria um alias para o Microsoft.Office.Interop.Word namespace.
```
Imports Word = Microsoft.Office.Interop.Word
```
```
using Word = Microsoft.Office.Interop.Word;
```

Adicione o seguinte método para o MyRibbon classe. Este é um método de retorno de chamada para o Inserir texto botão adiciona uma seqüência de caracteres do 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.";
}

Adicione o seguinte método para o MyRibbon classe. Este é um método de retorno de chamada para o Inserir tabela botão 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;
    }
}

Testando o suplemento

Quando você executa o projeto, o Word abre e a guia denominada Add-Ins aparece na faixa de opções. Clique o Inserir texto de e Inserir tabela botões na Add-Ins guia para testar o código.

Para testar seu suplemento

Pressione F5 para executar seu projeto.
Confirme se a Add-Ins guia estará visível na faixa de opções.
Clique o Add-Ins guia.
Confirme se a conteúdo grupo está visível na faixa de opções.
Clique o Inserir texto botão no conteúdo grupo.

Uma seqüência de caracteres é adicionada ao documento no local atual do cursor.
Clique o Inserir tabela botão no conteúdo grupo.

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

Próximas etapas

Você pode aprender mais sobre como personalizar a interface do Office com estes tópicos:

Personalize a faixa de opções de outro aplicativo do Office. Para obter mais informações sobre os aplicativos que oferecem suporte a 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 de faixa de opções. For more information, see Designer de faixa de opções.
Crie um painel de ações personalizadas. For more information, see Visão geral painel Ações.
Personalize a interface do usuário do Microsoft Office Outlook usando regiões de formulário do Outlook. For more information, see Demonstra Passo a passo: A criação de uma região de formulário do Outlook.

Consulte também

Compartilhar via