Gestionar proyectos VBA en presentaciones usando PHP

Nota

Cuando conviertes una presentación que contiene macros a un formato de archivo diferente (PDF, HTML, etc.), Aspose.Slides ignora todas las macros (las macros no se transfieren al archivo resultante).

Cuando añades macros a una presentación o vuelves a guardar una presentación que contiene macros, Aspose.Slides simplemente escribe los bytes de las macros.

Aspose.Slides nunca ejecuta las macros en una presentación.

Add VBA Macros

Aspose.Slides proporciona la clase VbaProject para permitirte crear proyectos VBA (y referencias de proyecto) y editar módulos existentes. Puedes usar la clase VbaProject para gestionar VBA incrustado en una presentación.

1. Crea una instancia de la clase Presentation.
2. Usa la clase VbaProject para añadir un nuevo proyecto VBA.
3. Añade un módulo al VbaProject.
4. Establece el código fuente del módulo.
5. Añade referencias a .
6. Añade referencias a Microsoft Office.
7. Asocia las referencias con el proyecto VBA.
8. Guarda la presentación.

Este código PHP muestra cómo añadir una macro VBA desde cero a una presentación:

  # Crea una instancia de la clase presentation
  $pres = new Presentation();
  try {
    # Crea un nuevo proyecto VBA
    $pres->setVbaProject(new VbaProject());
    # Añade un módulo vacío al proyecto VBA
    $module = $pres->getVbaProject()->getModules()->addEmptyModule("Module");
    # Establece el código fuente del módulo
    $module->setSourceCode("Sub Test(oShape As Shape)MsgBox Test End Sub");
    # Crea una referencia a <stdole>
    $stdoleReference = new VbaReferenceOleTypeLib("stdole", "*\\G{00020430-0000-0000-C000-000000000046}#2.0#0#C:\\Windows\\system32\\stdole2.tlb#OLE Automation");
    # Crea una referencia a 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");
    # Añade referencias al proyecto VBA
    $pres->getVbaProject()->getReferences()->add($stdoleReference);
    $pres->getVbaProject()->getReferences()->add($officeReference);
    # Guarda la presentación
    $pres->save("test.pptm", SaveFormat::Pptm);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Puede que quieras probar Aspose Macro Remover, una aplicación web gratuita que elimina macros de documentos PowerPoint, Excel y Word.

Remove VBA Macros

Usando la propiedad VbaProject bajo la clase Presentation, puedes eliminar una macro VBA.

1. Crea una instancia de la clase Presentation y carga la presentación que contiene la macro.
2. Accede al módulo Macro y elimínalo.
3. Guarda la presentación modificada.

Este código PHP muestra cómo eliminar una macro VBA:

  # Carga la presentación que contiene la macro
  $pres = new Presentation("VBA.pptm");
  try {
    # Accede al módulo Vba y lo elimina
    $pres->getVbaProject()->getModules()->remove($pres->getVbaProject()->getModules()->get_Item(0));
    # Guarda la presentación
    $pres->save("test.pptm", SaveFormat::Pptm);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Extract VBA Macros

1. Crea una instancia de la clase Presentation y carga la presentación que contiene la macro.
2. Comprueba si la presentación contiene un proyecto VBA.
3. Recorre todos los módulos contenidos en el proyecto VBA para ver las macros.

Este código PHP muestra cómo extraer macros VBA de una presentación que contiene macros:

  # Carga la presentación que contiene la macro
  $pres = new Presentation("VBA.pptm");
  try {
    # Comprueba si la presentación contiene un proyecto 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();
    }
  }

Check Whether a VBA Project Is Password-Protected

Utilizando el método VbaProject::isPasswordProtected, puedes determinar si las propiedades de un proyecto están protegidas con contraseña.

1. Crea una instancia de la clase Presentation y carga una presentación que contenga una macro.
2. Comprueba si la presentación contiene un VBA project.
3. Verifica si el proyecto VBA está protegido con contraseña para ver sus propiedades.

$presentation = new Presentation("VBA.pptm");
try {
    if ($presentation->getVbaProject() != null) { // Comprueba si la presentación contiene un proyecto 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

¿Qué ocurre con las macros si guardo la presentación como PPTX?

Las macros se eliminarán porque PPTX no admite VBA. Para conservarlas, elige PPTM, PPSM o POTM.

¿Puede Aspose.Slides ejecutar macros dentro de una presentación para, por ejemplo, actualizar datos?

No. La biblioteca nunca ejecuta código VBA; la ejecución solo es posible dentro de PowerPoint con la configuración de seguridad adecuada.

¿Se admite trabajar con controles ActiveX vinculados a código VBA?

Sí, puedes acceder a los ActiveX controls, modificar sus propiedades y eliminarlos. Esto es útil cuando las macros interactúan con ActiveX.