Propriedade Application.CommandBars (Visio)

Retorna uma referência à coleção CommandBars que representa as barras de comando no aplicativo de contêiner. Somente leitura.

Observação

A partir do Visio 2010, a interface do usuário do Microsoft Office Fluent (interface do usuário) substituiu o sistema anterior de menus em camadas, barras de ferramentas e painéis de tarefas. Objetos VBA e membros que você usou para personalizar a interface do usuário em versões anteriores do Visio ainda estão disponíveis no Visio, mas funcionam de forma diferente.

Sintaxe

expressão. Commandbars

expressão Uma variável que representa um Aplicativo objeto.

Valor de retorno

CommandBars

Comentários

A partir do Microsoft Visio 2002, um programa pode manipular menus e barras de ferramentas na interface do usuário do Visio, manipulando a coleção CommandBars retornada pela propriedade CommandBars. A coleção CommandBars tem uma interface idêntica à coleção CommandBars exposta pelo pacote de aplicativos do Microsoft Office, como o Microsoft Word e o Microsoft Excel.

Como alternativa, desde a versão 4.0 do Visio, o Visio expôs propriedades de aplicativo e documento que retornam um objeto UIObject que fornece funcionalidade semelhante ao CommandBars. Portanto, os programas podem utilizar tanto a coleção CommandBars como os objetos UIObject para manipular os menus e barras de ferramentas do Visio.

Para obter mais informações sobre o objeto retornado pela propriedade CommandBars:

1. Na guia Desenvolvedor , escolha Visual Basic.

2. No menu Exibir , escolha Navegador de Objetos.

3. Na lista Projeto/Biblioteca , escolha Office.

4. Se você não vir a biblioteca de tipos do Office na lista Projeto/Biblioteca , no menu Ferramentas , escolha Referências, selecione a caixa de seleção Biblioteca de Objetos do Microsoft Office 14.0 e escolha OK.

5. Em Classes, examine a classe chamada CommandBars.

Cada objeto CommandBarControl em uma coleção CommandBars tem uma propriedade OnAction e cada objeto CommandBar em uma coleção CommandBars tem uma propriedade Context. Os valores dessas propriedades são determinados pelo aplicativo contêiner. No Microsoft Visio:

• A propriedade OnAction é um valor String que é interpretado como um suplemento de COM, uma macro Microsoft Visual Basic for Applications (VBA), código VBA ou um nome de complemento Visio.

• A propriedade Context determina em qual contexto de menu uma barra de comandos é exibida.

  • O número de contexto do menu é um valor string (por exemplo , visUIObjSetDrawing ou "2"), que é seguido por um asterisco se a barra de comando estiver visível por padrão (por exemplo, visUIObjSetShapeSheet& "*" or "4*").
  • Os contextos de menu válidos são visUIObjSetDrawing (2), visUIObjSetStencil (3), visUIObjSetShapeSheet (4), visUIObjSetIcon (5) ou visUIObjSetPrintPreview (7). A tentativa de definir qualquer outro valor para a propriedade Context falhará.

Exemplo

Esta macro mostra como usar a propriedade CommandBars para listar as barras de comandos.

 
Public Sub CommandBars_Example() 
 
 Dim vsoCommandBars As CommandBars 
 Dim vsoCommandBar As CommandBar 
 
 'Get the set of CommandBars 
 'for the application. 
 Set vsoCommandBars = Application.CommandBars 
 
 'List each CommandBar in the Immediate window. 
 For Each vsoCommandBar In vsoCommandBars 
 Debug.Print vsoCommandBar.Name 
 Next 
 
End Sub

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.