Ler em inglês

Compartilhar via


Propriedade Document.MacrosEnabled (Visio)

Especifica se você pode executar macros e eventos de processo no projeto Microsoft Visual Basic for Applications (VBA) de um documento. Somente leitura.

Sintaxe

expressão. MacrosEnabled

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

Valor de retorno

Booliano

Comentários

Se o documento contiver macros necessárias para a execução da solução, você poderá usar a propriedade MacrosEnabled para verificar se as macros estão habilitadas no documento. Se estiverem desabilitadas, você poderá exibir uma mensagem indicando que a solução pode não funcionar como esperado porque as configurações do documento proíbem que as macros sejam executadas.

O valor da propriedade MacrosEnabled depende de uma combinação da configuração da macro e do status da assinatura do projeto (se ele é assinado digitalmente por uma fonte confiável ou está em um local confiável). A tabela a seguir descreve essas combinações.

Configuração de macro Assinado digitalmente Em um local confiável Propriedade MacrosEnabled
Desabilitar todas as macros sem notificação N/D Não Falso
Desabilitar todas as macros sem notificação N/D Sim Verdadeiro
Desabilitar todas as macros com notificação ao usuário N/D Não Falso
Desabilitar todas as macros com notificação ao usuário N/D Sim Verdadeiro
Desabilitar todas as macros, exceto as digitalmente assinadas Não Não Falso
Desabilitar todas as macros, exceto as digitalmente assinadas Sim N/D Verdadeiro
Desabilitar todas as macros, exceto as digitalmente assinadas N/D Sim Verdadeiro
Habilitar todas as macros N/D N/D Verdadeiro

Por padrão, as macros estão desabilitadas em um documento do Visio que não seja de um fornecedor confiável, que não esteja digitalmente assinado ou que não esteja em um local confiável.

No entanto, você pode alterar as configurações padrão na categoria Configurações de Macro do Centro de Confiança do Visio (clique na guia Arquivo , clique em Opções, clique em Centro de Confiança e clique em Configurações do Centro de Confiança). Se Desabilitar todas as macros, exceto as digitalmente assinadas estiver selecionado, as macros nos documentos do Visio que não estejam em um local confiável serão habilitadas somente se os documentos forem digitalmente assinados. Se você selecionar Desabilitar todas as macros sem notificação ou Desabilitar todas as macros com notificação, as macros em documentos que não estejam em um local confiável serão desabilitadas. Se você selecionar Habilitar todas as macros, todas as macros serão sempre habilitadas, mas essa opção apresenta um risco de segurança e não é recomendada.

Fontes confiáveis são listadas na categoria Editores Confiáveis no Centro de Confiança e locais confiáveis são listados na categoria Locais Confiáveis .

Para abrir um documento em um estado desabilitado (as macros não estão habilitadas), você pode usar o método OpenEx do objeto Document. Por exemplo:

Documents.OpenEx(fileName , visOpenMacrosDisabled)

Exemplo

O exemplo a seguir mostra como abrir um documento de um complemento e usar a propriedade MacrosEnabled para determinar se as macros estão habilitadas. Se as macros estiverem desabilitadas, aparecerá uma caixa de mensagem avisando o usuário sobre a funcionalidade limitada. Antes de executar este exemplo, forneça um nome válido de arquivo de documento para a variável filename.

 
Public Sub MacrosEnabled_Example() 
 
    Dim vsoDocument As Visio.Document 
    Dim blsStatus As Boolean 
 
    Set vsoDocument = Documents.Open("filename ") 
    blsStatus = vsoDocument.MacrosEnabled 
 
    If Not blsStatus Then 
 
         MsgBox "Macro execution has been disabled for this document." & _  
            "Functionality may be limited." 
 
    End if 
 
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.