Cloner les diapositives de présentation en Java

Cloner des diapositives dans une présentation

Le clonage est le processus consistant à créer une copie exacte ou un replica de quelque chose. Aspose.Slides for Java permet également de créer une copie ou un clone de toute diapositive, puis d’insérer cette diapositive clonée dans la présentation actuelle ou toute autre présentation ouverte. Le processus de clonage de diapositive crée une nouvelle diapositive qui peut être modifiée par les développeurs sans modifier la diapositive originale. Plusieurs méthodes permettent de cloner une diapositive :

Cloner à la fin d’une présentation.
Cloner à une autre position dans la présentation.
Cloner à la fin d’une autre présentation.
Cloner à une autre position dans une autre présentation.
Cloner à une position spécifique dans une autre présentation.

Dans Aspose.Slides for Java, (une collection d’objets ISlide …) exposée par l’objet Presentation fournit les méthodes addClone et insertClone pour réaliser les types de clonage de diapositives mentionnés ci‑dessus.

Cloner une diapositive à la fin d’une présentation

Si vous voulez cloner une diapositive puis l’utiliser dans le même fichier de présentation à la fin des diapositives existantes, utilisez la méthode addClone selon les étapes ci‑dessous :

Créez une instance de la classe Presentation.
Instanciez la classe ISlideCollection en faisant référence à la collection Slides exposée par l’objet Presentation.
Appelez la méthode addClone exposée par l’objet ISlideCollection et transmettez la diapositive à cloner en tant que paramètre à la méthode addClone.
Enregistrez le fichier de présentation modifié.

Dans l’exemple ci‑dessous, nous avons cloné une diapositive (située à la première position – indice zéro – de la présentation) à la fin de la présentation.

// Instancier la classe Presentation qui représente un fichier de présentation
Presentation pres = new Presentation("CloneWithinSamePresentationToEnd.pptx");
try {
    // Cloner la diapositive souhaitée à la fin de la collection de diapositives dans la même présentation
    ISlideCollection slds = pres.getSlides();

    slds.addClone(pres.getSlides().get_Item(0));

    // Enregistrer la présentation modifiée sur le disque
    pres.save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Cloner une diapositive à une autre position dans une présentation

Si vous voulez cloner une diapositive puis l’utiliser dans le même fichier de présentation mais à une position différente, utilisez la méthode insertClone :

Créez une instance de la classe Presentation.
Instanciez la classe en faisant référence à la collection Slides exposée par l’objet Presentation.
Appelez la méthode insertClone exposée par l’objet ISlideCollection et transmettez la diapositive à cloner ainsi que l’indice de la nouvelle position en tant que paramètres à la méthode insertClone.
Enregistrez la présentation modifiée au format PPTX.

Dans l’exemple ci‑dessous, nous avons cloné une diapositive (située à l’indice zéro – position 1 – de la présentation) à l’indice 1 – position 2 – de la présentation.

// Instancier la classe Presentation qui représente un fichier de présentation
Presentation pres = new Presentation("CloneWithInSamePresentation.pptx");
try {
    // Cloner la diapositive souhaitée à la fin de la collection de diapositives dans la même présentation
    ISlideCollection slds = pres.getSlides();

    // Cloner la diapositive souhaitée à l'index spécifié dans la même présentation
    slds.insertClone(2, pres.getSlides().get_Item(1));

    // Enregistrer la présentation modifiée sur le disque
    pres.save("Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat.Pptx);
} finally {
    pres.dispose();
}

Cloner une diapositive à la fin d’une autre présentation

Si vous devez cloner une diapositive d’une présentation et l’utiliser dans une autre présentation, à la fin des diapositives existantes :

Créez une instance de la classe Presentation contenant la présentation dont la diapositive sera clonée.
Créez une instance de la classe Presentation contenant la présentation de destination à laquelle la diapositive sera ajoutée.
Instanciez la classe ISlideCollection en faisant référence à la collection Slides exposée par l’objet Presentation de la présentation de destination.
Appelez la méthode addClone exposée par l’objet ISlideCollection et transmettez la diapositive de la présentation source en tant que paramètre à la méthode addClone.
Enregistrez le fichier de présentation de destination modifié.

Dans l’exemple ci‑dessus, nous avons cloné une diapositive (du premier indice de la présentation source) à la fin de la présentation de destination.

// Instancier la classe Presentation pour charger le fichier de présentation source
Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx");
try {
    // Instancier la classe Presentation pour le PPTX de destination (où la diapositive doit être clonée)
    Presentation destPres = new Presentation();
    try {
        // Cloner la diapositive souhaitée de la présentation source à la fin de la collection de diapositives dans la présentation de destination
        ISlideCollection slds = destPres.getSlides();

        slds.addClone(srcPres.getSlides().get_Item(0));

        // Enregistrer la présentation de destination sur le disque
        destPres.save("Aspose2_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

Cloner une diapositive à une autre position dans une autre présentation

Si vous devez cloner une diapositive d’une présentation et l’utiliser dans une autre présentation, à une position spécifique :

Créez une instance de la classe Presentation contenant la présentation source dont la diapositive sera clonée.
Créez une instance de la classe Presentation contenant la présentation à laquelle la diapositive sera ajoutée.
Instanciez la classe ISlideCollection en faisant référence à la collection Slides exposée par l’objet Presentation de la présentation de destination.
Appelez la méthode insertClone exposée par l’objet ISlideCollection et transmettez la diapositive de la présentation source ainsi que la position souhaitée en tant que paramètres à la méthode insertClone.
Enregistrez le fichier de présentation de destination modifié.

Dans l’exemple ci‑dessous, nous avons cloné une diapositive (de l’indice zéro de la présentation source) à l’indice 1 (position 2) de la présentation de destination.

// Instancier la classe Presentation pour charger le fichier de présentation source
Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx");
try {
    // Instancier la classe Presentation pour le PPTX de destination (où la diapositive doit être clonée)
    Presentation destPres = new Presentation();
    try {
        // Cloner la diapositive souhaitée de la présentation source à la fin de la collection de diapositives dans la présentation de destination
        ISlideCollection slds = destPres.getSlides();

        slds.insertClone(2, srcPres.getSlides().get_Item(0));

        // Enregistrer la présentation de destination sur le disque
        destPres.save("Aspose2_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

Cloner une diapositive à une position spécifique dans une autre présentation

Si vous devez cloner une diapositive avec une diapositive maîtresse d’une présentation vers une autre présentation, vous devez d’abord cloner la diapositive maîtresse souhaitée de la présentation source vers la présentation de destination. Ensuite, utilisez cette diapositive maîtresse pour cloner la diapositive avec maître. La méthode addClone(ISlide, IMasterSlide, boolean) attend une diapositive maîtresse provenant de la présentation de destination plutôt que de la présentation source. Pour cloner la diapositive avec maître, suivez les étapes ci‑dessous :

Créez une instance de la classe Presentation contenant la présentation source dont la diapositive sera clonée.
Créez une instance de la classe Presentation contenant la présentation de destination vers laquelle la diapositive sera clonée.
Accédez à la diapositive à cloner ainsi qu’à sa diapositive maîtresse.
Instanciez la classe IMasterSlideCollection en faisant référence à la collection Masters exposée par l’objet Presentation de la présentation de destination.
Appelez la méthode addClone exposée par l’objet IMasterSlideCollection et transmettez le maître du PPTX source à cloner en tant que paramètre à la méthode addClone.
Instanciez la classe ISlideCollection en définissant la référence à la collection Slides exposée par l’objet Presentation de la présentation de destination.
Appelez la méthode addClone exposée par l’objet ISlideCollection et transmettez la diapositive de la présentation source à cloner ainsi que la diapositive maîtresse en tant que paramètres à la méthode addClone.
Enregistrez le fichier de présentation de destination modifié.

Dans l’exemple ci‑dessous, nous avons cloné une diapositive avec maître (située à l’indice zéro de la présentation source) à la fin de la présentation de destination en utilisant un maître provenant de la diapositive source.

// Instancier la classe Presentation pour charger le fichier de présentation source
Presentation srcPres = new Presentation("CloneToAnotherPresentationWithMaster.pptx");
try {
    // Instancier la classe Presentation pour la présentation de destination (où la diapositive doit être clonée)
    Presentation destPres = new Presentation();
    try {
        // Instancier ISlide à partir de la collection de diapositives de la présentation source avec
        // Diapositive maître
        ISlide SourceSlide = srcPres.getSlides().get_Item(0);
        IMasterSlide SourceMaster = SourceSlide.getLayoutSlide().getMasterSlide();

        // Cloner la diapositive maître désirée de la présentation source vers la collection de maîtres dans le
        // présentation de destination
        IMasterSlideCollection masters = destPres.getMasters();
        IMasterSlide DestMaster = SourceSlide.getLayoutSlide().getMasterSlide();

        // Cloner la diapositive maître désirée de la présentation source vers la collection de maîtres dans le
        // présentation de destination
        IMasterSlide iSlide = masters.addClone(SourceMaster);

        // Cloner la diapositive désirée de la présentation source avec le maître souhaité jusqu'à la fin de la
        // collection de diapositives dans la présentation de destination
        ISlideCollection slds = destPres.getSlides();
        slds.addClone(SourceSlide, iSlide, true);

        // Enregistrer la présentation de destination sur le disque
        destPres.save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat.Pptx);
    } finally {
        destPres.dispose();
    }
} finally {
    srcPres.dispose();
}

Cloner une diapositive à la fin d’une section spécifiée

Si vous souhaitez cloner une diapositive puis l’utiliser dans le même fichier de présentation mais dans une section différente, utilisez la méthode addClone exposée par l’interface ISlideCollection. Aspose.Slides for Java permet de cloner une diapositive de la première section et d’insérer cette diapositive clonée dans la deuxième section de la même présentation.

Le fragment de code suivant montre comment cloner une diapositive et insérer la diapositive clonée dans une section spécifiée.

IPresentation presentation = new Presentation();
try {
    presentation.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 200, 50, 300, 100);
    presentation.getSections().addSection("Section 1", presentation.getSlides().get_Item(0));

    ISection section2 = presentation.getSections().appendEmptySection("Section 2");
    presentation.getSlides().addClone(presentation.getSlides().get_Item(0), section2);
    
    // Enregistrer la présentation de destination sur le disque
    presentation.save(dataDir + "CloneSlideIntoSpecifiedSection.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

FAQ

Les notes du présentateur et les commentaires des réviseurs sont-ils clonés ?
Oui. La page de notes et les commentaires de révision sont inclus dans le clone. Si vous ne les voulez pas, supprimez‑les après l’insertion.

Comment les graphiques et leurs sources de données sont‑ils gérés ?
L’objet graphique, son formatage et les données intégrées sont copiés. Si le graphique était lié à une source externe (par exemple, un classeur OLE intégré), ce lien est conservé sous forme d’objet OLE. Après le déplacement entre fichiers, vérifiez la disponibilité des données et le comportement de rafraîchissement.

Puis‑je contrôler la position d’insertion et les sections du clone ?
Oui. Vous pouvez insérer le clone à un indice de diapositive spécifique et le placer dans une section choisie. Si la section cible n’existe pas, créez‑la d’abord puis déplacez la diapositive dedans.

Supprimer des diapositives des présentations Java Comparer les diapositives de présentation en Java