Cloner des diapositives

Cloner des diapositives dans une présentation

Le clonage est le processus de création d’une copie exacte ou d’une réplique de quelque chose. Aspose.Slides pour Java permet également de faire une copie ou un clone de n’importe quelle 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 diapositives crée une nouvelle diapositive qui peut être modifiée par les développeurs sans changer la diapositive d’origine. Il existe plusieurs moyens possibles 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 pour Java, (une collection d’objets ISlide) exposée par l’objet Presentation fournit les méthodes addClone et insertClone pour effectuer les types de clonage de diapositives ci-dessus.

Cloner à la fin d’une présentation

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

  1. Créez une instance de la classe Presentation.
  2. Instanciez la classe ISlideCollection en référencant la collection de diapositives exposée par l’objet Presentation.
  3. Appelez la méthode addClone exposée par l’objet ISlideCollection et passez la diapositive à cloner comme paramètre à la méthode addClone.
  4. Écrivez le fichier de présentation modifié.

Dans l’exemple donné 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));

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

Cloner à une autre position dans la présentation

Si vous souhaitez cloner une diapositive et l’utiliser dans le même fichier de présentation mais à une autre position, utilisez la méthode insertClone :

  1. Créez une instance de la classe Presentation.
  2. Instanciez la classe en référencant la collection Slides exposée par l’objet Presentation.
  3. Appelez la méthode insertClone exposée par l’objet ISlideCollection et passez la diapositive à cloner ainsi que l’indice pour la nouvelle position comme paramètre à la méthode insertClone.
  4. Écrivez la présentation modifiée en tant que fichier PPTX.

Dans l’exemple donné 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 à l'indice spécifié dans la même présentation
    ISlideCollection slds = pres.getSlides();

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

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

Cloner à la fin dans une autre présentation

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

  1. Créez une instance de la classe Presentation contenant la présentation dont la diapositive sera clonée.
  2. Créez une instance de la classe Presentation contenant la présentation de destination à laquelle la diapositive sera ajoutée.
  3. Instanciez la classe ISlideCollection en référencant la collection Slides exposée par l’objet Presentation de la présentation de destination.
  4. Appelez la méthode addClone exposée par l’objet ISlideCollection et passez la diapositive de la présentation source comme paramètre à la méthode addClone.
  5. Écrivez le fichier de présentation de destination modifié.

Dans l’exemple donné ci-dessous, nous avons cloné une diapositive (de l’indice premier 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 la destination PPTX (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));

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

Cloner à une autre position dans une autre présentation

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

  1. Créez une instance de la classe Presentation contenant la présentation source dont la diapositive sera clonée.
  2. Créez une instance de la classe Presentation contenant la présentation à laquelle la diapositive sera ajoutée.
  3. Instanciez la classe ISlideCollection en référencant la collection Slides exposée par l’objet Presentation de la présentation de destination.
  4. Appelez la méthode insertClone exposée par l’objet ISlideCollection et passez la diapositive de la présentation source ainsi que la position désirée comme paramètre à la méthode insertClone.
  5. Écrivez le fichier de présentation de destination modifié.

Dans l’exemple donné 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 la destination PPTX (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));

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

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

Si vous devez cloner une diapositive avec une diapositive maître d’une présentation et l’utiliser dans une autre présentation, vous devez d’abord cloner la diapositive maître souhaitée de la présentation source vers la présentation de destination. Ensuite, vous devez utiliser cette diapositive maître pour cloner la diapositive avec la diapositive maître. La méthode addClone(ISlide, IMasterSlide, boolean) attend une diapositive maître de la présentation de destination plutôt que de la présentation source. Pour cloner la diapositive avec un maître, veuillez suivre les étapes ci-dessous :

  1. Créez une instance de la classe Presentation contenant la présentation source dont la diapositive sera clonée.
  2. Créez une instance de la classe Presentation contenant la présentation de destination à laquelle la diapositive sera clonée.
  3. Accédez à la diapositive à cloner ainsi qu’à la diapositive maître.
  4. Instanciez la classe IMasterSlideCollection en référencant la collection Masters exposée par l’objet Presentation de la présentation de destination.
  5. Appelez la méthode addClone exposée par l’objet IMasterSlideCollection et passez le maître de la présentation source à cloner comme paramètre à la méthode addClone.
  6. 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.
  7. Appelez la méthode addClone exposée par l’objet ISlideCollection et passez la diapositive de la présentation source à cloner et la diapositive maître comme paramètre à la méthode addClone.
  8. Écrivez le fichier de présentation de destination modifié.

Dans l’exemple donné ci-dessous, nous avons cloné une diapositive avec un 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 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 dans la présentation source ainsi que
        // la diapositive maître
        ISlide SourceSlide = srcPres.getSlides().get_Item(0);
        IMasterSlide SourceMaster = SourceSlide.getLayoutSlide().getMasterSlide();

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

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

        // Cloner la diapositive souhaitée de la présentation source avec le maître souhaité à 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 à la fin dans une section spécifiée

Si vous souhaitez cloner une diapositive et 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 pour Java permet de cloner une diapositive de la première section puis d’insérer cette diapositive clonée dans la deuxième section de la même présentation.

Le code d’exemple suivant vous 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();
}
Supprimer une diapositive de la présentation Comparer des Diapositives