Adicionar marcas d'água a apresentações no Android
Introdução
Uma marca d’água em uma apresentação é um selo de texto ou imagem usado em um slide ou em todas as lâminas da apresentação. Normalmente, a marca d’água é usada para indicar que a apresentação é um rascunho (por exemplo, uma marca d’água “Rascunho”), que contém informações confidenciais (por exemplo, uma marca d’água “Confidencial”), para especificar a que empresa pertence (por exemplo, uma marca d’água “Nome da Empresa”), para identificar o autor da apresentação, etc. Uma marca d’água ajuda a prevenir violações de direitos autorais ao indicar que a apresentação não deve ser copiada. As marcas d’água são usadas tanto nos formatos de apresentação PowerPoint quanto OpenOffice. No Aspose.Slides, você pode adicionar uma marca d’água aos formatos de arquivo PowerPoint PPT, PPTX e OpenOffice ODP.
No Aspose.Slides, há várias maneiras de criar marcas d’água em documentos PowerPoint ou OpenOffice e modificar seu design e comportamento. O aspecto comum é que, para adicionar marcas d’água de texto, você deve usar a interface ITextFrame; e, para adicionar marcas d’água de imagem, usar a classe PictureFrame ou preencher uma forma de marca d’água com uma imagem. PictureFrame implementa a interface IShape, permitindo usar todas as configurações flexíveis do objeto forma. Como ITextFrame não é uma forma e suas configurações são limitadas, ele é encapsulado em um objeto IShape.
Existem duas maneiras de aplicar uma marca d’água: a um único slide ou a todos os slides da apresentação. O Slide Master é usado para aplicar uma marca d’água a todos os slides — a marca d’água é adicionada ao Slide Master, totalmente projetada ali, e aplicada a todos os slides sem afetar a permissão de modificar a marca d’água em slides individuais.
Uma marca d’água geralmente é considerada indisponível para edição por outros usuários. Para impedir que a marca d’água (ou melhor, a forma-pai da marca d’água) seja editada, o Aspose.Slides fornece funcionalidade de bloqueio de formas. Uma forma específica pode ser bloqueada em um slide normal ou em um Slide Master. Quando a forma da marca d’água é bloqueada no Slide Master, ela será bloqueada em todos os slides da apresentação.
Você pode definir um nome para a marca d’água de modo que, no futuro, se quiser excluí‑la, possa encontrá‑la nas formas do slide pelo nome.
Você pode projetar a marca d’água de qualquer maneira; entretanto, geralmente há recursos comuns em marcas d’água, como alinhamento central, rotação, posição frontal, etc. Consideraremos como usar esses recursos nos exemplos a seguir.
Marca d’água de Texto
Adicionar uma Marca d’água de Texto a um Slide
Para adicionar uma marca d’água de texto em PPT, PPTX ou ODP, você pode primeiro adicionar uma forma ao slide e, em seguida, acrescentar um quadro de texto a essa forma. O quadro de texto é representado pela interface ITextFrame. Esse tipo não herda de IShape, que possui um amplo conjunto de propriedades para posicionar a marca d’água de forma flexível. Portanto, o objeto ITextFrame é encapsulado em um objeto IAutoShape. Para adicionar texto de marca d’água à forma, use o método addTextFrame conforme mostrado abaixo.
String watermarkText = "CONFIDENTIAL";
Presentation presentation = new Presentation();
ISlide slide = presentation.getSlides().get_Item(0);
IAutoShape watermarkShape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 40);
ITextFrame watermarkFrame = watermarkShape.addTextFrame(watermarkText);
presentation.dispose();
Veja também
Adicionar uma Marca d’água de Texto a uma Apresentação
Se desejar adicionar uma marca d’água de texto a toda a apresentação (ou seja, a todos os slides de uma vez), adicione‑a ao MasterSlide. O restante da lógica é o mesmo de quando se adiciona uma marca d’água a um único slide — crie um objeto IAutoShape e, em seguida, adicione a marca d’água usando o método addTextFrame.
String watermarkText = "CONFIDENTIAL";
Presentation presentation = new Presentation();
IMasterSlide masterSlide = presentation.getMasters().get_Item(0);
IAutoShape watermarkShape = masterSlide.getShapes().addAutoShape(ShapeType.Rectangle, 100, 100, 400, 40);
ITextFrame watermarkFrame = watermarkShape.addTextFrame(watermarkText);
presentation.dispose();
Veja também
Definir Transparência da Forma da Marca d’água
Por padrão, a forma retangular tem cores de preenchimento e linha. As linhas de código a seguir tornam a forma transparente.
watermarkShape.getFillFormat().setFillType(FillType.NoFill);
watermarkShape.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
Definir a Fonte para uma Marca d’água de Texto
Você pode alterar a fonte da marca d’água de texto conforme mostrado abaixo.
IPortionFormat textFormat = watermarkFrame.getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat();
textFormat.setLatinFont(new FontData("Arial"));
textFormat.setFontHeight(50);
Definir a Cor do Texto da Marca d’água
Para definir a cor do texto da marca d’água, use este código:
int alpha = 150, red = 200, green = 200, blue = 200;
IFillFormat fillFormat = watermarkFrame.getParagraphs().get_Item(0).getParagraphFormat().getDefaultPortionFormat().getFillFormat();
fillFormat.setFillType(FillType.Solid);
fillFormat.getSolidFillColor().setColor(Color.argb(alpha, red, green, blue));
Centralizar uma Marca d’água de Texto
É possível centralizar a marca d’água em um slide; para isso, você pode fazer o seguinte:
SizeF slideSize = presentation.getSlideSize().getSize();
float watermarkWidth = 400;
float watermarkHeight = 40;
float watermarkX = ((float)slideSize.getWidth() - watermarkWidth) / 2;
float watermarkY = ((float)slideSize.getHeight() - watermarkHeight) / 2;
IAutoShape watermarkShape = slide.getShapes().addAutoShape(
ShapeType.Rectangle, watermarkX, watermarkY, watermarkWidth, watermarkHeight);
ITextFrame watermarkFrame = watermarkShape.addTextFrame(watermarkText);
A imagem abaixo mostra o resultado final.
Marca d’água de Imagem
Adicionar uma Marca d’água de Imagem a uma Apresentação
Para adicionar uma marca d’água de imagem a um slide da apresentação, você pode fazer o seguinte:
InputStream imageStream = new FileInputStream("watermark.png");
IPPImage image = presentation.getImages().addImage(imageStream);
watermarkShape.getFillFormat().setFillType(FillType.Picture);
watermarkShape.getFillFormat().getPictureFillFormat().getPicture().setImage(image);
watermarkShape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch);
Bloquear uma Marca d’água contra Edição
Se for necessário impedir que uma marca d’água seja editada, use o método IAutoShape.getAutoShapeLock na forma. Com essa propriedade, você pode proteger a forma contra seleção, redimensionamento, reposicionamento, agrupamento com outros elementos, bloquear seu texto contra edição e muito mais:
// Bloqueie a forma da marca d'água contra modificações
watermarkShape.getAutoShapeLock().setSelectLocked(true);
watermarkShape.getAutoShapeLock().setSizeLocked(true);
watermarkShape.getAutoShapeLock().setTextLocked(true);
watermarkShape.getAutoShapeLock().setPositionLocked(true);
watermarkShape.getAutoShapeLock().setGroupingLocked(true);
Trazer uma Marca d’água para a Frente
No Aspose.Slides, a ordem Z das formas pode ser definida via o método IShapeCollection.reorder. Para fazer isso, chame esse método a partir da lista de slides da apresentação e passe a referência da forma e seu número de ordem ao método. Dessa forma, é possível trazer uma forma para a frente ou enviá‑la para o fundo do slide. Esse recurso é especialmente útil se precisar posicionar uma marca d’água na frente da apresentação:
int shapeCount = slide.getShapes().size();
slide.getShapes().reorder(shapeCount - 1, watermarkShape);
Definir Rotação da Marca d’água
Aqui está um exemplo de código de como ajustar a rotação da marca d’água para que ela fique posicionada diagonalmente no slide:
double diagonalAngle = Math.atan((slideSize.getHeight() / slideSize.getWidth())) * 180 / Math.PI;
watermarkShape.setRotation((float)diagonalAngle);
Definir um Nome para uma Marca d’água
O Aspose.Slides permite definir o nome de uma forma. Ao usar o nome da forma, você pode acessá‑la no futuro para modificá‑la ou excluí‑la. Para definir o nome da forma da marca d’água, atribua‑lo ao método IAutoShape.setName:
watermarkShape.setName("watermark");
Remover uma Marca d’água
Para remover a forma da marca d’água, use o método IAutoShape.getName para encontrá‑la nas formas do slide. Em seguida, passe a forma da marca d’água ao método IShapeCollection.remove:
IShape[] slideShapes = slide.getShapes().toArray();
for (IShape shape : slideShapes) {
if ("watermark".equals(shape.getName()))
{
slide.getShapes().remove(watermarkShape);
}
}
Perguntas Frequentes
O que é uma marca d’água e por que devo usá‑la?
Uma marca d’água é uma sobreposição de texto ou imagem aplicada aos slides que ajuda a proteger a propriedade intelectual, reforçar o reconhecimento da marca ou impedir o uso não autorizado das apresentações.
Posso adicionar uma marca d’água a todos os slides de uma apresentação?
Sim, o Aspose.Slides permite que você adicione programaticamente uma marca d’água a cada slide de uma apresentação. Você pode iterar por todos os slides e aplicar as configurações da marca d’água individualmente.
Como posso ajustar a transparência da marca d’água?
Você pode ajustar a transparência da marca d’água modificando as configurações de preenchimento (getFillFormat) da forma. Isso garante que a marca d’água seja sutil e não distraia do conteúdo do slide.
Quais formatos de imagem são suportados para marcas d’água?
O Aspose.Slides suporta vários formatos de imagem, como PNG, JPEG, GIF, BMP, SVG e outros.
Posso personalizar a fonte e o estilo de uma marca d’água de texto?
Sim, você pode escolher qualquer fonte, tamanho e estilo para combinar com o design da sua apresentação e manter a consistência da marca.
Como altero a posição ou orientação de uma marca d’água?
Você pode ajustar programaticamente a posição e a orientação da marca d’água modificando as coordenadas, o tamanho e as propriedades de rotação da forma.