Restringir edições de apresentações com bloqueios de forma em PHP
Visão geral
Um uso comum do Aspose.Slides for PHP via Java é criar, atualizar e salvar apresentações PowerPoint (PPTX) como parte de um fluxo de trabalho automatizado. Quando os usuários recebem essas apresentações, restringir alterações nas formas pode ajudar a preservar o layout e o conteúdo pretendidos.
Este artigo explica como as formas são organizadas nos slides e como aplicar e remover bloqueios de forma em uma apresentação PPTX. Esses bloqueios permitem restringir operações de edição específicas em formas individuais.
Composição de um slide
Um slide de apresentação é composto por componentes como autoshapes, tabelas, objetos OLE, formas agrupadas, picture frames, video frames, connectors e outros elementos usados para criar uma apresentação. No Aspose.Slides for PHP via Java, cada elemento em um slide é representado por um objeto que herda da classe Shape .
Tipos diferentes de forma expõem opções de bloqueio diferentes. A classe BaseShapeLock é a classe base para bloqueios de forma. Aspose.Slides for PHP via Java fornece as seguintes classes de bloqueio:
- AutoShapeLock bloqueia autoshapes.
- ConnectorLock bloqueia connector shapes.
- GraphicalObjectLock bloqueia graphical objects.
- GroupShapeLock bloqueia group shapes.
- PictureFrameLock bloqueia picture frames.
Para aplicar bloqueios em toda a Presentation, itere pelos seus slides e defina os bloqueios apropriados em cada forma suportada.
Aplicar e remover proteção
Os bloqueios de forma restringem operações como selecionar, mover e redimensionar formas. Eles não tornam toda a apresentação não editável.
Aplicar proteção a formas PPTX
Aspose.Slides for PHP via Java fornece a classe Shape para trabalhar com formas em um slide.
O exemplo chama setSelectLocked, setPositionLocked e setSizeLocked com true para autoshapes, com bloqueios equivalentes para group shapes, connectors e picture frames. Connectors usam setPositionMove para movimento; grupos também usam setGroupingLocked para restringir a agregação.
O exemplo carrega uma apresentação PPTX existente, verifica as formas na coleção de formas de cada slide e salva uma cópia com essas restrições aplicadas. Formas fora dos quatro tipos manipulados permanecem inalteradas. O loop não percorre as formas filhas dentro de um grupo.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("Sample.pptx");
try {
foreach ($presentation->getSlides()->toArray() as $slide) {
foreach ($slide->getShapes()->toArray() as $shape) {
if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
$shapeLock = $shape->getShapeLock();
$shapeLock->setPositionLocked(true);
$shapeLock->setSelectLocked(true);
$shapeLock->setSizeLocked(true);
} elseif (java_instanceof($shape, new JavaClass("com.aspose.slides.GroupShape"))) {
$shapeLock = $shape->getShapeLock();
$shapeLock->setGroupingLocked(true);
$shapeLock->setPositionLocked(true);
$shapeLock->setSelectLocked(true);
$shapeLock->setSizeLocked(true);
} elseif (java_instanceof($shape, new JavaClass("com.aspose.slides.Connector"))) {
$shapeLock = $shape->getShapeLock();
$shapeLock->setPositionMove(true);
$shapeLock->setSelectLocked(true);
$shapeLock->setSizeLocked(true);
} elseif (java_instanceof($shape, new JavaClass("com.aspose.slides.PictureFrame"))) {
$shapeLock = $shape->getShapeLock();
$shapeLock->setPositionLocked(true);
$shapeLock->setSelectLocked(true);
$shapeLock->setSizeLocked(true);
}
}
}
$presentation->save("ProtectedSample.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Remover proteção
Para remover um bloqueio de forma, defina seu valor como false. O exemplo a seguir carrega uma apresentação com bloqueios de forma e limpa as restrições de seleção, movimento e redimensionamento por meio de AutoShapeLock, GroupShapeLock, ConnectorLock e PictureFrameLock. Ele também remove a restrição de agrupamento ao passar false para GroupShapeLock::setGroupingLocked e salva uma cópia da apresentação. Outras configurações de bloqueio permanecem inalteradas.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("ProtectedSample.pptx");
try {
foreach ($presentation->getSlides()->toArray() as $slide) {
foreach ($slide->getShapes()->toArray() as $shape) {
if (java_instanceof($shape, new JavaClass("com.aspose.slides.AutoShape"))) {
$shapeLock = $shape->getShapeLock();
$shapeLock->setPositionLocked(false);
$shapeLock->setSelectLocked(false);
$shapeLock->setSizeLocked(false);
} elseif (java_instanceof($shape, new JavaClass("com.aspose.slides.GroupShape"))) {
$shapeLock = $shape->getShapeLock();
$shapeLock->setGroupingLocked(false);
$shapeLock->setPositionLocked(false);
$shapeLock->setSelectLocked(false);
$shapeLock->setSizeLocked(false);
} elseif (java_instanceof($shape, new JavaClass("com.aspose.slides.Connector"))) {
$shapeLock = $shape->getShapeLock();
$shapeLock->setPositionMove(false);
$shapeLock->setSelectLocked(false);
$shapeLock->setSizeLocked(false);
} elseif (java_instanceof($shape, new JavaClass("com.aspose.slides.PictureFrame"))) {
$shapeLock = $shape->getShapeLock();
$shapeLock->setPositionLocked(false);
$shapeLock->setSelectLocked(false);
$shapeLock->setSizeLocked(false);
}
}
}
$presentation->save("RemovedProtectionSample.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Conclusão
Aspose.Slides for PHP via Java permite restringir operações de edição específicas em formas individuais ou aplicar as mesmas restrições em vários slides. Escolha os bloqueios suportados por cada tipo de forma e defina seus valores como false quando precisar remover essas restrições.
FAQ
Posso combinar bloqueios de forma e proteção por senha na mesma apresentação?
Sim. Os bloqueios de forma restringem operações de edição específicas, enquanto proteção por senha pode restringir a abertura ou a modificação da apresentação. Você pode usar ambos no mesmo arquivo.
Posso restringir a edição em slides específicos sem afetar os demais?
Sim. Aplique bloqueios apenas às formas nos slides selecionados. Isso não altera as configurações de bloqueio nos outros slides.
Como posso aplicar bloqueios a formas individuais dentro de um grupo?
Itere pela coleção retornada pelo método getShapes do grupo e aplique os bloqueios adequados a cada forma filha. Repita isso para quaisquer grupos aninhados. Os exemplos acima processam apenas a coleção de formas do slide, portanto não definem bloqueios em membros individuais do grupo.