Récupérer et mettre à jour les propriétés d'affichage de la présentation en Java
Introduction
La vue normale se compose de trois zones de contenu : la diapositive elle‑même, une zone de contenu latérale et une zone de contenu inférieure. Les propriétés concernant le positionnement des différentes zones de contenu. Ces informations permettent à l’application d’enregistrer son état de vue dans le fichier, de sorte que, lorsqu’il est rouvert, la vue soit dans le même état que lors de la dernière sauvegarde de la présentation.
La méthode IViewProperties.getNormalViewProperties a été ajoutée pour fournir un accès aux propriétés de vue normale d’une présentation.
Les interfaces INormalViewProperties, INormalViewRestoredProperties et leurs dérivées, ainsi que l’énumération SplitterBarStateType ont été ajoutées.
À propos de INormalViewProperties
Représente les propriétés de vue normale.
Les méthodes getShowOutlineIcons et setShowOutlineIcons spécifient si l’application doit afficher les icônes lors de l’affichage du contenu du plan dans l’une des zones de contenu du mode vue normale.
Les méthodes getSnapVerticalSplitter et setSnapVerticalSplitter spécifient si le séparateur vertical doit se réduire à un état minimisé lorsque la zone latérale est suffisamment petite.
La propriété getPreferSingleView et setPreferSingleView indique si l’utilisateur préfère voir une région de contenu unique sur toute la fenêtre plutôt que la vue normale standard à trois zones de contenu. Si elle est activée, l’application peut choisir d’afficher l’une des zones de contenu dans toute la fenêtre.
Les méthodes getVerticalBarState et getHorizontalBarState précisent l’état dans lequel la barre de séparation verticale ou horizontale doit être affichée. Une barre de séparation horizontale sépare la diapositive de la zone de contenu située sous la diapositive, tandis qu’une barre de séparation verticale sépare la diapositive de la zone de contenu latérale. Les valeurs possibles sont : SplitterBarStateType.Minimized, SplitterBarStateType.Maximized et SplitterBarStateType.Restored.
Les méthodes getRestoredLeft et getRestoredTop spécifient la taille de la région supérieure ou latérale de la diapositive en vue normale, lorsque la valeur SplitterBarStateType.Restored est appliquée à getVerticalBarState et getHorizontalBarState en conséquence.
À propos de la restauration de INormalViewProperties
Spécifie la taille de la région de la diapositive (largeur lorsqu’elle est enfant de getRestoredTop, hauteur lorsqu’elle est enfant de getRestoredLeft) de la vue normale, lorsque la région a une taille restaurée variable (ni minimisée ni maximisée).
La méthode getDimensionSize spécifie la taille de la région de la diapositive (largeur lorsqu’elle est enfant de restoredTop, hauteur lorsqu’elle est enfant de restoredLeft).
La méthode getAutoAdjust indique si la taille de la zone de contenu latérale doit se compenser lors du redimensionnement de la fenêtre contenant la vue dans l’application.
Un exemple ci‑dessous montre comment accéder aux propriétés ViewProperties.getNormalViewProperties d’une présentation.
import com.aspose.slides.*;
Presentation pres = new Presentation();
try {
pres.getViewProperties().getNormalViewProperties().setHorizontalBarState(SplitterBarStateType.Restored);
pres.getViewProperties().getNormalViewProperties().setVerticalBarState(SplitterBarStateType.Maximized);
// Restaurer les propriétés d'affichage de la présentation
pres.getViewProperties().getNormalViewProperties().getRestoredTop().setAutoAdjust(true);
pres.getViewProperties().getNormalViewProperties().getRestoredTop().setDimensionSize(80);
pres.getViewProperties().getNormalViewProperties().setShowOutlineIcons(true);
pres.save("presentation_normal_view_state.pptx", SaveFormat.Pptx);
} finally {
pres.dispose();
}
Définir la valeur de zoom par défaut
Pour définir les propriétés de vue, suivez les étapes ci‑dessous :
- Créez une instance de la classe Presentation.
- Définissez les View Properties de la Presentation.
- Enregistrez la présentation au format PPTX.
Dans l’exemple ci‑dessous, nous avons défini la valeur de zoom pour la vue diapositive ainsi que pour la vue notes.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
// Définition des propriétés d'affichage de la présentation
presentation.getViewProperties().getSlideViewProperties().setScale(100); // Valeur de zoom en pourcentage pour la vue diapositive
presentation.getViewProperties().getNotesViewProperties().setScale(100); // Valeur de zoom en pourcentage pour la vue notes
presentation.save("Zoom_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Définir l’espacement de la grille
Utilisez Presentation.getViewProperties pour accéder aux paramètres de vue à l’échelle de la présentation. Les méthodes IViewProperties.getGridSpacing et IViewProperties.setGridSpacing lisent ou modifient l’intervalle de la grille d’édition sous‑jacent. Ce paramètre s’applique à toute la présentation, pas à une diapositive individuelle. L’espacement de la grille est exprimé en points, où 72 points correspondent à un pouce. Utilisez une valeur positive, comme indiqué dans la documentation de l’API.
L’exemple suivant ouvre un fichier demo.pptx existant, affiche l’espacement de la grille actuel, définit un intervalle d’un quart de pouce et enregistre le résultat.
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
Presentation presentation = new Presentation("demo.pptx");
try {
float gridSpacing = presentation.getViewProperties().getGridSpacing();
System.out.println("Current grid spacing: " + gridSpacing + " points");
presentation.getViewProperties().setGridSpacing(18f);
presentation.save("grid-spacing.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
La grille est différente des drawing guides. L’espacement de la grille contrôle un intervalle régulier, tandis que les guides de dessin sont des lignes d’alignement horizontales ou verticales positionnées individuellement. Ajouter, déplacer ou supprimer des guides de dessin ne modifie pas l’espacement de la grille.
La grille et les guides de dessin sont des aides à l’édition. Ils ne sont pas rendus comme contenu de diapositive dans les PDF, images, SVG ou lors d’un diaporama. Le stockage de l’espacement de la grille ne garantit pas qu’un éditeur l’affichera : sa visibilité dépend également des préférences du visualiseur ou de l’éditeur.
Afficher ou masquer les commentaires à l’ouverture d’une présentation
Utilisez Presentation.getViewProperties pour accéder aux paramètres de vue à l’échelle de la présentation. Les méthodes IViewProperties.getShowComments et IViewProperties.setShowComments lisent ou modifient la préférence stockée indiquant si les commentaires doivent être affichés lorsque la présentation s’ouvre dans PowerPoint ou un autre éditeur compatible.
Ce paramètre ne contrôle que la préférence de vue stockée. Il n’ajoute, ne supprime, n’édite ni ne résout les commentaires. Masquer les commentaires préserve leur contenu, leurs auteurs, leurs positions, leurs réponses et leurs états. Consultez la section Presentation Comments pour les opérations qui modifient réellement les commentaires.
L’exemple suivant nécessite un fichier comments.pptx contenant des commentaires. Il affiche le paramètre de visibilité actuel, demande que les commentaires soient masqués et enregistre un nouveau PPTX sans supprimer aucun commentaire. Il utilise également IViewProperties.setLastView avec ViewType.SlideView pour configurer la vue d’édition initiale ainsi que la visibilité des commentaires.
import com.aspose.slides.NullableBool;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ViewType;
Presentation presentation = new Presentation("comments.pptx");
try {
byte showComments = presentation.getViewProperties().getShowComments();
System.out.println("Current comment visibility: " + showComments);
presentation.getViewProperties().setShowComments(NullableBool.False);
presentation.getViewProperties().setLastView(ViewType.SlideView);
presentation.save("comments-hidden.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Ce paramètre ne détermine pas si les commentaires sont inclus dans les exportations PDF, HTML, image, notes ou support de présentation. Configurez séparément les options spécifiques à chaque type d’exportation.
FAQ
Pourquoi la grille n’est‑elle pas visible après la réouverture de la présentation ?
Le fichier stocke l’espacement de la grille, mais l’éditeur contrôle son affichage. Vérifiez les paramètres de visibilité de la grille dans l’éditeur.
La suppression des guides de dessin modifie‑t‑elle l’espacement de la grille ?
Non. Les guides de dessin et l’espacement de la grille sont des paramètres indépendants. Supprimer les guides laisse l’intervalle de la grille stocké inchangé.
Puis‑je définir des paramètres de vue différents pour différentes sections d’une présentation ?
Les view settings sont définis au niveau de la présentation (Normal View/Slide View), pas par section, de sorte qu’un seul jeu de paramètres s’applique à tout le document lors de son ouverture.
Puis‑je pré‑définir différents états de vue pour différents utilisateurs ?
Non. Les paramètres sont stockés dans le fichier et sont partagés. Les applications de visualisation peuvent tenir compte des préférences de l’utilisateur, mais le fichier lui‑même ne contient qu’un seul ensemble de propriétés de vue.
Puis‑je préparer un modèle avec des View Properties pré‑définies afin que les nouvelles présentations s’ouvrent de la même façon ?
Oui. Comme les view properties sont stockées au niveau de la présentation, vous pouvez les intégrer dans un modèle et créer de nouveaux documents à partir de celui‑ci avec la même configuration de vue initiale.