Gerenciar Controles ActiveX em Apresentações Usando JavaScript

Introdução

Os controles ActiveX são usados em apresentações. O Aspose.Slides para Node.js via Java permite adicionar e gerenciar controles ActiveX, mas eles são um pouco mais difíceis de manipular em comparação com formas normais de apresentação. Implementamos suporte para adicionar o controle Active Media Player no Aspose.Slides. Observe que os controles ActiveX não são formas; eles não fazem parte da apresentação’s ShapeCollection. Eles fazem parte da ControlCollection separada. Neste tópico, mostraremos como trabalhar com eles.

Adicionando o Controle ActiveX Media Player ao Slide

Para adicionar um controle ActiveX Media Player, faça o seguinte:

  1. Crie uma instância da classe Presentation e gere uma instância de apresentação vazia.
  2. Acesse o slide de destino na classe Presentation.
  3. Adicione o controle ActiveX Media Player usando o método addControl exposto por ControlCollection.
  4. Acesse o controle ActiveX Media Player e defina o caminho do vídeo usando suas propriedades.
  5. Salve a apresentação como um arquivo PPTX.

Este código de exemplo, baseado nas etapas acima, demonstra como adicionar o Controle ActiveX Media Player a um slide:

// Criar instância de apresentação vazia
var pres = new aspose.slides.Presentation();
try {
    // Adicionando o controle ActiveX Media Player
    pres.getSlides().get_Item(0).getControls().addControl(aspose.slides.ControlType.WindowsMediaPlayer, 100, 100, 400, 400);
    // Acessar o controle ActiveX Media Player e definir o caminho do vídeo
    pres.getSlides().get_Item(0).getControls().get_Item(0).getProperties().set_Item("java.net.URL", "Wildlife.wmv");
    // Salvar a apresentação
    pres.save("Output.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Modificando o Controle ActiveX

Para gerenciar um controle ActiveX simples, como uma caixa de texto e um botão de comando simples em um slide, faça o seguinte:

  1. Crie uma instância da classe Presentation e carregue a apresentação que contém controles ActiveX.
  2. Obtenha uma referência ao slide pelo seu índice.
  3. Acesse os controles ActiveX no slide obtendo a ControlCollection.
  4. Acesse o controle ActiveX TextBox1 usando o objeto Control.
  5. Altere as propriedades do controle ActiveX TextBox1, que incluem texto, fonte, altura da fonte e posição do quadro.
  6. Acesse o segundo controle chamado CommandButton1.
  7. Altere a legenda do botão, a fonte e a posição.
  8. Desloque a posição dos quadros dos controles ActiveX.
  9. Grave a apresentação modificada em um arquivo PPTX.

Este código de exemplo, baseado nas etapas acima, demonstra como gerenciar um controle ActiveX simples:

const imageio = java.import("javax.imageio.ImageIO");
// Acessando a apresentação com controles ActiveX
var pres = new aspose.slides.Presentation("ActiveX.pptm");
try {
    // Acessando o primeiro slide da apresentação
    var slide = pres.getSlides().get_Item(0);
    // alterando o texto da TextBox
    var control = slide.getControls().get_Item(0);
    if (control.getName().toUpperCase() === "TextBox1".toUpperCase() && (control.getProperties() != null)) {
        var newText = "Changed text";
        control.getProperties().set_Item("Value", newText);
        // Alterando a imagem substituta. O PowerPoint substituirá esta imagem durante a ativação do ActiveX,
        // então às vezes é OK deixar a imagem inalterada.
        var image = java.newInstanceSync("java.awt.image.BufferedImage", control.getFrame().getWidth(), control.getFrame().getHeight(), java.getStaticFieldValue("java.awt.image.BufferedImage", "TYPE_INT_ARGB"));
        var graphics = image.getGraphics();
        graphics.setColor(java.getStaticFieldValue("java.awt.SystemColor", "window"));
        graphics.fillRect(0, 0, image.getWidth(), image.getHeight());
        var font = java.newInstanceSync("java.awt.Font", control.getProperties().get_Item("FontName"), java.getStaticFieldValue("java.awt.Font", "PLAIN"), 16);
        graphics.setColor(java.getStaticFieldValue("java.awt.SystemColor", "windowText"));
        graphics.setFont(font);
        graphics.drawString(newText, 10, 20);
        graphics.setColor(java.getStaticFieldValue("java.awt.SystemColor", "controlShadow"));
        graphics.drawLine(0, image.getHeight() - 1, 0, 0);
        graphics.drawLine(0, 0, image.getWidth() - 1, 0);
        graphics.setColor(java.getStaticFieldValue("java.awt.SystemColor", "controlDkShadow"));
        graphics.drawLine(1, image.getHeight() - 2, 1, 1);
        graphics.drawLine(1, 1, image.getWidth() - 2, 1);
        graphics.setColor(java.getStaticFieldValue("java.awt.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(java.getStaticFieldValue("java.awt.SystemColor", "controlLtHighlight"));
        graphics.drawLine(0, image.getHeight(), image.getWidth(), image.getHeight());
        graphics.drawLine(image.getWidth(), image.getHeight(), image.getWidth(), 0);
        graphics.dispose();
        var baos = java.newInstanceSync("java.io.ByteArrayOutputStream");
        imageio.write(image, "PNG", baos);
        var byteStream = Readable.from([Buffer.from(baos.toByteArray())]);
        aspose.slides.readBytesFromStream(byteStream, (imgData) => {
            control.getSubstitutePictureFormat().getPicture().setImage(pres.getImages().addImage(imgData));
        });
    }
    // Alterando a legenda do botão
    control = pres.getSlides().get_Item(0).getControls().get_Item(1);
    if (control.getName().toUpperCase() === "CommandButton1".toUpperCase() && (control.getProperties() != null)) {
        var newCaption = "Show MessageBox";
        control.getProperties().set_Item("Caption", newCaption);
        // Alterando substituta
        var image = java.newInstanceSync("java.awt.image.BufferedImage", control.getFrame().getWidth(), control.getFrame().getHeight(), java.getStaticFieldValue("java.awt.image.BufferedImage", "TYPE_INT_ARGB"));
        var graphics = image.getGraphics();
        graphics.setColor(java.getStaticFieldValue("java.awt.SystemColor", "control"));
        graphics.fillRect(0, 0, image.getWidth(), image.getHeight());
        var font = java.newInstanceSync("java.awt.Font", control.getProperties().get_Item("FontName"), java.getStaticFieldValue("java.awt.Font", "PLAIN"), 16);
        graphics.setColor(java.getStaticFieldValue("java.awt.SystemColor", "windowText"));
        graphics.setFont(font);
        var metrics = graphics.getFontMetrics(font);
        graphics.drawString(newCaption, java.newFloat((image.getWidth() - metrics.stringWidth(newCaption)) / 2), 20);
        graphics.setColor(java.getStaticFieldValue("java.awt.SystemColor", "controlLtHighlight"));
        graphics.drawLine(0, image.getHeight() - 1, 0, 0);
        graphics.drawLine(0, 0, image.getWidth() - 1, 0);
        graphics.setColor(java.getStaticFieldValue("java.awt.SystemColor", "controlHighlight"));
        graphics.drawLine(1, image.getHeight() - 2, 1, 1);
        graphics.drawLine(1, 1, image.getWidth() - 2, 1);
        graphics.setColor(java.getStaticFieldValue("java.awt.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(java.getStaticFieldValue("java.awt.SystemColor", "controlDkShadow"));
        graphics.drawLine(0, image.getHeight(), image.getWidth(), image.getHeight());
        graphics.drawLine(image.getWidth(), image.getHeight(), image.getWidth(), 0);
        graphics.dispose();
        
        var baos = java.newInstanceSync("java.io.ByteArrayOutputStream");
        imageio.write(image, "PNG", baos);
        var byteStream = Readable.from([Buffer.from(baos.toByteArray())]);
        aspose.slides.readBytesFromStream(byteStream, (imgData) => {
            control.getSubstitutePictureFormat().getPicture().setImage(pres.getImages().addImage(imgData));
        });
    }
    // movendo 100 pontos para baixo
    for (let i = 0; i < pres.getSlides().get_Item(0).getControls().size(); i++) {
        let ctl = pres.getSlides().get_Item(0).getControls().get_Item(i);
        var frame = ctl.getFrame();
        ctl.setFrame(new aspose.slides.ShapeFrame(frame.getX(), frame.getY() + 100, frame.getWidth(), frame.getHeight(), java.newByte(frame.getFlipH()), java.newByte(frame.getFlipV()), frame.getRotation()));
    }
    pres.save("withActiveX-edited_java.pptm", aspose.slides.SaveFormat.Pptm);
    // removendo controles
    pres.getSlides().get_Item(0).getControls().clear();
    pres.save("withActiveX-cleared_java.pptm", aspose.slides.SaveFormat.Pptm);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Perguntas Frequentes

O Aspose.Slides preserva os controles ActiveX ao ler e regravar se eles não puderem ser executados no runtime Python?

Sim. O Aspose.Slides os trata como parte da apresentação e pode ler/modificar suas propriedades e quadros; executar os próprios controles não é necessário para preservá-los.

Como os controles ActiveX diferem dos objetos OLE em uma apresentação?

Os controles ActiveX são controles interativos gerenciados (botões, caixas de texto, reprodutor de mídia), enquanto OLE se refere a objetos de aplicativo incorporados (por exemplo, uma planilha do Excel). Eles são armazenados e manipulados de forma diferente e possuem modelos de propriedades distintos.

Os eventos ActiveX e macros VBA funcionam se o arquivo foi modificado pelo Aspose.Slides?

O Aspose.Slides preserva a marcação e os metadados existentes; entretanto, eventos e macros são executados apenas dentro do PowerPoint no Windows quando a segurança permite. A biblioteca não executa VBA.

Criar miniaturas de formas de apresentação em JavaScript