Πρόσβαση στις Διαφάνειες Παρουσίασης σε PHP

Επισκόπηση

Αυτό το άρθρο εξηγεί πώς να προσπελάζετε και να διαχειρίζεστε διαφάνειες σε μια παρουσίαση χρησιμοποιώντας το Aspose.Slides. Δείχνει πώς να ανακτήσετε διαφάνειες με βάση τον μηδενικό δείκτη τους από τη συλλογή διαφανειών και πώς να προσπελάσετε μια διαφάνεια με το μοναδικό της αναγνωριστικό χρησιμοποιώντας τη μέθοδο getSlideById.

Θα μάθετε επίσης πώς να αλλάζετε τη θέση μιας διαφάνειας χρησιμοποιώντας τη μέθοδο setSlideNumber και πώς να ορίζετε τον αριθμό εκκίνησης της πρώτης διαφάνειας για μια παρουσίαση με τη μέθοδο setFirstSlideNumber. Τα παραδείγματα δείχνουν τη φόρτωση μιας παρουσίασης, την απόκτηση αναφορών σε διαφάνειες, την ενημέρωση της σειράς ή της αρίθμησης των διαφανειών και την αποθήκευση της τροποποιημένης παρουσίασης.

Πρόσβαση σε διαφάνεια με δείκτη

Όλες οι διαφάνειες σε μια παρουσίαση είναι αριθμημένες βάσει της θέσης της διαφάνειας, ξεκινώντας από το 0. Η πρώτη διαφάνεια είναι προσβάσιμη μέσω του δείκτη 0· η δεύτερη διαφάνεια μέσω του δείκτη 1· κ.ο.κ.

Η κλάση Presentation, η οποία αντιπροσωπεύει ένα αρχείο παρουσίασης, εκθέτει όλες τις διαφάνειες ως μια συλλογή SlideCollection (συλλογή αντικειμένων Slide). Αυτός ο κώδικας PHP δείχνει πώς να προσπελάσετε μια διαφάνεια μέσω του δείκτη της:

  # Δημιουργεί ένα αντικείμενο Presentation που αντιπροσωπεύει ένα αρχείο παρουσίασης
  $pres = new Presentation("demo.pptx");
  try {
    # Προσπελαύνει μια διαφάνεια χρησιμοποιώντας το δείκτη της διαφάνειας
    $slide = $pres->getSlides()->get_Item(0);
  } finally {
    $pres->dispose();
  }

Πρόσβαση σε διαφάνεια με ID

Κάθε διαφάνεια σε μια παρουσίαση έχει ένα μοναδικό ID. Μπορείτε να χρησιμοποιήσετε τη μέθοδο getSlideById (που εκτίθεται από την κλάση Presentation) για να προσδιορίσετε αυτό το ID. Αυτός ο κώδικας PHP δείχνει πώς να παρέχετε ένα έγκυρο ID διαφάνειας και να προσπελάσετε τη διαφάνεια μέσω της μεθόδου getSlideById:

  # Δημιουργεί ένα αντικείμενο Presentation που αντιπροσωπεύει ένα αρχείο παρουσίασης
  $pres = new Presentation("demo.pptx");
  try {
    # Λαμβάνει το ID μιας διαφάνειας
    $id = $pres->getSlides()->get_Item(0)->getSlideId();
    # Προσπελαύνει τη διαφάνεια μέσω του ID της
    $slide = $pres->getSlideById($id);
  } finally {
    $pres->dispose();
  }

Αλλαγή θέσης διαφάνειας

Το Aspose.Slides σας επιτρέπει να αλλάζετε τη θέση μιας διαφάνειας. Για παράδειγμα, μπορείτε να ορίσετε ότι η πρώτη διαφάνεια πρέπει να γίνει η δεύτερη διαφάνεια.

Δημιουργήστε μια παρουσία της κλάσης Presentation.
Αποκτήστε την αναφορά της διαφάνειας (της οποίας τη θέση θέλετε να αλλάξετε) μέσω του δείκτη της.
Ορίστε μια νέα θέση για τη διαφάνεια μέσω της μεθόδου setSlideNumber.
Αποθηκεύστε την τροποποιημένη παρουσίαση.

Αυτός ο κώδικας PHP επιδεικνύει μια λειτουργία όπου η διαφάνεια στη θέση 1 μετακινείται στη θέση 2:

  # Δημιουργεί ένα αντικείμενο Presentation που αντιπροσωπεύει ένα αρχείο παρουσίασης
  $pres = new Presentation("Presentation.pptx");
  try {
    # Λαμβάνει τη διαφάνεια της οποίας η θέση θα αλλάξει
    $sld = $pres->getSlides()->get_Item(0);
    # Ορίζει τη νέα θέση για τη διαφάνεια
    $sld->setSlideNumber(2);
    # Αποθηκεύει την τροποποιημένη παρουσίαση
    $pres->save("helloworld_Pos.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Η πρώτη διαφάνεια έγινε δεύτερη· η δεύτερη διαφάνεια έγινε πρώτη. Όταν αλλάζετε τη θέση μιας διαφάνειας, οι άλλες διαφάνειες ρυθμίζονται αυτόματα.

Ορισμός αριθμού διαφάνειας

Χρησιμοποιώντας τη μέθοδο setFirstSlideNumber (που εκτίθεται από την κλάση Presentation), μπορείτε να ορίσετε έναν νέο αριθμό για την πρώτη διαφάνεια σε μια παρουσίαση. Η λειτουργία αυτή προκαλεί τον επαναϋπολογισμό των αριθμών των υπόλοιπων διαφανειών.

Δημιουργήστε μια παρουσία της κλάσης Presentation.
Αποκτήστε τον αριθμό της διαφάνειας.
Ορίστε τον αριθμό της διαφάνειας.
Αποθηκεύστε την τροποποιημένη παρουσίαση.

Αυτός ο κώδικας PHP δείχνει μια λειτουργία όπου ο αριθμός της πρώτης διαφάνειας ορίζεται σε 10:

  # Δημιουργεί ένα αντικείμενο Presentation που αντιπροσωπεύει ένα αρχείο παρουσίασης
  $pres = new Presentation("HelloWorld.pptx");
  try {
    # Λαμβάνει τον αριθμό της διαφάνειας
    $firstSlideNumber = $pres->getFirstSlideNumber();
    # Ορίζει τον αριθμό της διαφάνειας
    $pres->setFirstSlideNumber(10);
    # Αποθηκεύει την τροποποιημένη παρουσίαση
    $pres->save("Set_Slide_Number_out.pptx", SaveFormat::Pptx);
  } finally {
    $pres->dispose();
  }

Εάν προτιμάτε να παραλείψετε την πρώτη διαφάνεια, μπορείτε να ξεκινήσετε την αρίθμηση από τη δεύτερη διαφάνεια (και να κρύψετε την αρίθμηση για την πρώτη) ως εξής:

  $presentation = new Presentation();
  try {
    $layoutSlide = $presentation->getLayoutSlides()->getByType(SlideLayoutType::Blank);
    $presentation->getSlides()->addEmptySlide($layoutSlide);
    $presentation->getSlides()->addEmptySlide($layoutSlide);
    $presentation->getSlides()->addEmptySlide($layoutSlide);
    # Ορίζει τον αριθμό για την πρώτη διαφάνεια της παρουσίασης
    $presentation->setFirstSlideNumber(0);
    # Εμφανίζει τους αριθμούς διαφανειών για όλες τις διαφάνειες
    $presentation->getHeaderFooterManager()->setAllSlideNumbersVisibility(true);
    # Αποκρύπτει τον αριθμό διαφάνειας για την πρώτη διαφάνεια
    $presentation->getSlides()->get_Item(0)->getHeaderFooterManager()->setSlideNumberVisibility(false);
    # Αποθηκεύει την τροποποιημένη παρουσίαση
    $presentation->save("output.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($presentation)) {
      $presentation->dispose();
    }
  }

ΣΥΧΝΑ ΕΡΩΤΗΜΑΤΑ

Ταιριάζει ο αριθμός της διαφάνειας που βλέπει ο χρήστης με τον μηδενικό δείκτη της συλλογής;

Ο αριθμός που εμφανίζεται σε μια διαφάνεια μπορεί να ξεκινά από μια αυθαίρετη τιμή (π.χ., 10) και δεν χρειάζεται να ταιριάζει με τον δείκτη· η σχέση ελέγχεται από τη ρύθμιση πρώτου αριθμού διαφάνειας της παρουσίασης.

Επηρεάζουν οι κρυμμένες διαφάνειες την αρίθμηση;

Ναι. Μια κρυμμένη διαφάνεια παραμένει στη συλλογή και μετράται στην αρίθμηση· το «κρυμμένο» αφορά την εμφάνιση, όχι τη θέση στη συλλογή.

Αλλάζει ο δείκτης μιας διαφάνειας όταν προστίθενται ή αφαιρούνται άλλες διαφάνειες;

Ναι. Οι δείκτες πάντα αντανακλούν την τρέχουσα σειρά στις διαφάνειες και επανυπολογίζονται κατά τις λειτουργίες εισαγωγής, διαγραφής και μετακίνησης.

Προσθήκη Διαφανειών σε Παρουσιάσεις σε PHP Αφαίρεση Διαφανειών από Παρουσιάσεις σε PHP