Propriedade Application.BuiltInToolbars (Visio)

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

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

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Com 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

Utilize a propriedade BuiltInToolbars para obter um objeto UIObject e modificar as respetivas 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 esta propriedade era fWhichToolbars, que designava o tipo de barra de ferramentas a obter (MSOffice ou LotusSS). A partir do Visio 5.0, a aplicação já não suporta 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 esta macro, substitua (path\filename) no seguinte código pelo caminho completo para e nome de ficheiro de um ficheiro de ícone (.ico) no 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.