Macros
Economize tempo usando uma macro para automatizar uma série de tarefas repetitivas. A macro permite especificar uma sequência de ações que, posteriormente, podem ser repetidas rapidamente.
Não é necessário experiência em programação para usar macros — na realidade, as ferramentas básicas para trabalhar com macros estão na janela principal do aplicativo. No entanto, se desejar ter mais controle sobre suas macros, use os seguintes ambientes internos de programação:
•
Microsoft Visual Studio Tools for Applications (VSTA) — o sucessor do VBA e uma excelente opção para desenvolvedores e outros especialistas em programação. O VSTA fornece as ferramentas e os recursos necessários para criar os projetos de macro mais avançados.
•
Visual Basic for Applications (VBA) — um subconjunto do ambiente de programação Microsoft Visual Basic (VB) e uma excelente opção para iniciantes. É possível usar o VBA para criar macros para uso pessoal, mas você também para criar projetos de macro mais avançados.

Para obter informações detalhadas sobre as diferenças entre VBA e VSTA, consulte o guia de programação na área do Desenvolvedor do site da comunidade do CorelDRAW.
Introdução a macros
Os recursos de macros do VBA ou VSTA são instalados com o software por padrão, mas podem ser instalados manualmente se necessário. É possível especificar opções para o recurso VBA.

Para usar os recursos de macro do VSTA com CorelDRAW, você deve ter o Microsoft Visual Studio 2019 instalado. Para usar o VSTA Editor, instale primeiro o Microsoft Visual Studio 2019, Community, Professional, Premium, Ultimate ou Enterprise Edition, e, em seguida, reinstale o Microsoft Visual Studio Tools for Applications 2019 a partir de microsoft.com.
Se instalar o Microsoft Visual Studio após instalar o CorelDRAW Graphics Suite, você deverá reinstalar os recursos de macro do VSTA modificando sua instalação do CorelDRAW Graphics Suite. Para obter mais informações, consulte Para instalar manualmente os recursos de macro.
Os recursos de macros fornecem várias ferramentas para trabalhar com macros na janela principal do aplicativo:
•
Barra de ferramentas Macros — proporciona acesso fácil a funções comuns de macros
•
Janela de encaixe Scripts — proporciona acesso fácil a todos os projetos de macros disponíveis para VBA e às funções básicas para trabalhar com esses projetos
•
Editor de script (anteriormente Editor do Visual Basic) — fornece funções avançadas para criar projetos de macro baseados em VBA
•
Editor do Visual Studio — fornece funções avançadas para criar projetos de macro baseados em VSTA O Editor do VSTA é acessível apenas se você tiver o Microsoft Visual Studio 2019 instalado.
Criar macros
As macros são armazenadas em módulos (também chamados de "módulos de código"), que são armazenados em projetos de macro. A janela de encaixe Scripts permite exibir e gerenciar todos os projetos de macro, módulos e macros disponíveis.
É possível usar a janela de encaixe Scripts para criar projetos de macro na forma de arquivos GMS (Global Macro Storage) ou CGSaddon (Corel VSTA Projects). Usar um desses arquivos é uma excelente maneira de agrupar os componentes de um projeto de macro para compartilhamento com outras pessoas. Use a janela de encaixe Scripts para abrir (ou "carregar") os projetos de macro criados, bem como os projetos de macro instalados com o software ou que estejam disponíveis. Você também pode usar a janela de encaixe Scripts para renomear projetos de macro, além de copiar e fechar (ou "descarregar") projetos de macro baseados em GMS e VSTA.

Alguns projetos de macro são bloqueados e não podem ser modificados.

Quando você cria um documento, um projeto de macro para esse documento é adicionado automaticamente à janela de encaixe Scripts. Embora seja possível armazenar macros no projeto de macro para um documento, por exemplo, para criar um modelo único, recomenda-se usar arquivos GMS para armazenar seus projetos de macro.
Cada projeto de macro contém pelo menos um módulo. Você pode usar a janela de encaixe Scripts para adicionar um módulo a um projeto de macro baseado em VBA ou abrir módulos VBA existentes para edição. Também é possível usar a janela de encaixe Scripts para renomear ou excluir módulos VBA.

O recurso de edição é desativado para alguns módulos.
Por fim, você pode usar a janela de encaixe Scripts para criar macros nos módulos disponíveis. Não é necessário ter nenhuma experiência em programação para criar macros. No entanto, caso tenha experiência em programação para editar macros VBA, use o Editor de scripts. Também é possível usar a janela de encaixe Scripts para renomear e excluir macros do VBA.
Gravar macros
Você pode gravar macros e salvá-las para uso futuro.
Também é possível gravar macros temporárias para ações que precisam ser repetidas poucas vezes. Uma macro temporária fica acessível até uma nova macro temporária ser gravada.

O recurso de gravação é desativado para alguns projetos de macro.

Antes de gravar uma macro, saiba exatamente quais ações você deseja gravar e a ordem em que deseja gravá-las. Ao iniciar a gravação, o gravador da macro captura todas as alterações feitas em um desenho. Por exemplo, se você criar uma forma, redimensioná-la e, em seguida, alterar sua cor, a macro registra todas as alterações. Quando terminar de fazer as alterações, você deve parar de gravar a macro.
Reproduzir macros
Você pode executar as ações associadas à macro reproduzindo-a.
Também é possível reproduzir uma macro temporária.
Aprender mais sobre macros
A área do desenvolvedor no site da comunidade do CorelDRAW pode ajudá-lo com seus inúmeros recursos úteis: um guia de programação, documentação detalhada de referência do Modelo de objetos com exemplos de código, diagramas do Modelo de objetos e artigos e tutoriais mais avançados de programação.
A documentação de referência do Modelo de objetos, também conhecida como documentação de API, inclui ajuda para todos os recursos e funções que podem ser automatizados nos aplicativos. (coletivamente, esses recursos e funções são chamados de "modelo de objeto"). É possível acessar a documentação relevante com facilidade a partir do editor de script.
O diagrama do Modelo de objetos fornece uma representação hierárquica dos recursos e funções que podem ser automatizados no CorelDRAW, Corel PHOTO-PAINT e Corel DESIGNER.

Para obter informações mais detalhadas sobre o VBA e seu ambiente de programação, consulte a Ajuda do Microsoft Visual Basic no menu Ajuda do Editor de script.
Para obter informações mais detalhadas sobre o VSTA e seu ambiente de programação, consulte o menu Ajuda no Editor do VSTA.
Para instalar manualmente os recursos de macro
1
No Painel de Controle do Windows, clique em
Desinstalar um programa.
2
Clique duas vezes em
CorelDRAW Graphics Suite 2021 na página
Desinstalar ou alterar um programa.
3
Ative a opção
Modificar no assistente exibido e siga as instruções.
4
Na página
Recursos do assistente de instalação, ative as seguintes caixas de seleção na caixa de listagem
Utilitários:
•
Visual Basic para Aplicativos
•
Ferramentas Visual Studio para Aplicativos

Os recursos de macro para VBA ou VSTA são instalados com o software por padrão.
Para especificar opções de VBA
1
Clique em
Ferramentas
Opções
CorelDRAW.
3
Na área
Segurança, especifique como controlar o risco de executar macros mal-intencionadas clicando em
Opções de segurança.
Se desejar ignorar esse recurso de segurança, ative a caixa de seleção
Confiar em todos os módulos GMS instalados e, em seguida, passe para a etapa 6.
4
Na página
Nível de segurança da caixa de diálogo
Segurança, ative uma das opções a seguir:
•
Muito alto — permite a execução apenas de macros instaladas em locais confiáveis. Todas as outras macros, com ou sem assinatura, são desativadas.
•
Alto — permite a execução apenas de macros com assinatura de fontes confiáveis. Macros sem assinatura são desativadas automaticamente.
•
Médio — permite selecionar quais macros executar, mesmo que elas sejam potencialmente perigosas.
•
Baixo (não recomendado) — permite executar todas as macros potencialmente perigosas. Ative esta configuração se você tiver um software de verificação de vírus instalado ou se verificar a segurança de todos os documentos que abre.
5
Na página
Editores confiáveis da caixa de diálogo
Segurança, analise quais editores de macro são confiáveis. Clique em
Exibir para exibir detalhes sobre o editor de macros selecionado ou clique em
Remover para excluir o editor de macros selecionado da lista.
Se desejado, é possível ativar ou desativar a caixa de seleção
Confiar no acesso ao projeto do Visual Basic do editor de macros selecionado.
6
Desative a caixa de seleção
Retardar carregamento de VBA se desejar carregar o recurso VBA na inicialização.
Para acessar as ferramentas de macro
|
|
|
Exibir a barra de ferramentas Macros
|
Clique em Janela Barras de ferramentas Macros.
Uma marca de seleção ao lado do comando indica que a barra de ferramentas está sendo exibida.
|
Exibir a janela de encaixe Scripts
|
Clique em Ferramentas Scripts Scripts.
|
Exibir o Editor de script
|
Siga um dos procedimentos abaixo:
• Clique em Ferramentas Scripts Editor de script.
• Clique no botão Editor de script  na barra de ferramentas Macros.
• Clique com o botão direto do mouse em Visual Basic for Applications na janela de encaixe Scripts e, em seguida, clique em Mostrar IDE.
|
Exibir o Editor do Visual Studio
|
Clique em Ferramentas Scripts Editor do Visual Studio. (O VSTA deve estar instalado em seu comutador.)
|
Para criar um projeto de macro
•
Na janela de encaixe
Scripts, siga um dos procedimentos abaixo:
•
Clique em
Ferramentas Visual Studio para Aplicativos na lista, clique em
Novo e, em seguida, em
Novo projeto de macros.
•
Clique em
Visual Basic para Aplicativos na lista, clique em
Novo e, em seguida, em
Novo projeto de macros.
|
|
|
Abrir (ou "carregar") um projeto de macro
|
Siga um dos procedimentos abaixo:
• Clique em Ferramentas Visual Studio para Aplicativos na lista, clique em Carregar e, em seguida, escolha o projeto.
• Clique em Visual Basic para Aplicativos na lista, clique em Carregar e, em seguida, escolha o projeto.
|
Renomear um projeto de macro
|
Clique com o botão direto do mouse no projeto na lista e, em seguida, clique em Renomear.
|
Copiar um projeto de macro baseado em GMS
|
Clique com o botão direto do mouse no projeto na lista, clique em Copiar para e, em seguida, escolha o local de destino para o projeto copiado.
Não é possível copiar um projeto de macro baseado em documento. Esses projetos são armazenados em um documento e não podem ser gerenciados separadamente de tal documento.
|
Exibir ou ocultar todos os módulos da lista
|
Clique no botão Modo simples  .
|
Adicionar um módulo a um projeto de macro de VBA
|
Siga um dos procedimentos abaixo:
• Clique no projeto na lista, clique em Novo e, em seguida, em Novo módulo.
• Clique com o botão direto do mouse no projeto na lista e, em seguida, clique em Novo módulo.
|
Editar um módulo em um projeto de macro de VBA
|
Siga um dos procedimentos abaixo:
• Clique no módulo na lista e, em seguida, no botão Editar  .
• Clique com o botão direto do mouse no módulo na lista e, em seguida, clique em Editar.
|
Renomear um módulo em um projeto de macro
|
Clique com o botão direto do mouse no módulo na lista e, em seguida, clique em Renomear.
|
Excluir um módulo de um projeto de macro
|
Siga um dos procedimentos abaixo:
• Clique no módulo na lista e, em seguida, no botão Excluir  .
• Clique com o botão direto do mouse no módulo na lista e, em seguida, clique em Excluir.
|
Fechar (ou "descarregar") um projeto de macro baseado em GMS
|
Clique com o botão direto do mouse no projeto de macro na lista e, em seguida, clique em Descarregar projeto de macros.
É possível fechar um projeto de macro baseado em documento apenas fechando o documento em que ele está armazenado.
|

Alguns projetos de macro são bloqueados e não podem ser modificados.
Para criar uma macro
•
Na janela de encaixe
Scripts, siga um dos procedimentos abaixo:
•
Clique no recipiente desejado, clique em
Novo e, em seguida, em
Nova macro.
•
Clique com o botão direto do mouse no módulo de recipiente desejado e, em seguida, clique em
Nova macro.
|
|
|
|
|
Siga um dos procedimentos abaixo:
• Clique na macro na lista e, em seguida, no botão Editar  .
• Clique com o botão direto do mouse na macro na lista e, em seguida, clique em Editar.
|
|
|
Siga um dos procedimentos abaixo:
• Clique na macro na lista e, em seguida, no botão Excluir  .
• Clique com o botão direto do mouse na macro na lista e, em seguida, clique em Excluir.
|

Alguns projetos de macro são bloqueados e não podem ser modificados.
Para gravar uma macro
1
Clique em
Ferramentas
Scripts
Iniciar gravação.
É exibida a caixa de diálogo
Gravar macro.
2
Na caixa
Nome da macro, digite um nome para a macro.
Os nomes de macro podem conter números, mas precisam começar com uma letra. Os nomes de macro não podem conter espaços nem caracteres não alfanuméricos que não sejam de sublinhados ( _ ).
3
Na caixa de diálogo
Salvar macro em, escolha o projeto de macro no qual deseja salvar a macro.
4
Digite uma descrição da macro na caixa
Descrição e clique em
OK.
5
Execute as ações que deseja gravar.
O aplicativo começa a gravar suas ações. Se desejar pausar a gravação, clique em
Ferramentas
Scripts
Pausar gravação. Repita essa etapa para retomar a gravação.
6
Para parar a gravação, clique em
Arquivo
Scripts
Parar gravação.
|
|
|
Salvar as ações na lista Desfazer como macro do VBA ou um script
|
Clique em Janela Janelas de encaixe Histórico, execute as ações que deseja gravar e, em seguida, clique no botão Salvar como script  na janela de encaixe Histórico.
|

Não é possível gravar uma macro se todos os projetos de macro disponíveis estiverem bloqueados.
Nem todas as ações podem ser gravadas, algumas devido à sua complexidade (embora muitas dessas ações possam ser codificadas manualmente no Editor de script). Quando uma ação não puder ser gravada, é inserido um comentário no código da macro ("The recording of this command is not supported" [A gravação deste comando não é suportada]), mas o processo de gravação continua até que você o interrompa. Todos os comentários no código podem ser exibidos abrindo a macro no Editor de script.

Por padrão, macros são gravadas no projeto GlobalMacros para que possam ser acessados a partir de outros documentos. Entretanto, é possível alterar o projeto de macro padrão para gravações clicando com o botão direito do mouse em outro projeto na janela de encaixe Scripts e, em seguida, em Definir como projeto de gravação. Não é possível especificar um projeto de macro bloqueado.
Cancele a gravação de uma macro e descarte todos os comandos gravados até o momento clicando em Ferramentas
Scripts
Cancelar gravação.
Também é possível gravar, pausar e parar a gravação de uma macro usando a barra de ferramentas Macros ou a janela de encaixe Scripts (Arquivo
Macros
Gerenciador de Macro).
Para gravar uma macro temporária
1
Clique em
Ferramentas
Scripts
Gravar script temporário.
2
Execute as ações que deseja gravar.
O aplicativo começa a gravar suas ações. Se desejar pausar a gravação, clique em
Ferramentas
Scripts
Pausar gravação. Repita essa etapa para retomar a gravação.
3
Para parar a gravação, clique em
Arquivo
Scripts
Parar gravação.
A macro é salva temporariamente no projeto de gravação padrão. Quando a sessão atual for encerrada, a macro é excluída do projeto.

Não é possível gravar uma macro temporária se todos os projetos de macro disponíveis estiverem bloqueados.
Nem todas as ações podem ser gravadas.

Por padrão, macros são gravadas no projeto GlobalMacros para que possam ser acessados a partir de outros documentos. Entretanto, é possível alterar o projeto de gravação padrão clicando com o botão direito do mouse em outro projeto na janela de encaixe Scripts e, em seguida, em Definir como projeto de gravação. (Não é possível especificar um projeto de macro bloqueado). Se desejar, você pode criar várias gravações temporárias atribuindo cada uma a seu próprio projeto de macro.
Cancele a gravação de uma macro e descarte todos os comandos gravados até o momento clicando em Ferramentas
Scripts
Cancelar gravação.
Também é possível pausar e parar a gravação de uma macro usando a barra de ferramentas Macros ou a janela de encaixe Scripts (Ferramentas
Scripts
Scripts).
Para reproduzir uma macro
•
Execute um dos procedimentos a seguir:
•
Clique em
Ferramentas
Scripts
Executar script ou clique no botão
Executar macro 
na barra de ferramentas
Macros. Na caixa de listagem
Macros em, escolha o projeto ou arquivo no qual a macro está armazenada. Na lista
Nome da macro, selecione a macro. Clique em
Executar.
•
Na janela de encaixe
Scripts, clique duas vezes na macro na lista.
•
Na janela de encaixe
Scripts, clique na macro na lista e, em seguida, no botão
Executar 
.
•
Na janela de encaixe
Scripts, clique com o botão direto do mouse na macro na lista e, em seguida, clique em
Executar.
Para reproduzir uma macro temporária
•
Clique em
Ferramentas
Scripts
Executar script temporário.

Esta opção é ativada apenas após gravar uma macro temporária.

Caso tenha criado várias macros temporárias, é necessário especificar qual projeto de macro contém a macro que você deseja executar. Clique com o botão direto do mouse no projeto na janela de encaixe Scripts e, em seguida, clique em Definir como projeto de gravação.
Para acessar a documentação de referência do Modelo de objetos de dentro do Editor de script
1
Enquanto no Microsoft Visual Basic para Aplicativos, pressione
F2 para exibir o Navegador de objetos.
O Navegador de objetos exibe todos os recursos e funções que podem ser automatizados no Editor de script.
2
Selecione
VGCore na caixa de listagem
Biblioteca.
O Navegador de objetos é atualizado para exibir apenas os recursos e as funções do CorelDRAW, que podem ser automatizados no Editor de script. Coletivamente, esses recursos e funções são chamados de "modelo de objeto".
3
Clique em um item no Navegador de objetos e pressione
F1.

Também é possível exibir as informações de qualquer item na janela Código do Editor de script clicando no item e pressionando F1.