Cloner les diapositives de présentation en .NET
Cloner les diapositives dans une présentation
Le clonage est le processus de création d’une copie exacte ou d’un replica d’un élément. Aspose.Slides for .NET permet également de créer une copie ou un clone de n’importe quelle diapositive, puis d’insérer cette diapositive clonée dans la présentation actuelle ou dans 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 modifier la diapositive originale. Il existe plusieurs manières de cloner une diapositive :
- Cloner à la fin d’une présentation.
- Cloner à une autre position dans la même 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 .NET, (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 mentionnés ci‑dessus.
Cloner une diapositive à la fin d’une présentation
Si vous souhaitez 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 paramètre de 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
using (Presentation pres = new Presentation("CloneWithinSamePresentationToEnd.pptx"))
{
// Cloner la diapositive souhaitée à la fin de la collection de diapositives dans la même présentation
ISlideCollection slds = pres.Slides;
slds.AddClone(pres.Slides[0]);
// Enregistrer la présentation modifiée sur le disque
pres.Save("Aspose_CloneWithinSamePresentationToEnd_out.pptx", SaveFormat.Pptx);
}
Cloner une diapositive à une autre position dans une présentation
Si vous souhaitez 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 paramètre de 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
using (Presentation pres = new Presentation("CloneWithInSamePresentation.pptx"))
{
// Cloner la diapositive souhaitée à la fin de la collection de diapositives dans la même présentation
ISlideCollection slds = pres.Slides;
// Cloner la diapositive souhaitée à l'index spécifié dans la même présentation
slds.InsertClone(2, pres.Slides[1]);
// Enregistrer la présentation modifiée sur le disque
pres.Save("Aspose_CloneWithInSamePresentation_out.pptx", SaveFormat.Pptx);
}
Cloner une diapositive à la fin d’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 :
- Créez une instance de la classe Presentation contenant la présentation depuis laquelle 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 paramètre de la méthode AddClone.
- Enregistrez le fichier de présentation de destination modifié.
Dans l’exemple ci‑dessus, nous avons cloné une diapositive (à partir 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
using (Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx"))
{
// Instancier la classe Presentation pour le PPTX de destination (où la diapositive doit être clonée)
using (Presentation destPres = new Presentation())
{
// Cloner la diapositive souhaitée de la présentation source à la fin de la collection de diapositives de la présentation de destination
ISlideCollection slds = destPres.Slides;
slds.AddClone(srcPres.Slides[0]);
// Enregistrer la présentation de destination sur le disque
destPres.Save("Aspose2_out.pptx", SaveFormat.Pptx);
}
}
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 un autre fichier de présentation, à une position spécifique :
- Créez une instance de la classe Presentation contenant la présentation source depuis laquelle 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 paramètre de la méthode InsertClone.
- Enregistrez le fichier de présentation de destination modifié.
Dans l’exemple ci‑dessus, nous avons cloné une diapositive (à partir 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
using (Presentation srcPres = new Presentation("CloneAtEndOfAnother.pptx"))
{
// Instancier la classe Presentation pour le PPTX de destination (où la diapositive doit être clonée)
using (Presentation destPres = new Presentation())
{
ISlideCollection slds = destPres.Slides;
slds.InsertClone(2, srcPres.Slides[0]);
// Enregistrer la présentation de destination sur le disque
destPres.Save("Aspose2_out.pptx", SaveFormat.Pptx);
}
}
Cloner une diapositive à 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, utilisez cette diapositive maître pour cloner la diapositive avec maître. La méthode AddClone(ISlide, IMasterSlide) attend une diapositive maître provenant de la présentation de destination et non de la source. Pour cloner la diapositive avec maître, veuillez suivre les étapes ci‑dessous :
- Créez une instance de la classe Presentation contenant la présentation source depuis laquelle 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ître.
- 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 paramètre de 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ître en paramètre de la méthode AddClone.
- Enregistrez le fichier de présentation de destination modifié.
Dans l’exemple ci‑dessus, 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 le maître de la diapositive source.
// Instancier la classe Presentation pour charger le fichier de présentation source
using (Presentation srcPres = new Presentation("CloneToAnotherPresentationWithMaster.pptx"))
{
// Instancier la classe Presentation pour la présentation de destination (où la diapositive doit être clonée)
using (Presentation destPres = new Presentation())
{
// Instancier ISlide à partir de la collection de diapositives de la présentation source ainsi que
// la diapositive maître
ISlide SourceSlide = srcPres.Slides[0];
IMasterSlide SourceMaster = SourceSlide.LayoutSlide.MasterSlide;
// Cloner la diapositive maître souhaitée de la présentation source vers la collection de maîtres de la
// présentation de destination
IMasterSlideCollection masters = destPres.Masters;
IMasterSlide DestMaster = SourceSlide.LayoutSlide.MasterSlide;
// Cloner la diapositive maître souhaitée de la présentation source vers la collection de maîtres de la
// présentation de destination
IMasterSlide iSlide = masters.AddClone(SourceMaster);
// Cloner la diapositive souhaitée de la présentation source avec le maître désiré à la fin de la
// collection de diapositives de la présentation de destination
ISlideCollection slds = destPres.Slides;
slds.AddClone(SourceSlide, iSlide, true);
// Cloner la diapositive maître souhaitée de la présentation source vers la collection de maîtres de la // présentation de destination
// Enregistrer la présentation de destination sur le disque
destPres.Save("CloneToAnotherPresentationWithMaster_out.pptx", SaveFormat.Pptx);
}
}
Cloner une diapositive à la fin d’une section spécifiée
Avec Aspose.Slides for .NET, vous pouvez cloner une diapositive d’une section d’une présentation et insérer cette diapositive dans une autre section de la même présentation. Dans ce cas, vous devez utiliser la méthode AddClone de l’interface ISlideCollection.
Ce code C# montre comment cloner une diapositive et insérer la diapositive clonée dans une section spécifiée :
using (Presentation pres = new Presentation())
{
ISlide slide = pres.Slides.AddEmptySlide(pres.Slides[0].LayoutSlide);
slide.Shapes.AddAutoShape(ShapeType.Ellipse, 150, 150, 100, 100); // à cloner
ISlide slide2 = pres.Slides.AddEmptySlide(pres.Slides[0].LayoutSlide);
ISection section = pres.Sections.AddSection("Section2", slide2);
pres.Slides.AddClone(slide, section);
pres.Save("pres.pptx", SaveFormat.Pptx);
}
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 du graphique, son formatage et les données intégrées sont copiés. Si le graphique était lié à une source externe (par ex., 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.