Propriedade Application.CommandBars (Visio)

  • Artigo

Devolve uma referência à coleção CommandBars que representa as barras de comandos na aplicação de contentor. Somente leitura.

Observação

A partir do Visio 2010, a interface de utilizador (IU) fluente do Microsoft Office substituiu o sistema anterior de menus em camadas, barras de ferramentas e painéis de tarefas. Os objetos VBA e os membros que utilizou para personalizar a interface de utilizador em versões anteriores do Visio ainda estão disponíveis no Visio, mas funcionam de forma diferente.

Sintaxe

expressão. Barras de Comandos

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.

Em alternativa, desde a versão 4.0 do Visio, o Visio expôs as propriedades da aplicação e do documento que devolvem um objeto UIObject que fornece funcionalidades semelhantes às Barras de Comandos. 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. No separador Programador , selecione Visual Basic.

  2. No menu Ver , selecione Object Browser.

  3. Na lista Projeto/Biblioteca , selecione Office.

  4. Se não vir a biblioteca de tipos do Office na lista Projeto/Biblioteca, no menu Ferramentas, selecione Referências, selecione a caixa de marcar Biblioteca de Objetos do Microsoft Office 14.0 e, em seguida, selecione 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 de Cadeia (por exemplo, visUIObjSetDrawing ou "2"), seguido de um asterisco se a barra de comando estiver visível por predefiniçã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.