Διαχείριση Υπερσυνδέσμων Παρουσίασης σε PHP
Εισαγωγή
Ένας υπερσύνδεσμος συνδέει το περιεχόμενο της παρουσίασης με έναν ιστότοπο ή μια τοποθεσία εντός της παρουσίασης. Στο PowerPoint, οι υπερσύνδεσμοι συνήθως εξυπηρετούν δύο σκοπούς:
- Άνοιγμα ενός ιστότοπου από κείμενο, σχήμα ή πλαίσιο πολυμέσων.
- Πλοήγηση σε άλλη διαφάνεια, για παράδειγμα, από πίνακα περιεχομένων.
Το Aspose.Slides for PHP μέσω Java σάς επιτρέπει να προσθέσετε αυτούς τους συνδέσμους, να ελέγξετε την εμφάνιση και τον ήχο τους, να ενημερώσετε τις ιδιότητές τους και να τους αφαιρέσετε. Τα παραδείγματα παρακάτω δείχνουν πώς να δουλέψετε με υπερσυνδέσμους σε μεμονωμένα στοιχεία και πώς να αποκτήσετε πρόσβαση σε υπερσυνδέσμους σε επίπεδο παρουσίασης, διαφάνειας ή πλαισίου κειμένου. Υποθέτουν ότι το PHP/Java Bridge και το wrapper Aspose.Slides PHP έχουν αρχικοποιηθεί. Τα μέλη του API χωρίς σελίδα αναφοράς PHP συνδέονται με το υποκείμενο Java API.
Note
Μπορείτε επίσης να επεξεργαστείτε παρουσιάσεις με τον δωρεάν διαδικτυακό επεξεργαστή Aspose PowerPoint.Προσθήκη υπερσυνδέσμων URL
Μπορείτε να αντιστοιχίσετε μια διεύθυνση URL ιστοτόπου σε κείμενο, σχήμα ή πλαίσιο πολυμέσων. Το στοιχείο στο οποίο αντιστοιχίζετε τον υπερσύνδεσμο καθορίζει την περιοχή που μπορεί να κάνει κλικ: ένα τμήμα κειμένου συνδέει το επιλεγμένο κείμενο, ενώ ένα σχήμα ή πλαίσιο συνδέει το αντικείμενο της διαφάνειας.
Για παρουσιάσεις που περιέχουν σχετικούς υπερσυνδέσμους, δείτε Διαχείριση της βάσης υπερσύνδεσμου για να διαβάσετε, να αλλάξετε ή να διαγράψετε τη βάση σε επίπεδο εγγράφου.
Προσθήκη υπερσυνδέσμων URL σε κείμενο
Για να συνδέσετε κείμενο με έναν ιστότοπο, περάστε ένα Hyperlink στη μέθοδο setHyperlinkClick του τμήματος κειμένου, όπως φαίνεται παρακάτω. Μόνο αυτό το τμήμα κειμένου γίνεται κλικ-δυνατό.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$textShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50, false);
$textShape->addTextFrame("Aspose: File Format APIs");
$portionFormat = $textShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$portionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$portionFormat->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");
$portionFormat->setFontHeight(32);
$presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Προσθήκη υπερσυνδέσμων URL σε σχήματα και πλαίσια πολυμέσων
Καλέστε τη setHyperlinkClick στο ορθογώνιο για να γίνει ολόκληρη η περιοχή του κλικ-δυνατή. Χρησιμοποιήστε τη setTooltip για να δείξετε στους αναγνώστες μια υπόδειξη σχετικά με τον προορισμό όταν τοποθετούν τον κέρσορα πάνω στο ορθογώνιο. Και οι δύο μέθοδοι ισχύουν επίσης για πλαίσια εικόνας, ήχου και βίντεο.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$shape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50);
$shape->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$shape->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");
$presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Χρήση υπερσυνδέσμων για δημιουργία πίνακα περιεχομένων
Οι εσωτερικοί υπερσύνδεσμοι επιτρέπουν στους αναγνώστες να μεταβούν από έναν πίνακα περιεχομένων σε συγκεκριμένη διαφάνεια. Το παρακάτω παράδειγμα χρησιμοποιεί τη setInternalHyperlinkClick για να συνδέσει το κείμενο “Page 2” στην πρώτη διαφάνεια με τη δεύτερη διαφάνεια.
use aspose\slides\FillType;
use aspose\slides\Paragraph;
use aspose\slides\Portion;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$firstSlide = $presentation->getSlides()->get_Item(0);
$secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());
$tableOfContents = $firstSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 40, 40, 300, 100);
$tableOfContents->getFillFormat()->setFillType(FillType::NoFill);
$tableOfContents->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
$tableOfContents->getTextFrame()->getParagraphs()->clear();
$paragraph = new Paragraph();
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
$paragraph->setText("Title of slide 2 .......... ");
$linkPortion = new Portion();
$linkPortion->setText("Page 2");
$linkPortion->getPortionFormat()->getHyperlinkManager()->setInternalHyperlinkClick($secondSlide);
$paragraph->getPortions()->add($linkPortion);
$tableOfContents->getTextFrame()->getParagraphs()->add($paragraph);
$presentation->save("link_to_slide.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Μορφοποίηση υπερσυνδέσμων
Μπορείτε να αλλάξετε το χρώμα του συνδεδεμένου κειμένου, να αναπαράγετε ή να σταματήσετε έναν ήχο όταν ένας αναγνώστης ενεργοποιεί έναν σύνδεσμο, και να ορίσετε το tooltip που εμφανίζεται όταν ο κέρσορας περνά από πάνω.
Χρώμα
Η μέθοδος setColorSource του Hyperlink καθορίζει εάν ένας υπερσύνδεσμος χρησιμοποιεί το χρώμα υπερσύνδεσμου της παρουσίασης ή τη μορφοποίηση του τμήματος κειμένου. Για να εφαρμόσετε προσαρμοσμένο χρώμα κειμένου, επιλέξτε HyperlinkColorSource::PortionFormat και ορίστε το χρώμα γεμίσματος του τμήματος. Αυτή η δυνατότητα εισήχθη στο PowerPoint 2019· οι παλαιότερες εκδόσεις δεν εφαρμόζουν αυτή τη ρύθμιση.
Σε αυτό το παράδειγμα, η setColorSource κάνει τον πρώτο σύνδεσμο να χρησιμοποιεί το κόκκινο γέμισμα του τμήματος κειμένου. Ο δεύτερος σύνδεσμος διατηρεί το χρώμα υπερσύνδεσμου της παρουσίασης.
use aspose\slides\FillType;
use aspose\slides\Hyperlink;
use aspose\slides\HyperlinkColorSource;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$coloredShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 450, 50, false);
$coloredShape->addTextFrame("This hyperlink uses a custom color.");
$coloredPortionFormat = $coloredShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$coloredPortionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$coloredPortionFormat->getHyperlinkClick()->setColorSource(HyperlinkColorSource::PortionFormat);
$coloredPortionFormat->getFillFormat()->setFillType(FillType::Solid);
$coloredPortionFormat->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
$defaultShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 450, 50, false);
$defaultShape->addTextFrame("This hyperlink uses the default color.");
$defaultShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$presentation->save("presentation-out-hyperlink.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Ήχος
Ένας υπερσύνδεσμος μπορεί να αναπαράγει ήχο όταν ενεργοποιείται ή να σταματήσει ήχο που ήδη παίζει. Χρησιμοποιήστε τις ακόλουθες μεθόδους για να ρυθμίσετε αυτές τις συμπεριφορές:
- Hyperlink::setSound καθορίζει τον ήχο που σχετίζεται με τον υπερσύνδεσμο.
- Hyperlink::setStopSoundOnClick ελέγχει εάν η ενεργοποίηση του υπερσυνδέσμου σταματά τον προηγούμενο ήχο.
Προσθήκη ήχου υπερσύνδεσμου
Το κουμπί στην πρώτη διαφάνεια χρησιμοποιεί το Hyperlink::setSound για να αναπαράγει ήχο από sampleaudio.wav όταν ο αναγνώστης κάνει κλικ για προχώρηση. Στη δεύτερη διαφάνεια, ένα ξεχωριστό κουμπί χρησιμοποιεί το Hyperlink::setStopSoundOnClick για να σταματήσει την αναπαραγωγή και να κρατήσει τον αναγνώστη σε εκείνη τη διαφάνεια.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$audioFile = new Java("java.io.File", "sampleaudio.wav");
$audioPath = $audioFile->toPath();
$audioData = java("java.nio.file.Files")->readAllBytes($audioPath);
$hyperlinkSound = $presentation->getAudios()->addAudio($audioData);
$firstSlide = $presentation->getSlides()->get_Item(0);
$playButton = $firstSlide->getShapes()->addAutoShape(ShapeType::SoundButton, 100, 100, 100, 50);
$playButton->setHyperlinkClick(Hyperlink::getNextSlide());
if (!java_values($playButton->getHyperlinkClick()->getStopSoundOnClick()) && java_is_null($playButton->getHyperlinkClick()->getSound()))
{
$playButton->getHyperlinkClick()->setSound($hyperlinkSound);
}
$secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());
$stopButton = $secondSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 100, 50);
$stopButton->setHyperlinkClick(Hyperlink::getNoAction());
$stopButton->getHyperlinkClick()->setStopSoundOnClick(true);
$presentation->save("hyperlink-sound.pptx", SaveFormat::Pptx);
} catch (JavaException $exception) {
echo "Unable to read the audio file: " . $exception->getMessage() . PHP_EOL;
} finally {
$presentation->dispose();
}
Εξαγωγή ήχου υπερσύνδεσμου
Το παρακάτω παράδειγμα ανοίγει την παρουσίαση που δημιουργήθηκε παραπάνω και διαβάζει τον ήχο του πρώτου σχήματος στο μνήμη μέσω getSound και getBinaryData.
use aspose\slides\Presentation;
$presentation = new Presentation("hyperlink-sound.pptx");
try {
if (java_values($presentation->getSlides()->size()) > 0 && java_values($presentation->getSlides()->get_Item(0)->getShapes()->size()) > 0) {
$hyperlink = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getHyperlinkClick();
$sound = java_is_null($hyperlink) ? null : $hyperlink->getSound();
if (!java_is_null($sound)) {
$audioData = $sound->getBinaryData();
echo "Extracted " . strlen(java_values($audioData)) . " bytes of hyperlink audio." . PHP_EOL;
} else {
echo "The first shape has no hyperlink sound." . PHP_EOL;
}
} else {
echo "The presentation has no first slide or shape to inspect." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
Ρυθμίσεις Tooltip και Αλληλεπίδρασης
Μπορείτε να καλέσετε τις παρακάτω μεθόδους του Hyperlink μετά την ανάθεση ενός υπερσυνδέσμου σε κείμενο ή σχήμα:
- setTooltip ορίζει το κείμενο που μπορεί να εμφανίσει ένας θεατής ως υπόδειξη για το σύνδεσμο.
- setTargetFrame καθορίζει το πλαίσιο‑στόχο εντός ενός γονικού HTML frameset, όταν είναι εφαρμόσιμο.
- setHistory ελέγχει εάν η ενεργοποίηση του συνδέσμου προσθέτει τον προορισμό του στη λίστα των προβληθέντων υπερσυνδέσμων.
- setHighlightClick ελέγχει εάν ο υπερσύνδεσμος επισημαίνεται όταν γίνει κλικ.
Αφαίρεση υπερσυνδέσμων από παρουσιάσεις
Χρησιμοποιήστε το getAnyHyperlinks για να συλλέξετε containers υπερσυνδέσμων, συμπεριλαμβανομένων των συνδέσμων τμημάτων κειμένου, πριν τα αλλάξετε. Το παρακάτω παράδειγμα αφαιρεί και τους δύο τύπους ενεργοποίησης από την πρώτη διαφάνεια. Για να αφαιρέσετε μόνο έναν τύπο, καλέστε μόνο το removeHyperlinkClick ή το removeHyperlinkMouseOver; η αφαίρεση μιας ενέργειας κλικ δεν αφαιρεί την αντίστοιχη ενέργεια mouse‑over.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("pres.pptx");
try {
if (java_values($presentation->getSlides()->size()) > 0) {
$containers = [];
foreach ($presentation->getSlides()->get_Item(0)->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
$containers[] = $container;
}
foreach ($containers as $container) {
$container->getHyperlinkManager()->removeHyperlinkClick();
$container->getHyperlinkManager()->removeHyperlinkMouseOver();
}
$presentation->save("pres-removed-hyperlinks.pptx", SaveFormat::Pptx);
} else {
echo "The presentation has no slides to process." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
Για αφαίρεση χωρίς προϋποθέσεις, το removeAllHyperlinks αφαιρεί και τους δύο τύπους ενεργοποίησης στην επιλεγμένη περιοχή με μία κλήση. Για επιλεκτικό καθαρισμό και κάλυψη masters, layouts και notes, δείτε Αναφορά, Καθαρισμός και Επαλήθευση Υπερσυνδέσμων.
Καθαρισμός υπερσυνδέσμων πριν την αντικατάσταση κειμένου SmartArt
Όταν αντικαθιστάτε μια παράγραφο σε έναν υπάρχοντα κόμβο SmartArt, ο καθαρισμός των τμημάτων κειμένου του μπορεί να αφήσει έναν παλιό υπερσύνδεσμο ενεργό. Ανακτήστε την παράγραφο μέσω SmartArtNode::getTextFrame. Πριν καθαρίσετε τα τμήματά της, καλέστε το getHyperlinkQueries στο πλαίσιο κειμένου του σχήματος του κόμβου που εμφανίζει την παράγραφο, στη συνέχεια καλέστε το removeAllHyperlinks στο επιστρεφόμενο αντικείμενο. Αυτό αφαιρεί κάθε υπερσύνδεσμο σε εκείνο το πλαίσιο, συμπεριλαμβανομένων των συνδέσμων στα άλλα τμήματα κειμένου.
Το παράδειγμα υποθέτει ότι το τρίτο σχήμα στην πρώτη διαφάνεια του SmartArtHyperlink.pptx είναι γραφικό SmartArt. Αντικαθιστά την πρώτη παράγραφο του τέταρτου κόμβου. Στην παρουσίαση αυτή, το πρώτο σχήμα του κόμβου εμφανίζει εκείνη την παράγραφο.
Μετά την προσθήκη και των δύο τμημάτων, το παράδειγμα διαβάζει τη θετική μορφοποίηση τους με το getEffective. Σε αυτή τη μορφοποίηση, το getHyperlinkClick επιστρέφει τον νέο υπερσύνδεσμο για το πρώτο τμήμα και null για το δεύτερο.
use aspose\slides\Hyperlink;
use aspose\slides\Portion;
use aspose\slides\Presentation;
$presentation = new Presentation("SmartArtHyperlink.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$smartArt = $slide->getShapes()->get_Item(2);
$node = $smartArt->getAllNodes()->get_Item(3);
$paragraph = $node->getTextFrame()->getParagraphs()->get_Item(0);
$node->getShapes()->get_Item(0)->getTextFrame()->getHyperlinkQueries()->removeAllHyperlinks();
$paragraph->getPortions()->clear();
$link = new Portion("New reference");
$link->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://example.com/new"));
$paragraph->getPortions()->add($link);
$text = new Portion(" (updated)");
$paragraph->getPortions()->add($text);
echo java_values($link->getPortionFormat()->getEffective()->getHyperlinkClick()->getExternalUrl()), PHP_EOL; // https://example.com/new
var_dump(java_is_null($text->getPortionFormat()->getEffective()->getHyperlinkClick())); // bool(true): το δεύτερο τμήμα δεν έχει υπερσύνδεσμο.
} finally {
$presentation->dispose();
}
Δημιουργία πλήρους απογραφής υπερσυνδέσμων
Πριν διανείμετε μια παρουσίαση, κάντε απογραφή των διαδραστικών ενεργειών της καθώς και των web συνδέσμων της. Το getAnyHyperlinks επιστρέφει αντικείμενα IHyperlinkContainer, όχι μια επίπεδη λίστα αλφαριθμητικών URL. Εξετάστε τόσο τα getHyperlinkClick όσο και τα getHyperlinkMouseOver σε κάθε container. Είναι ανεξάρτητα: το ίδιο container μπορεί να εκθέτει και τις δύο ενέργειες, έτσι μια πλήρης αναφορά χρειάζεται έως δύο σειρές ανά container.
Η σάρωση μόνο των υπερσυνδέσμων σε επίπεδο σχήματος μπορεί να χάσει συνδέσμους που είναι προσυνημένα σε τμήματα κειμένου. Ερωτήστε την κατάλληλη περιοχή αντί γι’ αυτό και κρατήστε τα επιστρεφόμενα containers ώστε να μπορείτε αργότερα να ενημερώσετε ή να αφαιρέσετε τις ενέργειές τους.
Ερώτηση περιοχών Παρουσίασης, Διαφάνειας και Πλαισίου Κειμένου
Η κλάση HyperlinkQueries είναι διαθέσιμη μέσω Presentation::getHyperlinkQueries, IBaseSlide::getHyperlinkQueries και TextFrame::getHyperlinkQueries. Κάθε περιοχή υποστηρίζει τις ίδιες ερωτήσεις:
- getHyperlinkClicks επιστρέφει containers με ενέργεια κλικ.
- getHyperlinkMouseOvers επιστρέφει containers με ενέργεια mouse‑over.
- getAnyHyperlinks επιστρέφει containers με είτε ή και τις δύο ενέργειες.
Αυτό το παράδειγμα αναθέτει ενέργειες κλικ και mouse‑over σε σχήμα και το κείμενό του, και μια ενέργεια μακροεντολής σε ξεχωριστό κουμπί. Συγκρίνει τον αριθμό των containers που επιστρέφει το getAnyHyperlinks με τους μετρήσεις για κάθε τύπο ενεργοποίησης. Μια ερώτηση πλαισίου κειμένου μετρά μόνο συνδέσμους στο κείμενο. Οι δικές του ενέργειες του περιβάλλοντος σχήματος εμφανίζονται στις ερωτήσεις διαφάνειας και παρουσίασης.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
function printQueryCounts($scope, $queries) {
$clickCount = java_values($queries->getHyperlinkClicks()->size());
$mouseOverCount = java_values($queries->getHyperlinkMouseOvers()->size());
$anyCount = java_values($queries->getAnyHyperlinks()->size());
echo "$scope: click=$clickCount, mouse-over=$mouseOverCount, any=$anyCount" . PHP_EOL;
}
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$destination = $presentation->getSlides()->addEmptySlide($slide->getLayoutSlide());
$shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 20, 400, 60);
$shape->getTextFrame()->setText("Click the text to go to slide 2");
$shape->getHyperlinkManager()->setExternalHyperlinkClick("https://example.com/");
$shape->getHyperlinkClick()->setTooltip("Public website");
$shape->getHyperlinkManager()->setExternalHyperlinkMouseOver("file:///C:/private/report.xlsx");
$portionFormat = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$portionFormat->getHyperlinkManager()->setInternalHyperlinkClick($destination);
$portionFormat->getHyperlinkManager()->setExternalHyperlinkMouseOver("https://example.com/help");
$macroButton = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 120, 200, 60);
$macroButton->getHyperlinkManager()->setMacroHyperlinkClick("ReviewPresentation");
printQueryCounts("Presentation", $presentation->getHyperlinkQueries());
printQueryCounts("Slide 1", $slide->getHyperlinkQueries());
printQueryCounts("Text frame", $shape->getTextFrame()->getHyperlinkQueries());
$presentation->save("hyperlink-audit-input.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Για αυτό το παράδειγμα, οι ερωτήσεις παρουσίασης και διαφάνειας αναφέρουν τρία containers κλικ, δύο containers mouse‑over και τρία containers με οποιαδήποτε ενέργεια. Η ερώτηση πλαισίου κειμένου αναφέρει ένα container σε κάθε κατηγορία.
Κατηγοριοποίηση ενεργειών και προορισμών
Χρησιμοποιήστε το Hyperlink::getActionType για να ερμηνεύσετε μια ενέργεια πριν ερμηνεύσετε τον προορισμό της. Οι τιμές του HyperlinkActionType καλύπτουν περισσότερο από την πλοήγηση στον ιστό:
| Τιμές | Σημασία για έλεγχο |
|---|---|
Hyperlink |
Εξωτερικός υπερσύνδεσμος· ελέγξτε τη διεύθυνση URL και το σχήμα του. |
JumpSpecificSlide |
Εσωτερική πλοήγηση σε συγκεκριμένη διαφάνεια. |
JumpFirstSlide, JumpPreviousSlide, JumpNextSlide, JumpLastSlide, JumpLastViewedSlide |
Ενσωματωμένη πλοήγηση παρουσίασης, επιλύεται στο πλαίσιο παρουσίασης. |
JumpEndShow, StartCustomSlideShow |
Τερματισμός της τρέχουσας παρουσίασης ή εκκίνηση προσαρμοσμένης παρουσίασης. |
StartMacro |
Εκτέλεση μακροεντολής. |
StartProgram |
Εκκίνηση προγράμματος. |
OpenFile, OpenPresentation |
Άνοιγμα αρχείου ή άλλης παρουσίασης· εξετάστε ξεχωριστά από τις διευθύνσεις URL του web. |
StartStopMedia |
Έναρξη ή διακοπή αναπαραγωγής πολυμέσων. |
NoAction, Unknown |
Καμία ενέργεια πλοήγησης ή μη αναγνωρισμένη ενέργεια που απαιτεί έλεγχο. |
Διαβάστε εξωτερικούς προορισμούς από το getExternalUrl και συγκεκριμένους εσωτερικούς προορισμούς από το getTargetSlide. Οι εσωτερικές ενέργειες και οι ενσωματωμένες εντολές μπορεί να μην έχουν εξωτερική URL· μια κενή URL δεν σημαίνει ότι το container δεν έχει ενέργεια. Διατηρήστε την τιμή που επιστρέφει το getExternalUrlOriginal όταν διαφέρει από την κανονικοποιημένη URL, και συμπεριλάβετε το tooltip που επιστρέφει το getTooltip όταν είναι διαθέσιμο.
Αναφορά, Καθαρισμός και Επαλήθευση Υπερσυνδέσμων
Αυτό το παράδειγμα ανοίγει την παρουσίαση από το προηγούμενο παράδειγμα και γράφει μία εγγραφή JSON ανά ενέργεια. Χρησιμοποιεί το getAnyHyperlinks για να συλλέξει containers σε κανονικές διαφάνειες, masters, layouts και notes, συμπεριλαμβανομένων των masters σημειώσεων και handout όταν υπάρχουν. Χρησιμοποιεί ισοδυναμία αναφοράς για να μετρήσει κάθε container μία φορά, εφαρμόζει την παρακάτω πολιτική και ανοίγει ξανά την αποθηκευμένη παρουσίαση ώστε να ελέγξει και τις ενέργειες κλικ και mouse‑over.
Η αναφορά καταγράφει έναν δείκτη διαφάνειας 1‑βάσης και το getSlideId όπου είναι διαθέσιμο. Το ISlideComponent::getSlide παρέχει τη διαφάνεια ιδιοκτήτρια για τα υποστηριζόμενα containers. Τα masters, τα layouts και τα notes δεν έχουν κανονικό δείκτη διαφάνειας και τα αναγνωρίζουν ως περιοχή τους. Τα containers σχήματος και τα containers μορφοποίησης τμημάτων κειμένου επισημαίνονται ξεχωριστά· άλλοι τύποι containers διατηρούν το όνομα τύπου χρόνου εκτέλεσης. Κάθε container λαμβάνει ένα τοπικό ID αναφοράς ώστε οι δύο ενέργειές του να συσχετιστούν. Η αναφορά αποθηκεύει τους τύπους ενεργειών ως τους ακέραιους σταθερούς που ορίζονται από την PHP απαρίθμηση.
Αυτή η σκόπιμα περιοριστική πολιτική εφαρμογής επιτρέπει μόνο απόλυτες HTTPS URL και έγκυρους εσωτερικούς προορισμούς διαφάνειας. Απορρίπτει μακροεντολές, προγράμματα, ενέργειες αρχείων, άλλες ενέργειες παρουσίασης, άγνωστες ενέργειες και άλλες σχήμες URL. Αυτές οι απορρίψεις είναι αποφάσεις πολιτικής, όχι απόφαση ασφαλείας του Aspose.Slides. Το HTTPS μόνο δεν αποδεικνύει εμπιστοσύνη: προσθέστε λιστές επιτρεπόμενων κεντρικών υπολογιστών και άλλους ελέγχους για την εφαρμογή σας. Ελέγχονται τόσο οι αρχικές όσο και οι κανονικοποιημένες εξωτερικές URL. Το παράδειγμα ελέγχει μεταδεδομένα χωρίς να ακολουθεί συνδέσμους ή να εκτελεί ενέργειες.
Για αποκατάσταση, ο getHyperlinkManager του container υποστηρίζει setExternalHyperlinkClick, removeHyperlinkClick και removeHyperlinkMouseOver. Εδώ, οι απαγορευμένες εξωτερικές κλικ‑συνδέσεις αντικαθίστανται με μια σταθερή σελίδα προσγείωσης HTTPS· οι άλλες απαγορευμένες κλικ-συνδέσεις και οι απαγορευμένες ενέργειες mouse‑over αφαιρούνται ανεξάρτητα. Ορίστε το $replaceExternalClicks σε false για να αφαιρέσετε όλες τις παραβιάσεις πολιτικής. Επιλέξτε μια σελίδα αντικατάστασης που ανήκει στην εφαρμογή πριν την ανάπτυξη.
Η σημαία εξαγωγής της αναφοράς χρησιμοποιεί μια συντηρητική πολιτική ελέγχου PDF: σηματοδοτεί ενέργειες mouse‑over και οτιδήποτε εκτός ενός εξωτερικού συνδέσμου ή συγκεκριμένου άλματος διαφάνειας ως πιθανώς ανε-supported. Είναι μια υπόδειξη ελέγχου, όχι δοκιμή δυνατότητας ή εγγύηση ότι οι μη σημειωμένες συνδέσεις θα διατηρηθούν στην εξαγωγή. Οι υποστηριζόμενες εξαγωγές PDF και HTML μπορεί να διατηρήσουν υπερσυνδέσμους, ανάλογα με την ενέργεια, τις επιλογές εξαγωγής και τον θεατή. Τα ραστερ images και video δεν μπορούν να διατηρήσουν διαδραστικούς υπερσυνδέσμους· σημειώστε κάθε ενέργεια όταν ελέγχετε για αυτές τις εξόδους.
use aspose\slides\Hyperlink;
use aspose\slides\Portion;
use aspose\slides\Presentation;
$presentation = new Presentation("SmartArtHyperlink.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$smartArt = $slide->getShapes()->get_Item(2);
$node = $smartArt->getAllNodes()->get_Item(3);
$paragraph = $node->getTextFrame()->getParagraphs()->get_Item(0);
$node->getShapes()->get_Item(0)->getTextFrame()->getHyperlinkQueries()->removeAllHyperlinks();
$paragraph->getPortions()->clear();
$link = new Portion("New reference");
$link->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://example.com/new"));
$paragraph->getPortions()->add($link);
$text = new Portion(" (updated)");
$paragraph->getPortions()->add($text);
echo java_values($link->getPortionFormat()->getEffective()->getHyperlinkClick()->getExternalUrl()), PHP_EOL; // https://example.com/new
var_dump(java_is_null($text->getPortionFormat()->getEffective()->getHyperlinkClick())); // bool(true): το δεύτερο τμήμα δεν έχει υπερσύνδεσμο.
} finally {
$presentation->dispose();
}
Με την είσοδο που δημιουργήθηκε παραπάνω, η αναφορά περιέχει πέντε σειρές ενεργειών. Ο σύνδεσμος mouse‑over του αρχείου και το κλικ μακροεντολής αφαιρούνται, ενώ οι HTTPS σύνδεσμοι και η εσωτερική πλοήγηση διαφανειών παραμένουν. Η επαλήθευση εκτυπώνει μηδέν απαγορευμένες ενέργειες. Μια είσοδος που περιέχει απαγορευμένη εξωτερική κλικ‑URL επίσης ενεργοποιεί τον κλαδί αντικατάστασης. Ένα container με επιτρεπόμενο κλικ και απαγορευμένο mouse‑over διατηρεί την ενέργεια κλικ του.
Αυτός ο επιλεκτικός καθαρισμός διαφέρει από το removeAllHyperlinks, που αφαιρεί και τους δύο τύπους ενεργοποίησης σε όλη την επιλεγμένη περιοχή ανεξαρτήτως πολιτικής. Η επαλήθευση εδώ ελέγχει μόνο τις ενέργειες υπερσυνδέσμων· δεν αφαιρεί ενσωματωμένα VBA projects, αντικείμενα OLE ή άλλο ενεργό περιεχόμενο, και δεν επικυρώνει καταγεγραμμένο PDF ή HTML αρχείο.
ΣΥΧΝΕΣ ΕΡΩΤΗΣΕΙΣ
Πώς μπορώ να συνδέσω σε μια ενότητα ή στην πρώτη διαφάνεια της;
Οι ενότητες στο PowerPoint ομαδοποιούν διαφάνειες, αλλά ένας εσωτερικός υπερσύνδεσμος στοχεύει μια μεμονωμένη διαφάνεια. Για να δημιουργήσετε πλοήγηση σε ενότητα, συνδέστε την πρώτη διαφάνεια της ενότητας.
Μπορώ να προσθέσω υπερσύνδεσμο σε στοιχεία κύριας διαφάνειας ώστε να λειτουργεί σε όλες τις διαφάνειες;
Ναι. Τα στοιχεία της κύριας διαφάνειας και των διατάξεων υποστηρίζουν υπερσυνδέσμους. Οι σύνδεσμοι σε αυτά τα στοιχεία είναι διαθέσιμοι κατά τη διάρκεια της προβολής στις διαφάνειες που χρησιμοποιούν τον αντίστοιχο master ή layout.
Θα διατηρηθούν οι υπερσύνδεσμοι όταν εξάγονται σε PDF, HTML, εικόνες ή βίντεο;
Οι υποστηριζόμενες εξαγωγές PDF και HTML μπορεί να διατηρήσουν τους υπερσυνδέσμους· τα ραστερ εικόνες και βίντεο δεν μπορούν. Δείτε τις σκέψεις εξαγωγής στο Αναφορά, Καθαρισμός και Επαλήθευση Υπερσυνδέσμων.