Gérer les commentaires de présentation en PHP
Dans PowerPoint, un commentaire apparaît comme une note ou une annotation sur une diapositive. Lorsque vous cliquez sur un commentaire, son contenu ou ses messages sont affichés.
Pourquoi ajouter des commentaires aux présentations ?
Vous pouvez vouloir utiliser des commentaires pour fournir des retours ou communiquer avec vos collègues lors de la révision de présentations.
Pour vous permettre d’utiliser les commentaires dans les présentations PowerPoint, Aspose.Slides for PHP via Java fournit :
- La classe Presentation qui contient les collections d’auteurs (à partir de la classe CommentAuthorCollection). Les auteurs ajoutent des commentaires aux diapositives.
- La classe CommentCollection qui contient la collection de commentaires pour chaque auteur.
- La classe Comment qui contient les informations sur les auteurs et leurs commentaires : qui a ajouté le commentaire, la date d’ajout, la position du commentaire, etc.
- La classe CommentAuthor qui contient les informations sur chaque auteur : le nom de l’auteur, ses initiales, les commentaires associés à son nom, etc.
Ajouter des commentaires à la diapositive
Ce code PHP vous montre comment ajouter un commentaire à une diapositive d’une présentation PowerPoint :
# Instancie la classe Presentation
$pres = new Presentation();
$Array = new java_class("java.lang.reflect.Array");
try {
# Ajoute une diapositive vide
$pres->getSlides()->addEmptySlide($pres->getLayoutSlides()->get_Item(0));
# Ajoute un auteur
$author = $pres->getCommentAuthors()->addAuthor("Jawad", "MF");
# Définit la position des commentaires
$point = new Point2DFloat(0.2, 0.2);
# Ajoute un commentaire de diapositive pour un auteur sur la diapositive 1
$author->getComments()->addComment("Hello Jawad, this is slide comment", $pres->getSlides()->get_Item(0), $point, new Java("java.util.Date"));
# Ajoute un commentaire de diapositive pour un auteur sur la diapositive 2
$author->getComments()->addComment("Hello Jawad, this is second slide comment", $pres->getSlides()->get_Item(1), $point, new Java("java.util.Date"));
# Accède à ISlide 1
$slide = $pres->getSlides()->get_Item(0);
# Lorsque null est passé en argument, les commentaires de tous les auteurs sont récupérés pour la diapositive sélectionnée
$Comments = $slide->getSlideComments($author);
# Accède au commentaire à l'index 0 pour la diapositive 1
$str = $Comments[0]->getText();
$pres->save("Comments_out.pptx", SaveFormat::Pptx);
if (java_values($Array->getLength($Comments)) > 0) {
# Sélectionne la collection de commentaires de l'Auteur à l'index 0
$commentCollection = $Comments[0]->getAuthor()->getComments();
$Comment = $commentCollection->get_Item(0)->getText();
}
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Accéder aux commentaires de diapositive
Ce code PHP vous montre comment accéder à un commentaire existant sur une diapositive d’une présentation PowerPoint :
# Instancie la classe Presentation
$pres = new Presentation("Comments1.pptx");
try {
foreach($pres->getCommentAuthors() as $commentAuthor) {
$author = $commentAuthor;
foreach($author->getComments() as $comment1) {
$comment = $comment1;
echo("ISlide :" . $comment->getSlide()->getSlideNumber() . " has comment: " . $comment->getText() . " with Author: " . $comment->getAuthor()->getName() . " posted on time :" . $comment->getCreatedTime() . "\n");
}
}
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Répondre aux commentaires
Un commentaire parent est le commentaire principal ou original dans une hiérarchie de commentaires ou de réponses. En utilisant les méthodes getParentComment ou setParentComment (de la classe Comment), vous pouvez définir ou récupérer un commentaire parent.
Ce code PHP vous montre comment ajouter des commentaires et obtenir leurs réponses :
$pres = new Presentation();
$Array = new java_class("java.lang.reflect.Array");
try {
# Ajoute un commentaire
$author1 = $pres->getCommentAuthors()->addAuthor("Author_1", "A.A.");
$comment1 = $author1->getComments()->addComment("comment1", $pres->getSlides()->get_Item(0), new Point2DFloat(10, 10), new Java("java.util.Date"));
# Ajoute une réponse au commentaire 1
$author2 = $pres->getCommentAuthors()->addAuthor("Autror_2", "B.B.");
$reply1 = $author2->getComments()->addComment("reply 1 for comment 1", $pres->getSlides()->get_Item(0), new Point2DFloat(10, 10), new Java("java.util.Date"));
$reply1->setParentComment($comment1);
# Ajoute une autre réponse au commentaire 1
$reply2 = $author2->getComments()->addComment("reply 2 for comment 1", $pres->getSlides()->get_Item(0), new Point2DFloat(10, 10), new Java("java.util.Date"));
$reply2->setParentComment($comment1);
# Ajoute une réponse à une réponse existante
$subReply = $author1->getComments()->addComment("subreply 3 for reply 2", $pres->getSlides()->get_Item(0), new Point2DFloat(10, 10), new Java("java.util.Date"));
$subReply->setParentComment($reply2);
$comment2 = $author2->getComments()->addComment("comment 2", $pres->getSlides()->get_Item(0), new Point2DFloat(10, 10), new Java("java.util.Date"));
$comment3 = $author2->getComments()->addComment("comment 3", $pres->getSlides()->get_Item(0), new Point2DFloat(10, 10), new Java("java.util.Date"));
$reply3 = $author1->getComments()->addComment("reply 4 for comment 3", $pres->getSlides()->get_Item(0), new Point2DFloat(10, 10), new Java("java.util.Date"));
$reply3->setParentComment($comment3);
# Affiche la hiérarchie des commentaires dans la console
$slide = $pres->getSlides()->get_Item(0);
$comments = $slide->getSlideComments(null);
for($i = 0; $i < java_values($Array->getLength($comments)) ; $i++) {
$comment = $comments[$i];
while (!java_is_null($comment->getParentComment())) {
System->out->print("\t");
$comment = $comment->getParentComment();
}
echo($comments[$i]->getAuthor()->getName() . " : " . $comments[$i]->getText());
echo();
}
$pres->save("parent_comment.pptx", SaveFormat::Pptx);
# Supprime le commentaire 1 et toutes ses réponses
$comment1->remove();
$pres->save("remove_comment.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Attention
- Lorsque la méthode remove (de la classe Comment) est utilisée pour supprimer un commentaire, les réponses à ce commentaire sont également supprimées.
- Si le paramètre setParentComment entraîne une référence circulaire, une PptxEditException sera déclenchée.
Ajouter des commentaires modernes
En 2021, Microsoft a introduit les commentaires modernes dans PowerPoint. Cette fonctionnalité améliore considérablement la collaboration dans PowerPoint. Grâce aux commentaires modernes, les utilisateurs de PowerPoint peuvent résoudre des commentaires, ancrer des commentaires à des objets ou du texte et interagir beaucoup plus facilement qu’auparavant.
Dans Aspose Slides for Java 21.11, nous avons implémenté la prise en charge des commentaires modernes en ajoutant la classe ModernComment. Les méthodes addModernComment et insertModernComment ont été ajoutées à la classe CommentCollection.
Ce code PHP vous montre comment ajouter un commentaire moderne à une diapositive d’une présentation PowerPoint :
$pres = new Presentation();
try {
$newAuthor = $pres->getCommentAuthors()->addAuthor("Some Author", "SA");
$modernComment = $newAuthor->getComments()->addModernComment("This is a modern comment", $pres->getSlides()->get_Item(0), null, new Point2DFloat(100, 100), new Java("java.util.Date"));
$pres->save("pres.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Supprimer des commentaires
Supprimer tous les commentaires et auteurs
Ce code PHP vous montre comment supprimer tous les commentaires et auteurs d’une présentation :
$presentation = new Presentation("example.pptx");
try {
# Supprime tous les commentaires de la présentation
foreach($presentation->getCommentAuthors() as $author) {
$author->getComments()->clear();
}
# Supprime tous les auteurs
$presentation->getCommentAuthors()->clear();
$presentation->save("example_out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Supprimer des commentaires spécifiques
Ce code PHP vous montre comment supprimer des commentaires spécifiques sur une diapositive :
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
# ajouter des commentaires...
$author = $presentation->getCommentAuthors()->addAuthor("Author", "A");
$author->getComments()->addComment("comment 1", $slide, new Point2DFloat(0.2, 0.2), new Java("java.util.Date"));
$author->getComments()->addComment("comment 2", $slide, new Point2DFloat(0.3, 0.2), new Java("java.util.Date"));
# supprimer tous les commentaires contenant le texte "comment 1"
foreach($presentation->getCommentAuthors() as $commentAuthor) {
$toRemove = new Java("java.util.ArrayList");
foreach($slide->getSlideComments($commentAuthor) as $comment) {
if ($comment->getText()->equals("comment 1")) {
$toRemove->add($comment);
}
}
foreach($toRemove as $comment) {
$commentAuthor->getComments()->remove($comment);
}
}
$presentation->save("pres.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
FAQ
Aspose.Slides prend‑t‑il en charge un état comme « résolu » pour les commentaires modernes ?
Oui. Les commentaires modernes exposent une méthode setStatus ; vous pouvez définir l’état du commentaire (par exemple, le marquer comme résolu), et cet état est enregistré dans le fichier et reconnu par PowerPoint.
Les discussions en fil (chaînes de réponses) sont‑elles prises en charge, et y a‑t‑il une limite de profondeur ?
Oui. Chaque commentaire peut référencer son parent comment, permettant des chaînes de réponses arbitraires. L’API ne déclare pas de limite spécifique de profondeur d’imbrication.
Dans quel système de coordonnées la position du marqueur de commentaire est‑elle définie sur une diapositive ?
La position est stockée sous forme de point à virgule flottante dans le système de coordonnées de la diapositive. Cela vous permet de placer le marqueur de commentaire précisément où vous le souhaitez.