O tag para a Faixa de Opções e “startFromScratch” (iniciando do zero)

No passo anterior adicionamos o tag referente ao CustomUI. Logo abaixo dele vem o tag para Faixa de Opções. Existem outros tags abaixo do CustomUI, mas neste caso estamos interessados na Faixa de Opções.

Desta forma, para referenciar a Faixa de Opções o qual iremos modificar, nós teremos o seguinte cenário:

<customUI  xmlns="http://schemas.microsoft.com/office/2006/01/customui">

      <ribbon>

            <!-- Todos os outros tags e instruções entram aqui -->

      </ribbon>
   </customUI> 

Note como a cada nível, estamos “encapsulando” os tags inferiores dentro do tag “pai”, por assim dizer. Isso nada mais é do que uma hierarquia dentro do CustomUI.

Um cenário que o leitor pode querer ter em mente é se o projeto iniciará do zero (startFromScratch) ou não. Isso é feito definindo este atributo como sendo “falso” (false) ou “verdadeiro” (true). Em vários cenários deste curso, utilizaremos este atributo (propriedade) como sendo “false”:

<customUI  xmlns="http://schemas.microsoft.com/office/2006/01/customui">

      <ribbon startFromScratch="false">

            <!-- Todos os outros tags e instruções entram aqui -->

      </ribbon>
   </customUI> 

O tag para os Tabs e para o Tab

Já temos o CustomUI e a Faixa de Opções. O próximo objeto na hierarquia é o Tabs (ou guias) o qual deve vir dentro do tag para a Faixa de Opções:

<customUI  xmlns="http://schemas.microsoft.com/office/2006/01/customui">

      <ribbon>

            <tabs>

           <!-- Todos os outros tags e instruções entram aqui -->

            </tabs>

      </ribbon>
   </customUI> 

Note que há uma diferença entre Tabs e Tab. Tabs indica a coleção de guias ao passo que Tab indica uma guia apenas.

Se você alguma vez criou menus personalizados no Excel (ou no Office) você se lembrará de tal hierarquia com o Application.Commandbars que representa a coleção de barras de ferramentas (barras de comando) ao passo que o objeto Commandbar dimensionado refere-se a um único objeto (ou barra de ferramenta/comando).

Assim sendo, definimos primeiro a coleção e, dentro da coleção, nós adicionamos a nossa guia personalizada (ou modificamos uma existente):

<customUI  xmlns="http://schemas.microsoft.com/office/2006/01/customui">

      <ribbon>

            <tabs>

                  <tab>

                     <!-- Todos os outros tags e instruções entram aqui -->

                  </tabs>

            </tabs>

      </ribbon>
   </customUI> 

O que precisamos fazer é definir agora o id o label e onde o tab deve ser inserido. Isso nós veremos mais adiante:

Figura 2‑1 Posicionando a guia

A figura acima mostra tal cenário. Na Figura 1‑3, a guia é inserida no local padrão, isto é, como sendo a última guia na lista, contudo, podemos inserí-la em qualquer posição.

No exemplo, insiro antes da guia “Início”, contudo poderíamos escolher outra localidade qualquer como era feito no Excel 2003.

Figura 2‑2 Posicionamento da guia

Antes de entrarmos na questão do posicionamento, introduzirei mais dois elementos para que o código XML fique mais claro ao chegarmos a tal questão.

Definindo o “id” da guia

A próxima questão importante diz respeito ao id da guia personalizada. O id é o identificador de nossa guia. A identificação da guia segue na mesma linha que a abertura do tag da guia, conforme mostro no código abaixo:

<customUI  xmlns="http://schemas.microsoft.com/office/2006/01/customui">

      <ribbon>

            <tabs>

                  <tab id="meuTab">

                  </tab>

            </tabs>

      </ribbon>

</customUI> 

Definindo o rótulo da guia

O id é a identificação da guia. Contudo a identificação é o que usamos internamente e não o que o usuário verá na Faixa de Opções. Para definir o que aparece na Faixa de Opções usamos o atributo “label”. Assim como o id a propriedade label segue na mesma linha da abertura da guia (tab):

<customUI  xmlns="http://schemas.microsoft.com/office/2006/01/customui">

      <ribbon>

            <tabs>

                  <tab id="meuTab" label="Minha Guia">

                  </tab>

            </tabs>

      </ribbon>
   </customUI>

Figura 2‑3 Definindo o rótulo da guia