O “Dialog Box Launcher”  (ou Iniciador de Caixa de Diálogo em português) é utilizado para abrir uma caixa de diálogo qualquer associada à um grupo. Porém, podemos utilizar o Iniciador de Caixa de Diálogo para abrir uma mensagem ou um formulário próprio o qual faz a vez de tal caixa de diálogo.

A figura abaixo mostra o Iniciador de Caixa de Diálogo para o grupo Fonte com o Iniciador de Caixa de Diálogo circundado:

Figura 11‑1 Iniciador de Caixa de Diálogo

O objetivo é criar o seguinte grupo contendo o Iniciador de Caixa de Diálogo:

Figura 11‑2 Iniciador de Caixa de Diálogo personalizado e com “super dica”

Note que ao apontarmos para o Iniciador de Caixa de Diálogo uma super dica é apresentada ao usuário. Vejamos o código XML que gerará a guia, grupo, rótulo e launcher:

<customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui">
  <ribbon>
    <tabs>
      <tab
        id="guia1"
        label="Minha Guia"
        insertBeforeMso="TabHome">

        <group
          id="grp1"
          label="Meu Grupo">
         
          <labelControl
            id="lbl1"
            label="Exemplo de um Launcher" />

       <!-- Utilize o tag dialogBoxLauncher para criar um botão Dialog Box Launcher -->

          <dialogBoxLauncher>

            <button
               id="launcher1"
               label="Carregar caixa de diálogo."
               supertip="Clique neste botão para carregar uma caixa de diálogo personalizada."
               onAction="mostrarCaixaDeDialogo"/>

          </dialogBoxLauncher>

        </group>

      </tab>
    </tabs>
  </ribbon>
</customUI>

Podemos agora gerar o callback para utilização no VBA. Salve o arquivo XLSM e abra-o no Excel. Abra o VBE (Alt+F11) e cole o callback em um novo módulo. Adicione um formulário ao seu projeto.

Assumindo que o nome de seu formulário é “UserForm1”, teremos o seguinte VBA no callback:

Sub mostrarCaixaDeDialogo(control As IRibbonControl)
    UserForm1.Show 0
End Sub

O nosso formulário está pronto para ser utilizado. Note que o formulário não é carregado como “modal” o que implica que o usuário pode selecionar o que está por trás dele.

A figura a seguir mostra o formulário carregado quando o usuário clica no Iniciador de Caixa de Diálogo:

Figura 11‑3 Caixa de diálogo personalizada

Obviamente que não precisamos nos circunscrever a formulários. Nós podemos utilizar o DBL para carregar qualquer outra caixa de diálogo disponível no Excel.

Finalmente, o leitor deve estar ciente que devido a uma mudança de última hora, se tentarmos validar o XML do Iniciador de Caixa de Diálogo nós obteremos um erro:

Figura 11‑4 Erro na utilização do bjeto “advanced” ou invés do “dialogBoxLauncher”

O erro ocorre porque o elemento dialogBoxLauncher era anteriormente chamado de advanced (conforme mostrado no círculo acima). Caso o leitor esteja utilizando a versão Beta 2 para estudar este curso, este elemento deve ser renomeado caso contrário haverá um erro.

Para os leitores com acesso a versão RTM do Office o ideal é fazer o upgrade para a nova versão do Office 2007 CustomUI Editor compatível com a versão RTM do Office conforme definido no início deste curso.