Správa ActiveX ovládacích prvků v prezentacích pomocí Javy

Úvod

ActiveX ovládací prvky se používají v prezentacích. Aspose.Slides for Java vám umožňuje přidávat a spravovat ActiveX ovládací prvky, ale jsou o něco obtížnější na správu ve srovnání s běžnými tvary prezentace. Implementovali jsme podporu pro přidání ActiveX ovládacího prvku Media Player v Aspose.Slides. Všimněte si, že ActiveX ovládací prvky nejsou tvary; nejsou součástí IShapeCollection prezentace. Patří místo toho do samostatné IControlCollection. V tomto tématu vám ukážeme, jak s nimi pracovat.

Přidání ActiveX ovládacího prvku Media Player na snímek

Chcete‑li přidat ActiveX ovládací prvek Media Player, postupujte takto:

  1. Vytvořte instanci třídy Presentation a vygenerujte prázdnou prezentaci.
  2. Získejte cílový snímek v Presentation.
  3. Přidejte ActiveX ovládací prvek Media Player pomocí metody addControl vystavené rozhraním IControlCollection.
  4. Získejte přístup k ovládacímu prvku Media Player a nastavte cestu k videu pomocí jeho vlastností.
  5. Uložte prezentaci jako soubor PPTX.

Tento ukázkový kód, založený na výše uvedených krocích, ukazuje, jak přidat ActiveX ovládací prvek Media Player na snímek:

// Vytvořte prázdnou instanci prezentace
Presentation pres = new Presentation();
try {
    // Přidání ActiveX ovládacího prvku Media Player
    pres.getSlides().get_Item(0).getControls().addControl(ControlType.WindowsMediaPlayer, 100, 100, 400, 400);

    // Získání přístupu k ActiveX ovládacímu prvku Media Player a nastavení cesty k videu
    pres.getSlides().get_Item(0).getControls().get_Item(0).getProperties().set_Item("URL", "Wildlife.wmv");

    // Uložení prezentace
    pres.save("Output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Úprava ActiveX ovládacího prvku

Chcete‑li spravovat jednoduchý ActiveX ovládací prvek, například textové pole a jednoduché tlačítko příkazu na snímku, postupujte takto:

  1. Vytvořte instanci třídy Presentation a načtěte prezentaci s ActiveX ovládacími prvky.
  2. Získejte referenci na snímek podle jeho indexu.
  3. Přístup k ActiveX ovládacím prvkům na snímku získáte přes IControlCollection.
  4. Získejte ActiveX ovládací prvek TextBox1 pomocí objektu IControl.
  5. Změňte vlastnosti ActiveX ovládacího prvku TextBox1, které zahrnují text, písmo, velikost písma a pozici rámce.
  6. Přístup k druhému ovládacímu prvku nazvanému CommandButton1.
  7. Změňte popisek tlačítka, písmo a pozici.
  8. Posuňte pozice rámců ActiveX ovládacích prvků.
  9. Zapište upravenou prezentaci do souboru PPTX.

Tento ukázkový kód, založený na výše uvedených krocích, ukazuje, jak spravovat jednoduchý ActiveX ovládací prvek:

// Přístup k prezentaci s ActiveX ovládacími prvky
Presentation pres = new Presentation("ActiveX.pptm");
try {
    // Přístup k prvnímu snímku v prezentaci
    ISlide slide = pres.getSlides().get_Item(0);

    // změna textu TextBoxu
    IControl control = slide.getControls().get_Item(0);

    if (control.getName().equalsIgnoreCase("TextBox1") && control.getProperties() != null) {
        String newText = "Changed text";
        control.getProperties().set_Item("Value", newText);

        // Změna náhradního obrázku. PowerPoint tento obrázek nahradí během aktivace ActiveX,
        // takže někdy je v pořádku nechat obrázek beze změny.
        BufferedImage image = new BufferedImage((int) control.getFrame().getWidth(), (int) control.getFrame().getHeight(),
                BufferedImage.TYPE_INT_ARGB);

        java.awt.Graphics graphics = image.getGraphics();
        graphics.setColor(SystemColor.window);
        graphics.fillRect(0, 0, image.getWidth(), image.getHeight());

        java.awt.Font font = new java.awt.Font(control.getProperties().get_Item("FontName"), java.awt.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();

        ByteArrayOutputStream baos = new ByteArrayOutputStream();
        ImageIO.write(image, "PNG", baos);

        control.getSubstitutePictureFormat().getPicture().setImage(pres.getImages().addImage(baos.toByteArray()));
    }

    // Změna popisku tlačítka
    control = pres.getSlides().get_Item(0).getControls().get_Item(1);

    if (control.getName().equalsIgnoreCase("CommandButton1") && control.getProperties() != null) {
        String newCaption = "Show MessageBox";
        control.getProperties().set_Item("Caption", newCaption);
        // Změna náhrady
        BufferedImage image = new BufferedImage((int) control.getFrame().getWidth(), (int) control.getFrame().getHeight(),
                BufferedImage.TYPE_INT_ARGB);
        java.awt.Graphics graphics = image.getGraphics();
        graphics.setColor(SystemColor.control);
        graphics.fillRect(0, 0, image.getWidth(), image.getHeight());

        java.awt.Font font = new java.awt.Font(control.getProperties().get_Item("FontName"), java.awt.Font.PLAIN, 16);
        graphics.setColor(SystemColor.windowText);
        graphics.setFont(font);
        FontMetrics 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();

                ByteArrayOutputStream baos = new ByteArrayOutputStream();
                ImageIO.write(image, "PNG", baos);

                control.getSubstitutePictureFormat().getPicture().setImage(pres.getImages().addImage(baos.toByteArray()));
            }

            // posunutí o 100 bodů dolů
            for (IControl ctl : pres.getSlides().get_Item(0).getControls()) {
                IShapeFrame 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);

            // odstranění ovládacích prvků
            pres.getSlides().get_Item(0).getControls().clear();
            pres.save("withActiveX-cleared_java.pptm", SaveFormat.Pptm);
        } catch(IOException e) {
        } finally {
            if (pres != null) pres.dispose();
        }

Často kladené otázky

Zachovává Aspose.Slides ActiveX ovládací prvky při čtení a opětovném uložení, pokud nemohou být spuštěny v Java runtime?

Ano. Aspose.Slides s nimi zachází jako s částí prezentace a může číst/upravovat jejich vlastnosti a rámce; není nutné samotné ovládací prvky spouštět, aby byly zachovány.

Jak se ActiveX ovládací prvky liší od OLE objektů v prezentaci?

ActiveX ovládací prvky jsou interaktivní řízené prvky (tlačítka, textová pole, přehrávač médií), zatímco OLE odkazuje na vložené aplikační objekty (například list Excelu). Jsou ukládány a zpracovávány odlišně a mají odlišné modely vlastností.

Fungují události ActiveX a VBA makra, pokud byl soubor upraven pomocí Aspose.Slides?

Aspose.Slides zachovává existující značky a metadata; události a makra však běží pouze v PowerPointu na Windows, pokud to bezpečnostní nastavení dovolí. Knihovna neprovádí VBA.