Управление ActiveX-контролями в презентациях с помощью PHP

ActiveX‑элементы управления используются в презентациях. Aspose.Slides для PHP через Java позволяет добавлять и управлять ActiveX‑элементами, но они несколько сложнее в управлении по сравнению с обычными фигурами презентации. Мы реализовали поддержку добавления ActiveX‑контроля Media Player в Aspose.Slides. Обратите внимание, что ActiveX‑элементы не являются фигурами; они не входят в ShapeCollection презентации. Они находятся в отдельном ControlCollection. В этой статье мы покажем, как работать с ними.

Добавление ActiveX‑контроля Media Player на слайд

Чтобы добавить контроллер Media Player ActiveX, выполните следующее:

Создайте экземпляр класса Presentation и получите пустой объект презентации.
Получите доступ к целевому слайду в Presentation.
Добавьте ActiveX‑контроллер Media Player с помощью метода addControl, предоставляемого ControlCollection.
Получите доступ к контроллеру Media Player ActiveX и задайте путь к видео, используя его свойства.
Сохраните презентацию в файл PPTX.

Этот пример кода, основанный на описанных шагах, демонстрирует, как добавить ActiveX‑контроллер Media Player на слайд:

  # Создать пустой экземпляр презентации
  $pres = new Presentation();
  try {
    # Добавление ActiveX‑контрола Media Player
    $pres->getSlides()->get_Item(0)->getControls()->addControl(ControlType::WindowsMediaPlayer, 100, 100, 400, 400);
    # Доступ к ActiveX‑контролю Media Player и установка пути к видео
    $pres->getSlides()->get_Item(0)->getControls()->get_Item(0)->getProperties()->set_Item("URL", "Wildlife.wmv");
    # Сохранить презентацию
    $pres->save("Output.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Изменение ActiveX‑контроля

Aspose.Slides для PHP через Java версии 7.1.0 и новее оснащён компонентами для управления ActiveX‑элементами. Вы можете получить доступ к уже добавленному ActiveX‑контролю в презентации и изменить или удалить его через свойства.

Чтобы управлять простым ActiveX‑контролем, таким как текстовое поле и простая кнопка команд на слайде, выполните следующее:

Создайте экземпляр класса Presentation и загрузите презентацию, содержащую ActiveX‑элементы.
Получите ссылку на слайд по его индексу.
Получите доступ к ActiveX‑элементам на слайде, обратившись к ControlCollection.
Доступ к контролу TextBox1 ActiveX получайте через объект Control.
Измените свойства контроля TextBox1 ActiveX, включая текст, шрифт, высоту шрифта и позицию рамки.
Получите второй контрол под названием CommandButton1.
Измените подпись кнопки, шрифт и позицию.
Сдвиньте позиции рамок ActiveX‑контролей.
Запишите изменённую презентацию в файл PPTX.

Этот пример кода, основанный на описанных шагах, показывает, как управлять простым ActiveX‑контролем:

  # Доступ к презентации с ActiveX‑элементами
  $pres = new Presentation("ActiveX.pptm");
  try {
    # Доступ к первому слайду в презентации
    $slide = $pres->getSlides()->get_Item(0);
    # изменение текста TextBox
    $control = $slide->getControls()->get_Item(0);
    if (!java_is_null($control->getName()->equalsIgnoreCase("TextBox1") && $control->getProperties())) {
      $newText = "Changed text";
      $control->getProperties()->set_Item("Value", $newText);
      # Изменение заменяющего изображения. PowerPoint заменит это изображение при активации ActiveX,
      # поэтому иногда можно оставить изображение без изменений.
      $image = new BufferedImage($control->getFrame()->getWidth(), $control->getFrame()->getHeight(), BufferedImage->TYPE_INT_ARGB);
      $graphics = $image->getGraphics();
      $graphics->setColor(SystemColor->window);
      $graphics->fillRect(0, 0, $image->getWidth(), $image->getHeight());
      $font = new Font($control->getProperties()->get_Item("FontName"), Font->PLAIN, 16);
      $graphics->setColor(SystemColor->windowText);
      $graphics->setFont($font);
      $graphics->drawString($newText, 10, 20);
      $graphics->setColor(SystemColor->controlShadow);
      $graphics->drawLine(0, $image->getHeight() - 1, 0, 0);
      $graphics->drawLine(0, 0, $image->getWidth() - 1, 0);
      $graphics->setColor(SystemColor->controlDkShadow);
      $graphics->drawLine(1, $image->getHeight() - 2, 1, 1);
      $graphics->drawLine(1, 1, $image->getWidth() - 2, 1);
      $graphics->setColor(SystemColor->controlHighlight);
      $graphics->drawLine(1, $image->getHeight() - 1, $image->getWidth() - 1, $image->getHeight() - 1);
      $graphics->drawLine($image->getWidth() - 1, $image->getHeight() - 1, $image->getWidth() - 1, 1);
      $graphics->setColor(SystemColor->controlLtHighlight);
      $graphics->drawLine(0, $image->getHeight(), $image->getWidth(), $image->getHeight());
      $graphics->drawLine($image->getWidth(), $image->getHeight(), $image->getWidth(), 0);
      $graphics->dispose();
      $baos = new Java("java.io.ByteArrayOutputStream");
      Java("javax.imageio.ImageIO")->write($image, "PNG", $baos);
      $control->getSubstitutePictureFormat()->getPicture()->setImage($pres->getImages()->addImage($baos->toByteArray()));
    }
    # Изменение подписи кнопки
    $control = $pres->getSlides()->get_Item(0)->getControls()->get_Item(1);
    if (!java_is_null($control->getName()->equalsIgnoreCase("CommandButton1") && $control->getProperties())) {
      $newCaption = "Show MessageBox";
      $control->getProperties()->set_Item("Caption", $newCaption);
      # Изменение заменяющего
      $image = new BufferedImage($control->getFrame()->getWidth(), $control->getFrame()->getHeight(), BufferedImage->TYPE_INT_ARGB);
      $graphics = $image->getGraphics();
      $graphics->setColor(SystemColor->control);
      $graphics->fillRect(0, 0, $image->getWidth(), $image->getHeight());
      $font = new Font($control->getProperties()->get_Item("FontName"), Font->PLAIN, 16);
      $graphics->setColor(SystemColor->windowText);
      $graphics->setFont($font);
      $metrics = $graphics->getFontMetrics($font);
      $graphics->drawString($newCaption, $image->getWidth() - $metrics->stringWidth($newCaption) / 2, 20);
      $graphics->setColor(SystemColor->controlLtHighlight);
      $graphics->drawLine(0, $image->getHeight() - 1, 0, 0);
      $graphics->drawLine(0, 0, $image->getWidth() - 1, 0);
      $graphics->setColor(SystemColor->controlHighlight);
      $graphics->drawLine(1, $image->getHeight() - 2, 1, 1);
      $graphics->drawLine(1, 1, $image->getWidth() - 2, 1);
      $graphics->setColor(SystemColor->controlShadow);
      $graphics->drawLine(1, $image->getHeight() - 1, $image->getWidth() - 1, $image->getHeight() - 1);
      $graphics->drawLine($image->getWidth() - 1, $image->getHeight() - 1, $image->getWidth() - 1, 1);
      $graphics->setColor(SystemColor->controlDkShadow);
      $graphics->drawLine(0, $image->getHeight(), $image->getWidth(), $image->getHeight());
      $graphics->drawLine($image->getWidth(), $image->getHeight(), $image->getWidth(), 0);
      $graphics->dispose();
      $baos = new Java("java.io.ByteArrayOutputStream");
      Java("javax.imageio.ImageIO")->write($image, "PNG", $baos);
      $control->getSubstitutePictureFormat()->getPicture()->setImage($pres->getImages()->addImage($baos->toByteArray()));
    }
    # перемещение на 100 пунктов вниз
    foreach($pres->getSlides()->get_Item(0)->getControls() as $ctl) {
      $frame = $ctl->getFrame();
      $ctl->setFrame(new ShapeFrame($frame->getX(), $frame->getY() + 100, $frame->getWidth(), $frame->getHeight(), $frame->getFlipH(), $frame->getFlipV(), $frame->getRotation()));
    }
    $pres->save("withActiveX-edited_java.pptm", SaveFormat::Pptm);
    # удаление элементов управления
    $pres->getSlides()->get_Item(0)->getControls()->clear();
    $pres->save("withActiveX-cleared_java.pptm", SaveFormat::Pptm);
  } catch (JavaException $e) {
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Сохраняет ли Aspose.Slides ActiveX‑контролы при чтении и повторном сохранении, если они не могут быть выполнены в среде Java?

Да. Aspose.Slides рассматривает их как часть презентации и может читать/изменять их свойства и рамки; выполнение самих контролов не требуется для их сохранения.

Чем ActiveX‑контролы отличаются от объектов OLE в презентации?

ActiveX‑контролы — это интерактивные управляемые элементы (кнопки, текстовые поля, медиаплеер), тогда как OLE относится к внедрённым объектам приложений (например, листу Excel). Они хранятся и обрабатываются по‑разному и имеют разные модели свойств.

Работают ли события ActiveX и макросы VBA, если файл был изменён Aspose.Slides?

Aspose.Slides сохраняет существующую разметку и метаданные; однако события и макросы выполняются только в PowerPoint под Windows при разрешённой безопасности. Библиотека не исполняет VBA.

Создание миниатюр фигур презентаций в PHP