Como desenvolvedor C#, você pode adicionar facilmente marcas d’água de texto ou imagem em documentos do Word programaticamente. Uma marca d’água é um tipo de mensagem na forma de texto ou imagem, geralmente usada para identificar ou proteger os documentos, mostrando informações de direitos autorais, isenção de responsabilidade, logotipo, carimbo ou assinatura. Neste artigo, você aprenderá como adicionar marcas d’água de texto ou imagem em documentos do Word usando C#.
Os seguintes tópicos são discutidos/abordados neste artigo:
- API C# para adicionar marca d’água em documentos do Word
- Adicionar marca d’água de texto em documentos do Word usando C #
- Adicionar marca d’água de imagem em documentos do Word usando C #
- Marca d’água as imagens de um documento do Word usando C #
- Adicionar marca d’água a páginas específicas em documentos do Word usando C#
- Adicionar marca d’água ao cabeçalho ou rodapé de documentos do Word usando C#
API C# para adicionar marca d’água em documentos do Word
Para adicionar marcas d’água de texto ou imagem em arquivos DOC ou DOCX, usaremos a API GroupDocs.Watermark for .NET. Ele permite adicionar, editar, pesquisar e remover marcas d’água de imagem e texto em formatos de arquivo suportados. Também permite obter as informações básicas sobre os documentos de origem, como tipo de arquivo, tamanho, contagem de páginas, altura e largura da página, etc. O recurso de visualização de documentos da API permite gerar representações de imagens das páginas do documento para uma melhor compreensão do documento.
Você pode baixar a DLL da API ou instalá-la usando NuGet.
Install-Package GroupDocs.Watermark
Adicionar marca d’água de texto em documentos do Word usando C
Você pode adicionar uma marca d’água de texto a documentos do Word seguindo as etapas abaixo:
- Primeiramente, carregue o arquivo DOCX usando a classe Watermarker.
- Inicialize a fonte a ser usada para texto de marca d’água usando a classe Font.
- Crie uma instância da classe TextWatermark para criar uma marca d’água de texto. Passe o texto para mostrar como marca d’água e objeto de fonte definido como parâmetros de entrada.
- Agora, defina várias propriedades da marca d’água, como Cor do primeiro plano, Cor do plano de fundo, Ângulo de rotação, Altura, Largura, Opacidade, etc.
- Em seguida, chame o método Watermarker.Add() para adicionar a marca d’água de texto ao documento.
- Finalmente, chame o método Watermarker.Save() para salvar o documento do Word com marca d’água.
O exemplo de código a seguir mostra como adicionar uma marca d’água de texto em um arquivo DOCX usando C#.
// Marca d'água do criador
Watermarker watermarker = new Watermarker(@"C:\Files\Watermark\sample.docx");
// Inicialize a fonte a ser usada para marca d'água
Font font = new Font("Arial", 19, FontStyle.Bold | FontStyle.Italic);
// Crie o objeto de marca d'água
TextWatermark watermark = new TextWatermark("Simple Text Watermark", font);
// Definir propriedades da marca d'água
watermark.ForegroundColor = Color.Red;
watermark.BackgroundColor = Color.Blue;
watermark.TextAlignment = TextAlignment.Right;
watermark.HorizontalAlignment = HorizontalAlignment.Center;
watermark.VerticalAlignment = VerticalAlignment.Bottom;
// Definir o tamanho da marca d'água
watermark.Width = 150;
watermark.Height = 40;
// Definir nível de opacidade
watermark.Opacity = 0.9;
// Adicione uma Marca D'água
watermarker.Add(watermark);
// Salve o arquivo de saída
watermarker.Save(@"C:\Files\Watermark\addTextWatermark_output.docx");
Adicionar marca d’água de imagem em documentos do Word usando C
Você pode adicionar uma imagem como marca d’água a documentos do Word seguindo as etapas abaixo:
- Primeiramente, carregue o arquivo DOCX usando a classe Watermarker.
- Crie uma instância da classe ImageWatermark com o caminho da imagem para criar uma marca d’água de imagem.
- Agora, defina várias propriedades da marca d’água, como Alinhamento, Altura, Largura, etc.
- Em seguida, chame o método Watermarker.Add() para adicionar a marca d’água da imagem ao documento.
- Finalmente, chame o método Watermarker.Save() para salvar o documento do Word com marca d’água.
O exemplo de código a seguir mostra como adicionar uma marca d’água de imagem em um arquivo DOCX usando C#.
// Criar marca d'água
Watermarker watermarker = new Watermarker(@"C:\Files\Watermark\sample.docx");
// Crie o objeto de marca d'água
ImageWatermark watermark = new ImageWatermark(@"C:\Files\Watermark\logo.png");
// Definir alinhamento de marca d'água
watermark.HorizontalAlignment = HorizontalAlignment.Center;
watermark.VerticalAlignment = VerticalAlignment.Bottom;
// Definir o tamanho da marca d'água
watermark.Width = 100;
watermark.Height = 100;
// Adicione uma Marca D'água
watermarker.Add(watermark);
// Salve o arquivo de saída
watermarker.Save(@"C:\Files\Watermark\AddImageWatermark_output.docx");
Marca d’água as imagens de um documento do Word usando C
Você pode adicionar marca d’água de texto às imagens em documentos do Word seguindo as etapas abaixo:
- Primeiramente, carregue o arquivo DOCX usando a classe Watermarker.
- Crie uma instância da classe TextWatermark para criar uma marca d’água de texto. Passe o texto a ser mostrado como marca d’água e a fonte a ser usada para o texto da marca d’água usando a classe Font como parâmetros de entrada.
- Agora, defina várias propriedades da marca d’água, por exemplo, Cor do primeiro plano, Alinhamento, Ângulo de rotação, Fator de escala, etc.
- Em seguida, chame o método Watermarker.GetImages() para localizar todas as imagens no documento e obter resultados no objeto de classe WatermarkableImageCollection.
- Para cada imagem em WatermarkableImageCollection, adicione marca d’água chamando o método WatermarkableImage.Add() com o objeto TextWatermark.
- Finalmente, chame o método Watermarker.Save() para salvar o documento do Word com marca d’água.
O exemplo de código a seguir mostra como adicionar uma marca d’água de texto às imagens em um arquivo DOCX usando C#.
// Criar marca d'água
Watermarker watermarker = new Watermarker(@"C:\Files\Watermark\sample.docx");
// Marca d'água de texto do criador
TextWatermark watermark = new TextWatermark("Protected image", new Font("Arial", 8));
// Definir propriedades da marca d'água
watermark.ForegroundColor = Color.Black;
watermark.HorizontalAlignment = HorizontalAlignment.Center;
watermark.VerticalAlignment = VerticalAlignment.Center;
watermark.RotateAngle = 45;
watermark.SizingType = SizingType.ScaleToParentDimensions;
watermark.ScaleFactor = 1;
// Encontre todas as imagens no conteúdo.
WatermarkableImageCollection images = watermarker.GetImages();
// Adicione uma Marca D'água.
foreach (WatermarkableImage watermarkableImage in images)
{
watermarkableImage.Add(watermark);
}
// Salve o arquivo de saída
watermarker.Save(@"C:\Files\Watermark\AddWatermarkToImages_output.docx");
Adicionar marca d’água a páginas específicas em documentos do Word usando C#
Você pode adicionar marca d’água a uma página específica do documento do Word seguindo as etapas abaixo:
- Primeiramente, carregue o arquivo DOCX usando a classe Watermarker.
- Inicialize a fonte a ser usada para texto de marca d’água usando a classe Font.
- Crie uma instância da classe TextWatermark para criar uma marca d’água de texto. Passe o texto para mostrar como marca d’água e objeto de fonte definido como parâmetros de entrada.
- Agora, defina várias propriedades da marca d’água, como Cor do primeiro plano, Cor do plano de fundo, Alinhamento, etc.
- Crie uma instância da classe WordProcessingWatermarkPagesOptions
- Agora, defina o PageNumbers para adicionar a marca d’água. Você pode definir um único número de página ou uma lista de números de página separada por vírgulas. Definimos como WordProcessingContent.PageCount que indica a última página do documento aqui.
- Em seguida, chame o método Watermarker.Add() para adicionar a marca d’água definida.
- Finalmente, chame o método Watermarker.Save() para salvar o documento do Word com marca d’água.
O exemplo de código a seguir mostra como adicionar uma marca d’água de texto a uma página específica em um arquivo DOCX usando C#.
// Criar marca d'água
Watermarker watermarker = new Watermarker(@"C:\Files\Watermark\sample.docx");
// Criar marca d'água de texto
TextWatermark watermark = new TextWatermark("This is simple watermark!", new Font("Arial", 26));
// Definir propriedades da marca d'água
watermark.ForegroundColor = Color.Red;
watermark.BackgroundColor = Color.Blue;
watermark.TextAlignment = TextAlignment.Right;
watermark.HorizontalAlignment = HorizontalAlignment.Left;
watermark.VerticalAlignment = VerticalAlignment.Top;
// Adicionar marca d'água na última página
WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
WordProcessingWatermarkPagesOptions options = new WordProcessingWatermarkPagesOptions();
options.PageNumbers = new int[] { content.PageCount };
// Adicione uma Marca D'água
watermarker.Add(watermark, options);
// Salve o arquivo de saída
watermarker.Save(@"C:\Files\Watermark\AddToSpecificPage_output.docx");
Adicionar marca d’água ao cabeçalho ou rodapé de documentos do Word usando C#
Você pode adicionar uma marca d’água às seções de cabeçalho ou rodapé dos documentos do Word seguindo as etapas abaixo:
- Primeiramente, carregue o arquivo DOCX usando a classe Watermarker.
- Crie uma instância da classe ImageWatermark com o caminho da imagem para criar uma marca d’água de imagem.
- Em seguida, defina várias propriedades da marca d’água, como Alinhamento, Altura, Largura, etc.
- Crie uma instância da classe WordProcessingWatermarkSectionOptions.
- Agora, defina WordProcessingWatermarkSectionOptions.SectionIndex como 0 para adicionar marca d’água à primeira seção do documento.
- Em seguida, chame o método Watermarker.Add() para adicionar a marca d’água da imagem à primeira seção.
- Chame o método Watermarker.GetContent() para obter o conteúdo do documento carregado e obter resultados no objeto de classe WordProcessingContent.
- Percorra todas as seções e chame o método LinkToPrevious() com valor booleano verdadeiro como parâmetro de entrada. Ele vinculará todos os cabeçalhos e rodapés de todas as seções com a primeira seção.
- Finalmente, chame o método Watermarker.Save() para salvar o documento do Word com marca d’água.
O exemplo de código a seguir mostra como adicionar uma marca d’água a uma seção de cabeçalho ou rodapé em um arquivo DOCX usando C#.
// Criar marca d'água
Watermarker watermarker = new Watermarker(@"C:\Files\Watermark\sample.docx");
// Criar marca d'água de imagem
using (ImageWatermark watermark = new ImageWatermark(@"C:\Files\Watermark\logo.png"))
{
// Definir propriedades da marca d'água
watermark.Height = 100;
watermark.Width = 100;
watermark.HorizontalAlignment = HorizontalAlignment.Right;
// Adicionar marca d'água a todos os cabeçalhos da primeira seção
WordProcessingWatermarkSectionOptions options = new WordProcessingWatermarkSectionOptions();
options.SectionIndex = 0;
watermarker.Add(watermark, options);
}
// Vincule todos os outros cabeçalhos e rodapés aos cabeçalhos e rodapés correspondentes da primeira seção
WordProcessingContent content = watermarker.GetContent<WordProcessingContent>();
for (int i = 1; i < content.Sections.Count; i++)
{
content.Sections[i].HeadersFooters.LinkToPrevious(true);
}
// Salve o arquivo de saída
watermarker.Save(@"C:\Files\Watermark\AddWatermarkToHeadersFooters_output.docx");
Obtenha uma licença gratuita
Você pode experimentar a API sem limitações de avaliação solicitando uma licença temporária gratuita.
Conclusão
Neste artigo, você aprendeu como adicionar marca d’água de texto ou imagem nos documentos do Word usando C#. Além disso, você viu como adicionar marca d’água a uma página específica de um documento do Word programaticamente. Este artigo também explicou como adicionar marca d’água a imagens no arquivo DOCX usando C#. Além disso, você pode aprender mais sobre GroupDocs.Watermark para .NET API usando a documentação. Em caso de qualquer ambiguidade, não hesite em contactar-nos no fórum.