Passo a passo: Criando uma guia personalizada usando o XML da faixa de opções

Artigo
02/25/2013

Essa explicação passo a passo demonstra como criar um guia personalizado de fita usando o item de fita (XML) .

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 2013 e Excel 2010; InfoPath 2013 e InfoPath 2010; Outlook 2013 e Outlook 2010; PowerPoint 2013 e PowerPoint 2010; Project 2013 e Project 2010; Visio 2013 e Visio 2010; Word 2013 e Word 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

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

Adicionando botões para a guia de Suplementos .O guia de Suplementos é a guia padrão que é definido no arquivo XML e fita.
Automatizar o Microsoft Office Word usando botões na guia de Suplementos .

Observação
Seu computador pode mostrar diferentes nomes ou localizações para alguns dos elementos de interface do usuário Visual Studio nas instruções a seguir.A edição Visual Studio que você possui e as configurações que você usa determinam esses elementos.Para obter mais informações, consulte Configurações de Visual Studio.

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).

Word 2010 ou Word 2013.

link para vídeo Para uma demonstração de vídeo relacionada, consulte Como: eu faço Use o designer de fita para personalizar a fita Excel?.

Criando o projeto

A primeira etapa é criar um projeto do suplemento a palavra.Você irá personalizar posteriormente a guia de Suplementos de este documento.

para criar um novo projeto

crie um projeto de Suplemento do Word com o nome MyRibbonAddIn.

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

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

Criando a guia suplementos

Para criar a guia de Suplementos , adicione um item de fita (XML) ao seu projeto.Posteriormente em esta explicação passo a passo, você adicionará alguns botões a este guia.

Para criar a guia suplementos

No menu Project, clique em Add New Item.
Em a caixa de diálogo de Adicionar novo item , **fita (XML)**selecione.
Altere o nome do novo fita a MyRibbon, e clique Adicionar.

O arquivo de MyRibbon.cs ou de MyRibbon.vb abre no designer.Um arquivo XML que está nomeado MyRibbon.xml também é adicionado ao seu projeto.
Em Gerenciador de Soluções, clique com o botão direito do mouse ThisAddin.cs ou ThisAddin.vb, clique em Exibir Código.

Adicione o seguinte código à classe de ThisAddin .Esse código substitui o método de CreateRibbonExtensibilityObject e retorna a classe XML de fita 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 Gerenciador de Soluções, clique com o botão direito do mouse no projeto de MyRibbonAddIn e clique em Compilar.Verifique se o projeto compila sem erros.

Adicionando botões para a guia suplementos

O objetivo para este suplemento é fornecer aos usuários uma maneira para adicionar texto de texto constante e uma tabela específica para o documento ativo.Para fornecer a interface do usuário, adicione dois botões para a guia de Suplementos modificando o arquivo XML e fita.Posteriormente em esta explicação passo a passo, você irá definir métodos callback para os botões.Para obter mais informações sobre o arquivo XML e fita, consulte Faixa de opções XML.

Para adicionar botões a guia suplementos

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

Substitua o conteúdo do elemento de tab com o seguinte XML.Este XML altera o rótulo do grupo de controle padrão para Conteúdo, e adiciona dois novos botões com 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 botões

Você deve adicionar métodos callback de onAction para que os botões de Inserir texto e de Inserir Tabela executam ações quando o usuário clicá-los.Para obter mais informações sobre métodos de retorno de chamada para controles de fita, consulte Faixa de opções XML.

Para adicionar métodos callback para os botões

Em Gerenciador de Soluções, clique com o botão direito do mouse MyRibbon.cs ou MyRibbon.vb, clique em Abrir.
Adicione o seguinte código à parte superior do arquivo de MyRibbon.cs ou de MyRibbon.vb .Esse código cria um alias para o namespace de Microsoft.Office.Interop.Word .
```
Imports Word = Microsoft.Office.Interop.Word
```
```
using Word = Microsoft.Office.Interop.Word;
```

Adicione o seguinte método à classe de MyRibbon .Este é um método callback para o botão de Inserir texto 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.";
}

Adicione o seguinte método à classe de MyRibbon .Este é um método callback para o botão de Inserir Tabela que adicionar 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ê executar o projeto, abra a palavra e o guia chamada Suplementos aparece em fita.Clique nos botões de Inserir texto e de Inserir Tabela na guia de Suplementos para testar o código.

Para testar o suplemento

Pressione F5 para executar o seu projeto.
Confirme que a guia de Suplementos é visível em fita.
Clique na guia de Suplementos .
Confirme que o grupo de Conteúdo é visível em fita.
Clique no botão de Inserir texto no grupo de Conteúdo .

Uma cadeia de caracteres é adicionada ao documento no local atual do cursor.
Clique no botão de Inserir Tabela no grupo de Conteúdo .

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

Próximas etapas

Você pode aprender mais sobre como personalizar o Office interface do usuário de esses tópicos:

Personalizar a fita de um aplicativo diferente do Office.Para obter mais informações sobre aplicativos que suportam personalizar a fita, consulte Visão geral da faixa de opções.
Personalizar a fita de um aplicativo do Office usando o designer de fita.Para obter mais informações, consulte Designer de faixa de opções.
Crie um painel personalizado de ações.Para obter mais informações, consulte Visão geral do painel de ações.
Personalizar a interface do usuário do Microsoft Office Outlook usando regiões do formulário do Outlook.Para obter mais informações, consulte Passo a passo: Criando uma região de formulário do Outlook.

Consulte também

Compartilhar via