Propriedade ToolbarItem.Style (Visio)

  • Artigo

Determina se um botão da barra de ferramentas exibe um ícone, uma legenda ou alguma combinação. Leitura/gravação.

Sintaxe

expression.Style

Expressão Uma variável que representa um objeto ToolbarItem .

Valor de retorno

Inteiro

Comentários

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.

Os valores possíveis para a propriedade Style estão listados na tabela a seguir. Essas constantes são declaradas pela biblioteca de tipos do Visio em VisUIButtonStyle.

Constant Valor
visButtonAutomatic 0
visButtonCaption 1
visButtonIcon 2
visButtonIconandCaption 3

Exemplo

Este exemplo mostra como usar a propriedade Style para definir o estilo de um botão da barra de ferramentas. O exemplo adiciona um botão da barra de ferramentas personalizada e o define para exibir um ícone e uma legenda. Esse botão aparece na interface do usuário do Visio e fica disponível enquanto o documento está ativo.

Antes de executar esse código, substitua path\filename pelo caminho completo para e o nome de um arquivo (.ico) de ícone válido em seu computador.

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

Sub Style_Example() 
 
 Dim vsoUIObject As Visio.UIObject 
 Dim vsoToolbarSet As Visio.ToolbarSet 
 Dim vsoToolbarItems As Visio.ToolbarItems 
 Dim vsoToolbarItem As Visio.ToolbarItem 
 
 'Check whether there are document custom toolbars. 
 If ThisDocument.CustomToolbars Is Nothing Then 
 
 'If not, check whether there are application custom toolbars. 
 If Visio.Application.CustomToolbars Is Nothing Then 
 
 'If not, use the built-in toolbars. 
 Set vsoUIObject = Visio.Application.BuiltInToolbars(0) 
 
 Else 
 
 'If there are application custom toolbars, copy them. 
 Set vsoUIObject = Visio.Application.CustomToolbars.Clone 
 End If 
 
 Else 
 
 'If there already are document custom toolbars, use them. 
 Set vsoUIObject = ThisDocument.CustomToolbars 
 
 End If 
 
 'Get the Toolbars collection for the drawing window context. 
 Set vsoToolbarSet = vsoUIObject.ToolbarSets.ItemAtID(visUIObjSetDrawing) 
 
 'Get the set of toolbar items for the Standard toolbar. 
 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 
 vsoToolbarItem.CmdNum = visCmdFileSave 
 vsoToolbarItem.Style = visButtonIconandCaption 
 vsoToolbarItem.IconFileName "path\filename" 
 
 'Use the new UIObject object while this document is active. 
 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.