Accéder aux diapositives de présentation en PHP

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

Accéder à une diapositive par indice

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’indice 0 ; la seconde via l’indice 1 ; etc.

La classe Presentation, qui représente un fichier de présentation, expose toutes les diapositives sous forme d’une collection SlideCollection (collection d’objets Slide). Ce code PHP montre comment accéder à une diapositive par son indice :

  # Instancie un objet Presentation qui représente un fichier de présentation
  $pres = new Presentation("demo.pptx");
  try {
    # Accède à une diapositive en utilisant son indice
    $slide = $pres->getSlides()->get_Item(0);
  } finally {
    $pres->dispose();
  }

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 PHP 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
  $pres = new Presentation("demo.pptx");
  try {
    # Obtient l'ID d'une diapositive
    $id = $pres->getSlides()->get_Item(0)->getSlideId();
    # Accède à la diapositive via son ID
    $slide = $pres->getSlideById($id);
  } finally {
    $pres->dispose();
  }

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 seconde.

1. Créez une instance de la classe Presentation.
2. Obtenez la référence de la diapositive (dont vous souhaitez changer la position) via son indice
3. Définissez une nouvelle position pour la diapositive à l’aide de la méthode setSlideNumber.
4. Enregistrez la présentation modifiée.

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

  # Instancie un objet Presentation qui représente un fichier de présentation
  $pres = new Presentation("Presentation.pptx");
  try {
    # Obtient la diapositive dont la position sera modifiée
    $sld = $pres->getSlides()->get_Item(0);
    # Définit la nouvelle position de la diapositive
    $sld->setSlideNumber(2);
    # Enregistre la présentation modifiée
    $pres->save("helloworld_Pos.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

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

Définir le numéro de diapositive

En utilisant la méthode setFirstSlideNumber (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 PHP 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
  $pres = new Presentation("HelloWorld.pptx");
  try {
    # Obtient le numéro de la diapositive
    $firstSlideNumber = $pres->getFirstSlideNumber();
    # Définit le numéro de la diapositive
    $pres->setFirstSlideNumber(10);
    # Enregistre la présentation modifiée
    $pres->save("Set_Slide_Number_out.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

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) comme suit :

  $presentation = new Presentation();
  try {
    $layoutSlide = $presentation->getLayoutSlides()->getByType(SlideLayoutType::Blank);
    $presentation->getSlides()->addEmptySlide($layoutSlide);
    $presentation->getSlides()->addEmptySlide($layoutSlide);
    $presentation->getSlides()->addEmptySlide($layoutSlide);
    # Définit le numéro de la première diapositive de la présentation
    $presentation->setFirstSlideNumber(0);
    # Affiche les numéros de diapositive pour toutes les diapositives
    $presentation->getHeaderFooterManager()->setAllSlideNumbersVisibility(true);
    # Masque le numéro de diapositive pour la première diapositive
    $presentation->getSlides()->get_Item(0)->getHeaderFooterManager()->setSlideNumberVisibility(false);
    # Enregistre la présentation modifiée
    $presentation->save("output.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

FAQ

Le numéro de diapositive affiché à l’utilisateur correspond‑il à l’indice zéro‑based 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’indice ; la relation est contrôlée par le paramètre first slide number de la présentation.

Les diapositives masquées affectent‑elles l’indexation ?

Oui. Une diapositive masquée reste dans la collection et est comptée dans l’indexation ; « masquée » fait référence à l’affichage, pas à sa position dans la collection.

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

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