Propriedade Application.BuiltInToolbars (Visio)

Retorna um objeto UIObject que representa uma cópia das barras de ferramentas internas do Microsoft Visio. 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. BuiltInToolbars (fIgnored)

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
fIgnored	Obrigatório	Integer	Necessário para manter a compatibilidade com versões anteriores, mas ignorado. O valor sugerido é zero (0).

Valor de retorno

Uiobject

Comentários

Use a propriedade BuiltInToolbars para obter um objeto UIObject e modificar suas barras de ferramentas. Em seguida, você pode usar o método SetCustomToolbars de um objeto Application ou Document para substituir as barras de ferramentas internas do Visio pelas suas barras de ferramentas personalizadas.

Você também pode usar o método SaveToFile do objeto UIObject para armazenar suas barras de ferramentas e recarregá-las como barras de ferramentas personalizadas definindo a propriedade CustomToolbarsFile de um objeto Application ou Document.

Antes do Visio 5.0, o argumento para essa propriedade era fWhichToolbars, que designava o tipo de barra de ferramentas para obter (MSOffice ou LotusSS). A partir do Visio 5.0, o aplicativo não dá mais suporte a diferentes tipos de barras de ferramentas e o argumento atual, fIgnored, é ignorado.

Exemplo

Esta macro do VBA (Microsoft Visual Basic for Applications) mostra como usar a propriedade BuiltInToolbars para obter uma cópia das barras de ferramentas internas do Visio, adicionar um botão de barra de ferramenta, definir o ícone do botão e substituir o conjunto de barras de ferramentas internas pelo conjunto personalizado.

Antes de executar essa macro, substitua (path\filename) no código a seguir pelo caminho completo para e o nome do arquivo de um arquivo de ícone (.ico) em seu computador.

Para restaurar as barras de ferramentas internas do Visio depois de executar esta macro, chame o método ThisDocument.ClearCustomToolbars.

 
Public Sub BuiltInToolbars_Example() 
 
 Dim vsoUIObject As Visio.UIObject 
 Dim vsoToolbarSet As Visio.ToolbarSet 
 Dim vsoToolbarItems As Visio.ToolbarItems 
 Dim vsoToolbarItem As Visio.ToolbarItem 
 
 'Get the UIObject object for the copy of the built-in toolbars. 
 Set vsoUIObject = Visio.Application.BuiltInToolbars(0) 
 
 'Get the drawing window toolbar sets.'NOTE: Use ItemAtID to get the toolbar sets.'Using vsoUIObject.ToolbarSets(visUIObjSetDrawing) will not work. 
 Set vsoToolbarSet = vsoUIObject.ToolbarSets.ItemAtID(visUIObjSetDrawing) 
 
 'Get the ToolbarItems collection. 
 Set vsoToolbarItems = vsoToolbarSet.Toolbars(0).ToolbarItems 
 
 'Add a new button in the first position. 
 Set vsoToolbarItem = vsoToolbarItems.AddAt(0) 
 
 'Set properties for the new toolbar button. 
 vsoToolbarItem.CntrlType = visCtrlTypeBUTTON 
 
 'Set the caption for the new toolbar button. 
 vsoToolbarItem.Caption = "MyButton" 
 
 'Set the icon for the new toolbar button. 
 vsoToolbarItem.IconFileName "(path\filename)" 'Tell Visio to actually use the new custom UI. 
 ThisDocument.SetCustomToolbars vsoUIObject 
 
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.