Application de la Protection à la Présentation
Un usage courant d’Aspose.Slides est de créer, mettre à jour et enregistrer des présentations Microsoft PowerPoint 2007 (PPTX) dans le cadre d’un flux de travail automatisé. Les utilisateurs de l’application utilisant Aspose.Slides de cette manière ont accès aux présentations générées. Les protéger contre la modification est une préoccupation commune. Il est important que les présentations générées automatiquement conservent leur formatage et leur contenu d’origine.
Cet article explique comment les présentations et les diapositives sont construites et comment Aspose.Slides pour Java peut appliquer une protection à et ensuite la retirer de une présentation. Cette fonctionnalité est unique à Aspose.Slides et, au moment de la rédaction, n’est pas disponible dans Microsoft PowerPoint. Elle offre aux développeurs un moyen de contrôler comment les présentations créées par leurs applications sont utilisées.
Composition d’une Diapositive
Une diapositive PPTX est composée de plusieurs composants comme des formes automatiques, des tableaux, des objets OLE, des formes groupées, des cadres d’image, des cadres vidéo, des connecteurs et divers autres éléments disponibles pour construire une présentation. Dans Aspose.Slides pour Java, chaque élément sur une diapositive est transformé en un objet Shape. En d’autres termes, chaque élément sur la diapositive est soit un objet Shape soit un objet dérivé de l’objet Shape. La structure du PPTX est complexe, donc contrairement au PPT, où un verrou général peut être utilisé pour tous les types de formes, il existe différents types de verrous pour différents types de formes. La classe BaseShapeLock est la classe de verrouillage générique pour PPTX. Les types de verrous suivants sont supportés dans Aspose.Slides pour Java pour PPTX.
- AutoShapeLock verrouille les formes automatiques.
- ConnectorLock verrouille les formes connecteurs.
- GraphicalObjectLock verrouille les objets graphiques.
- GroupshapeLock verrouille les formes groupées.
- PictureFrameLock verrouille les cadres d’image. Toute action effectuée sur tous les objets Shape dans un objet Présentation est appliquée à l’ensemble de la présentation.
Application et Retrait de la Protection
Appliquer une protection garantit qu’une présentation ne peut pas être modifiée. C’est une technique utile pour protéger le contenu d’une présentation.
Application de la Protection aux Formes PPTX
Aspose.Slides pour Java fournit la classe Shape pour gérer une forme sur la diapositive.
Comme mentionné précédemment, chaque classe de forme a une classe de verrouillage de forme associée pour la protection. Cet article se concentre sur les verrous NoSelect, NoMove et NoResize. Ces verrous garantissent que les formes ne peuvent pas être sélectionnées (par des clics de souris ou d’autres méthodes de sélection), et qu’elles ne peuvent pas être déplacées ou redimensionnées.
Les exemples de code qui suivent appliquent une protection à tous les types de formes dans une présentation.
| try { | |
| //Instatiate Presentation class that represents a PPTX file | |
| Presentation pTemplate = new Presentation("RectPicFrame.pptx"); | |
| //ISlide object for accessing the slides in the presentation | |
| ISlide slide = pTemplate.getSlides().get_Item(0); | |
| //IShape object for holding temporary shapes | |
| IShape shape; | |
| //Traversing through all the slides in the presentation | |
| for (int slideCount = 0; slideCount < pTemplate.getSlides().size(); slideCount++) | |
| { | |
| slide = pTemplate.getSlides().get_Item(slideCount); | |
| //Travesing through all the shapes in the slides | |
| for (int count = 0; count < slide.getShapes().size(); count++) | |
| { | |
| shape = slide.getShapes().get_Item(count); | |
| //if shape is autoshape | |
| if (shape instanceof IAutoShape) | |
| { | |
| //Type casting to Auto shape and getting auto shape lock | |
| IAutoShape Ashp = (IAutoShape)shape; | |
| IAutoShapeLock AutoShapeLock = (IAutoShapeLock) Ashp.getShapeLock(); | |
| //Applying shapes locks | |
| AutoShapeLock.setPositionLocked(true); | |
| AutoShapeLock.setSelectLocked(true); | |
| AutoShapeLock.setSizeLocked(true); | |
| } | |
| //if shape is group shape | |
| else if (shape instanceof IGroupShape) | |
| { | |
| //Type casting to group shape and getting group shape lock | |
| IGroupShape Group = (IGroupShape)shape; | |
| IGroupShapeLock groupShapeLock = (IGroupShapeLock) Group.getShapeLock(); | |
| //Applying shapes locks | |
| groupShapeLock.setGroupingLocked(true); | |
| groupShapeLock.setPositionLocked(true); | |
| groupShapeLock.setSelectLocked(true); | |
| groupShapeLock.setSizeLocked(true); | |
| } | |
| //if shape is a connector | |
| else if (shape instanceof IConnector) | |
| { | |
| //Type casting to connector shape and getting connector shape lock | |
| IConnector Conn = (IConnector)shape; | |
| IConnectorLock ConnLock = Conn.getShapeLock(); | |
| //Applying shapes locks | |
| ConnLock.setPositionMove(true); | |
| ConnLock.setSelectLocked(true); | |
| ConnLock.setSizeLocked(true); | |
| } | |
| //if shape is picture frame | |
| else if (shape instanceof IPictureFrame) | |
| { | |
| //Type casting to pitcture frame shape and getting picture frame shape lock | |
| IPictureFrame Pic = (IPictureFrame)shape; | |
| IPictureFrameLock PicLock = (IPictureFrameLock) Pic.getShapeLock(); | |
| //Applying shapes locks | |
| PicLock.setPositionLocked(true); | |
| PicLock.setSelectLocked(true); | |
| PicLock.setSizeLocked(true); | |
| } | |
| } | |
| } | |
| //Saving the presentation file | |
| pTemplate.save("ProtectedSample.pptx", SaveFormat.Pptx); | |
| } catch (Exception e) { | |
| } |
Retrait de la Protection
La protection appliquée à l’aide d’Aspose.Slides pour .NET/Java ne peut être retirée qu’avec Aspose.Slides pour .NET/Java. Pour déverrouiller une forme, définissez la valeur du verrou appliqué sur faux. L’exemple de code qui suit montre comment déverrouiller des formes dans une présentation verrouillée.
| try { | |
| //Instatiate Presentation class that represents a PPTX file | |
| Presentation pTemplate = new Presentation("ProtectedSample.pptx"); | |
| //ISlide object for accessing the slides in the presentation | |
| ISlide slide = pTemplate.getSlides().get_Item(0); | |
| //IShape object for holding temporary shapes | |
| IShape shape; | |
| //Traversing through all the slides in the presentation | |
| for (int slideCount = 0; slideCount < pTemplate.getSlides().size(); slideCount++) | |
| { | |
| slide = pTemplate.getSlides().get_Item(slideCount); | |
| //Travesing through all the shapes in the slides | |
| for (int count = 0; count < slide.getShapes().size(); count++) | |
| { | |
| shape = slide.getShapes().get_Item(count); | |
| //if shape is autoshape | |
| if (shape instanceof IAutoShape) | |
| { | |
| //Type casting to Auto shape and getting auto shape lock | |
| IAutoShape Ashp = (IAutoShape)shape; | |
| IAutoShapeLock AutoShapeLock = (IAutoShapeLock) Ashp.getShapeLock(); | |
| //Applying shapes locks | |
| AutoShapeLock.setPositionLocked(false); | |
| AutoShapeLock.setSelectLocked(false); | |
| AutoShapeLock.setSizeLocked(false); | |
| } | |
| //if shape is group shape | |
| else if (shape instanceof IGroupShape) | |
| { | |
| //Type casting to group shape and getting group shape lock | |
| IGroupShape Group = (IGroupShape)shape; | |
| IGroupShapeLock groupShapeLock = (IGroupShapeLock) Group.getShapeLock(); | |
| //Applying shapes locks | |
| groupShapeLock.setGroupingLocked(false); | |
| groupShapeLock.setPositionLocked(false); | |
| groupShapeLock.setSelectLocked(false); | |
| groupShapeLock.setSizeLocked(false); | |
| } | |
| //if shape is a connector | |
| else if (shape instanceof IConnector) | |
| { | |
| //Type casting to connector shape and getting connector shape lock | |
| IConnector Conn = (IConnector)shape; | |
| IConnectorLock ConnLock = Conn.getShapeLock(); | |
| //Applying shapes locks | |
| ConnLock.setPositionMove(false); | |
| ConnLock.setSelectLocked(false); | |
| ConnLock.setSizeLocked(false); | |
| } | |
| //if shape is picture frame | |
| else if (shape instanceof IPictureFrame) | |
| { | |
| //Type casting to pitcture frame shape and getting picture frame shape lock | |
| IPictureFrame Pic = (IPictureFrame)shape; | |
| IPictureFrameLock PicLock = (IPictureFrameLock) Pic.getShapeLock(); | |
| //Applying shapes locks | |
| PicLock.setPositionLocked(false); | |
| PicLock.setSelectLocked(false); | |
| PicLock.setSizeLocked(false); | |
| } | |
| } | |
| } | |
| //Saving the presentation file | |
| pTemplate.save("RemoveProtectionSample.pptx", SaveFormat.Pptx); | |
| } catch (Exception e) { | |
| } | |