Gerenciar Projetos VBA em Apresentações Usando PHP

Introdução

A API Aspose.Slides contém classes para trabalhar com macros e código VBA.

Note

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 projeto) e edite módulos existentes. Você pode usar a classe VbaProject 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 ao Microsoft Office.
7. Associe as referências ao projeto VBA.
8. Salve a apresentação.

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

  # Cria uma instância da classe de apresentação
  $pres = new Presentation();
  try {
    # Cria um novo Projeto VBA
    $pres->setVbaProject(new VbaProject());
    # Adiciona um módulo vazio ao projeto VBA
    $module = $pres->getVbaProject()->getModules()->addEmptyModule("Module");
    # Define o código-fonte do módulo
    $module->setSourceCode("Sub Test(oShape As Shape)MsgBox Test End Sub");
    # Cria uma referência a <stdole>
    $stdoleReference = new VbaReferenceOleTypeLib("stdole", "*\\G{00020430-0000-0000-C000-000000000046}#2.0#0#C:\\Windows\\system32\\stdole2.tlb#OLE Automation");
    # Cria uma referência ao Office
    $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
    $pres->getVbaProject()->getReferences()->add($stdoleReference);
    $pres->getVbaProject()->getReferences()->add($officeReference);
    # Salva a Apresentação
    $pres->save("test.pptm", SaveFormat::Pptm);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Você pode querer conferir o Aspose Macro Remover, que é 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 PHP mostra como remover uma macro VBA:

  # Carrega a apresentação que contém a macro
  $pres = new Presentation("VBA.pptm");
  try {
    # Acessa o módulo Vba e o remove
    $pres->getVbaProject()->getModules()->remove($pres->getVbaProject()->getModules()->get_Item(0));
    # Salva a Apresentação
    $pres->save("test.pptm", SaveFormat::Pptm);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

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 PHP mostra como extrair macros VBA de uma apresentação que contém macros:

  # Carrega a apresentação que contém a macro
  $pres = new Presentation("VBA.pptm");
  try {
    # Verifica se a Apresentação contém um Projeto VBA
    if (!java_is_null($pres->getVbaProject())) {
      foreach($pres->getVbaProject()->getModules() as $module) {
        echo($module->getName());
        echo($module->getSourceCode());
      }
    }
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Verificar se um Projeto VBA está Protegido por Senha

Usando o método VbaProject::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 VBA project.
3. Verifique se o projeto VBA está protegido por senha para visualizar suas propriedades.

$presentation = new Presentation("VBA.pptm");
try {
    if ($presentation->getVbaProject() != null) { // Verifique se a apresentação contém um projeto VBA.
        if ($presentation->getVbaProject()->isPasswordProtected()) {
            printf("The VBA Project '%s' is protected by password to view project properties.", 
                    $presentation->getVbaProject()->getName());
        }
    }
} finally {
    $presentation->dispose();
}

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 suporta 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.

É possível trabalhar com controles ActiveX vinculados a código VBA?

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