Propriedade ToolbarItem.State (Visio)

  • Artigo

Determina o estado de um botão, pressionado ou não pressionado. Leitura/gravação.

Sintaxe

expressão. Estado

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.

A propriedade State pode ser uma das seguintes constantes declaradas pela biblioteca de tipos do Visio em VisUIButtonState.

Constant Valor Descrição
visButtonUp 0 Botão não pressionado
visButtonDown -1 Botão pressionado

Exemplo

Este exemplo mostra como usar a propriedade State para definir o estado de um botão da barra de ferramentas (fazê-lo aparecer pressionado). O exemplo adiciona um botão personalizado à barra de ferramentas Padrão. Pressionar o botão salva o documento ativo. Esse botão é exibido na interface do usuário do Microsoft 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 Visio após executar essa macro, chame o método ThisDocument.ClearCustomToolbars.

 
Sub State_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 there are no custom toolbars, 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.State = visButtonDown 
 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.