Accéder aux diapositives de présentation en .NET

Aspose.Slides vous permet d’accéder aux diapositives de deux manières : par index et par ID.

Accéder à une diapositive par index

Toutes les diapositives d’une présentation sont organisées numériquement en fonction de leur position, à partir de 0. La première diapositive est accessible via l’index 0 ; la deuxième via l’index 1 ; etc.

La classe Presentation, qui représente un fichier de présentation, expose toutes les diapositives sous forme de collection ISlideCollection (collection d’objets ISlide ). Ce code C# vous montre comment accéder à une diapositive par son index :

// Instancie un objet Presentation qui représente un fichier de présentation
Presentation presentation = new Presentation("AccessSlides.pptx");

// Obtient la référence d'une diapositive via son index
ISlide slide = presentation.Slides[0];

Accéder à une diapositive par ID

Chaque diapositive d’une présentation possède un ID unique. Vous pouvez utiliser la méthode GetSlideById (exposée par la classe Presentation) pour cibler cet ID. Ce code C# montre comment fournir un ID de diapositive valide et accéder à cette diapositive via la méthode GetSlideById :

// Instancie un objet Presentation qui représente un fichier de présentation
Presentation presentation = new Presentation("AccessSlides.pptx");

// Obtient l'ID d'une diapositive
uint id = presentation.Slides[0].SlideId;

// Accède à la diapositive via son ID
IBaseSlide slide = presentation.GetSlideById(id);

Modifier la position d’une diapositive

Aspose.Slides vous permet de modifier la position d’une diapositive. Par exemple, vous pouvez spécifier que la première diapositive devienne la deuxième.

1. Créez une instance de la classe Presentation.
2. Obtenez la référence de la diapositive (dont vous voulez modifier la position) via son index
3. Définissez une nouvelle position pour la diapositive via la propriété SlideNumber.
4. Enregistrez la présentation modifiée.

Ce code C# montre une opération où la diapositive en position 1 est déplacée vers la position 2 :

// Crée une instance d'un objet Presentation qui représente un fichier de présentation
using (Presentation pres = new Presentation("ChangePosition.pptx"))
{
    // Obtient la diapositive dont la position sera modifiée
    ISlide sld = pres.Slides[0];

    // Définit la nouvelle position pour la diapositive
    sld.SlideNumber = 2;

    // Enregistre la présentation modifiée
    pres.Save("Aspose_out.pptx", SaveFormat.Pptx);
}

La première diapositive est devenue la deuxième ; la deuxième est devenue la première. Lorsque vous modifiez la position d’une diapositive, les autres diapositives sont automatiquement réajustées.

Définir le numéro de la diapositive

En utilisant la propriété FirstSlideNumber (exposée par la classe Presentation), vous pouvez spécifier un nouveau numéro pour la première diapositive d’une présentation. Cette opération entraîne le recalcul des numéros des autres diapositives.

1. Créez une instance de la classe Presentation.
2. Obtenez le numéro de la diapositive.
3. Définissez le numéro de la diapositive.
4. Enregistrez la présentation modifiée.

Ce code C# montre une opération où le numéro de la première diapositive est fixé à 10 :

// Instancie un objet Presentation qui représente un fichier de présentation
using (Presentation presentation = new Presentation("HelloWorld.pptx"))
{
    // Obtient le numéro de la diapositive
    int firstSlideNumber = presentation.FirstSlideNumber;

    // Définit le numéro de la diapositive
    presentation.FirstSlideNumber=10;
    
    // Enregistre la présentation modifiée
    presentation.Save("Set_Slide_Number_out.pptx", SaveFormat.Pptx);
}

Si vous préférez ignorer la première diapositive, vous pouvez démarrer la numérotation à partir de la deuxième diapositive (et masquer la numérotation de la première) de la façon suivante :

using (var presentation = new Presentation())
{
    var layoutSlide = presentation.LayoutSlides.GetByType(SlideLayoutType.Blank);
    presentation.Slides.AddEmptySlide(layoutSlide);
    presentation.Slides.AddEmptySlide(layoutSlide);
    presentation.Slides.AddEmptySlide(layoutSlide);

    // Définit le numéro de la première diapositive de la présentation
    presentation.FirstSlideNumber = 0;

    // Affiche les numéros de diapositives pour toutes les diapositives
    presentation.HeaderFooterManager.SetAllSlideNumbersVisibility(true);

    // Masque le numéro de diapositive pour la première diapositive
    presentation.Slides[0].HeaderFooterManager.SetSlideNumberVisibility(false);

    // Enregistre la présentation modifiée
    presentation.Save("output.pptx", SaveFormat.Pptx);
}

FAQ

Le numéro de diapositive affiché à l’utilisateur correspond-il à l’index basé sur zéro de la collection ?

Le numéro affiché sur une diapositive peut commencer à une valeur arbitraire (par ex. 10) et n’a pas besoin de correspondre à l’index ; la relation est contrôlée par le paramètre first slide number de la présentation.

Les diapositives cachées affectent-elles l’indexation ?

Oui. Une diapositive cachée reste dans la collection et est comptée dans l’indexation ; « cachée » se réfère à l’affichage, pas à sa position dans la collection.

L’index d’une diapositive change-t-il lorsque d’autres diapositives sont ajoutées ou supprimées ?

Oui. Les index reflètent toujours l’ordre actuel des diapositives et sont recalculés lors des opérations d’insertion, de suppression et de déplacement.