Compartilhar via

Estendendo a faixa de opções

  • Artigo

No Windows Explorer, a Faixa de Opções ajuda a tornar as atividades comuns de gerenciamento de arquivos do usuário final mais fáceis e detectáveis, mas há alterações em andamento para desenvolvedores de aplicativos. Por exemplo, a barra de comandos antiga era livremente extensível, mas a Faixa de Opções é mais restrita no momento. Além disso, a Faixa de Opções não é mostrada por padrão para todas as extensões de namespace, portanto, você precisa optar por obter a Faixa de Opções; caso contrário, você obterá a barra de comandos mais antiga.

As ações disponíveis para os usuários na Faixa de Opções se enquadram em três categorias de extensibilidade:

  • A extensibilidade não é necessária. Exemplos: Copiar, Colar, Excluir. O Windows manipula esses verbos para você.
  • Atualmente, a extensibilidade não é permitida: exemplos: Zip, Fechar Sessão e outras ações personalizadas. Use o menu de contexto para abranger esses cenários.
  • A extensibilidade é incorporada à ação em si. Exemplos: Pesquisar, Email, Imprimir, Novo Item. Você precisa se registrar para esses verbos para incluir seu aplicativo ou formato de arquivo na Faixa de Opções .

Este documento descreve como você pode optar por obter a Faixa de Opções e como se registrar para lidar com verbos específicos da Faixa de Opções.

Aceitando a Faixa de Opções

Para aceitar a Faixa de Opções, sua implementação IShellFolder2 deve especificar EP_Ribbon em IExplorerPaneVisibility::GetPaneState e retornar EPS_FORCE | EPS_DEFAULT_ON.

Estendendo a faixa de opções para extensões de arquivo

Esses botões da Faixa de Opções são extensíveis com base em extensões de arquivo:

  • Extrair Tudo
  • Montagem | Burn (um ISO)
  • Reproduzir | Reproduzir Tudo | Adicionar à Playlist (verbo: Enfileirar)
  • Aberto
  • Editar
  • Propriedades

Quando você se registra para manipular estaticamente os verbos relevantes para novos tipos de arquivo, a Faixa de Opções manipula os verbos adequadamente. Registre-se da mesma forma que faria para verbos de menu de contexto. Para obter mais informações sobre associações de arquivo e registro de verbos, consulte Verbos e associações de arquivos e Criando manipuladores de menu de atalho.

Registrando-se como um manipulador padrão para ActionIds

Primeiro, registre seu ProgId na subchave AssocActionId apropriada. Cada subchave AssocActionId representa um verbo ou ação que os usuários podem invocar da Faixa de Opções. Neste exemplo, o aplicativo registra o ZipSelection ActionID para estender o botão "Extrair Tudo" na Faixa de Opções.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Explorer.AssocActionId.ZipSelection
            shell
               open
                  command
                     (Default) = %SystemRoot%\[Your App].exe
      Microsoft
         Windows
            CurrentVersion
               Your App Name
                  Capabilities
                     URL Protocol
                     FriendlyTypeName = @%SystemRoot%\explorer.exe,-1234

Depois que esse registro for concluído, você deverá se registrar para lidar com protocolos como faria normalmente, conforme descrito em Programas Padrão.