Partilhar via


Objeto CommandBars (Office)

Uma coleção de objetos CommandBar que representa as barras de comandos no aplicativo contêiner.

Observação

[!OBSERVAçãO] O uso de CommandBars em alguns aplicativos do Microsoft Office foi substituído pelo novo componente da faixa de opções da interface de usuário do Microsoft Office Fluent. Para obter mais informações, consulte Descrição geral do friso do Office Fluent.

Exemplo

Use a propriedade CommandBars para retornar a coleção CommandBars. O exemplo seguinte exibe na janela imediata o nome e o nome local do cada barra de menu e barra de ferramentas e exibe um valor que indica se as barra de menu ou barra de ferramentas está visível.

For Each cbar in CommandBars 
    Debug.Print cbar.Name, cbar.NameLocal, cbar.Visible 
Next

Use o método Add para adicionar uma nova barra de comandos à coleção. O exemplo seguinte cria uma barra de ferramentas personalizada com o nome Custom1 e apresenta-a como uma barra de ferramentas flutuante.

Set cbar1 = CommandBars.Add(Name:="Custom1", Position:=msoBarFloating) 
cbar1.Visible = True

Utilize enumName, em que índice é o nome ou número de índice de uma barra de comandos, para devolver um único objeto da Barra de Comandos . O exemplo seguinte ancora a barra de ferramentas denominada Custom1 na parte inferior da janela da aplicação.

CommandBars("Custom1").Position = msoBarBottom

Observação

Utilize o nome ou o número do índice para especificar uma barra de menus ou barra de ferramentas na lista de barras de menus e barras de ferramentas disponíveis na aplicação de contentor. No entanto, você deverá usar o nome para especificar um menu, menu de atalho ou submenu (todos os quais são representados por objetos CommandBar ). Se dois ou mais menus personalizados ou submenus tiverem o mesmo nome, enumName retornará o primeiro. Para garantir que devolve o menu ou submenu correto, localize o controlo de pop-up que apresenta esse menu. Em seguida, aplique a propriedade Barra de Comandos ao controlo de pop-up para devolver a barra de comandos que representa esse menu.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.