Gerenciar Projetos VBA em Apresentações no .NET

Introdução

O namespace Aspose.Slides.Vba contém classes e interfaces para trabalhar com macros e código VBA.

Nota

Ao converter uma apresentação que contém macros para um formato de arquivo diferente (PDF, HTML, etc.), o Aspose.Slides ignora todas as macros (as macros não são transportadas para o arquivo resultante).

Ao adicionar macros a uma apresentação ou ao salvar novamente uma apresentação que contém macros, o Aspose.Slides simplesmente grava os bytes das macros.

O Aspose.Slides nunca executa as macros em uma apresentação.

Adicionar Macros VBA

O Aspose.Slides fornece a classe VbaProject para permitir que você crie projetos VBA (e referências de projetos) e edite módulos existentes. Você pode usar a interface IVbaProject para gerenciar VBA incorporado em uma apresentação.

1. Crie uma instância da classe Presentation .
2. Use o construtor VbaProject para adicionar um novo projeto VBA.
3. Adicione um módulo ao VbaProject.
4. Defina o código-fonte do módulo.
5. Adicione referências a .
6. Adicione referências a Microsoft Office.
7. Associe as referências ao projeto VBA.
8. Salve a apresentação.

Este código C# mostra como adicionar uma macro VBA do zero a uma apresentação:

    // Cria uma instância da classe de apresentação
using (Presentation presentation = new Presentation())
{
    // Cria um novo Projeto VBA
    presentation.VbaProject = new VbaProject();

    // Adiciona um módulo vazio ao projeto VBA
    IVbaModule module = presentation.VbaProject.Modules.AddEmptyModule("Module");
  
    // Define o código-fonte do módulo
    module.SourceCode = @"Sub Test(oShape As Shape) MsgBox ""Test"" End Sub";

    // Cria uma referência para <stdole>
    VbaReferenceOleTypeLib stdoleReference =
        new VbaReferenceOleTypeLib("stdole", "*\\G{00020430-0000-0000-C000-000000000046}#2.0#0#C:\\Windows\\system32\\stdole2.tlb#OLE Automation");

    // Cria uma referência para Office
    VbaReferenceOleTypeLib officeReference =
        new VbaReferenceOleTypeLib("Office", "*\\G{2DF8D04C-5BFA-101B-BDE5-00AA0044DE52}#2.0#0#C:\\Program Files\\Common Files\\Microsoft Shared\\OFFICE14\\MSO.DLL#Microsoft Office 14.0 Object Library");

    // Adiciona referências ao projeto VBA
    presentation.VbaProject.References.Add(stdoleReference);
    presentation.VbaProject.References.Add(officeReference);

            
    // Salva a Apresentação
    presentation.Save(dataDir + "AddVBAMacros_out.pptm", SaveFormat.Pptm);
}

Você pode querer conferir o Aspose Macro Remover, um aplicativo web gratuito usado para remover macros de documentos PowerPoint, Excel e Word.

Remover Macros VBA

Usando a propriedade VbaProject da classe Presentation, você pode remover uma macro VBA.

1. Crie uma instância da classe Presentation e carregue a apresentação que contém a macro.
2. Acesse o módulo Macro e remova-o.
3. Salve a apresentação modificada.

Este código C# mostra como remover uma macro VBA:

    // Carrega a apresentação que contém a macro
using (Presentation presentation = new Presentation(dataDir + "VBA.pptm"))
{
    // Acessa o módulo Vba e o remove 
    presentation.VbaProject.Modules.Remove(presentation.VbaProject.Modules[0]);

    // Salva a Apresentação
    presentation.Save(dataDir + "RemovedVBAMacros_out.pptm", SaveFormat.Pptm);
}

Extrair Macros VBA

1. Crie uma instância da classe Presentation e carregue a apresentação que contém a macro.
2. Verifique se a apresentação contém um Projeto VBA.
3. Percorra todos os módulos contidos no Projeto VBA para visualizar as macros.

Este código C# mostra como extrair macros VBA de uma apresentação que contém macros:

    // Carrega a apresentação que contém a macro
using (Presentation pres = new Presentation("VBA.pptm"))
{
	if (pres.VbaProject != null) // Verifica se a Apresentação contém um Projeto VBA
	{
		foreach (IVbaModule module in pres.VbaProject.Modules)
		{
			Console.WriteLine(module.Name);
			Console.WriteLine(module.SourceCode);
		}
	}
}

Verificar se um Projeto VBA está Protegido por Senha

Usando a propriedade IVbaProject.IsPasswordProtected, você pode determinar se as propriedades de um projeto estão protegidas por senha.

1. Crie uma instância da classe Presentation e carregue uma apresentação que contém uma macro.
2. Verifique se a apresentação contém um projeto VBA.
3. Verifique se o projeto VBA está protegido por senha para visualizar suas propriedades.

using (Presentation presentation = new Presentation("VBA.pptm"))
{
    if (presentation.VbaProject != null) // Verifica se a apresentação contém um projeto VBA.
    {
        if (presentation.VbaProject.IsPasswordProtected)
        {
            Console.WriteLine($"The VBA Project '{presentation.VbaProject.Name}' is protected by password to view project properties.");
        }
    }
}

FAQ

O que acontece com as macros se eu salvar a apresentação como PPTX?

As macros serão removidas porque o PPTX não oferece suporte a VBA. Para manter as macros, escolha PPTM, PPSM ou POTM.

O Aspose.Slides pode executar macros dentro de uma apresentação para, por exemplo, atualizar dados?

Não. A biblioteca nunca executa código VBA; a execução só é possível dentro do PowerPoint com as configurações de segurança adequadas.

O trabalho com controles ActiveX vinculados a código VBA é suportado?

Sim, você pode acessar os controles ActiveX existentes, modificar suas propriedades e removê-los. Isso é útil quando as macros interagem com ActiveX.