Já discutimos maneiras de marcar diferentes documentos, imagens e apresentações. Hoje, discutiremos como adicionar marca d’água a uma pasta de trabalho do Excel de diferentes maneiras usando C# com o aplicativo .NET.
Os seguintes tópicos são abordados abaixo:
- API de marca d’água para .NET
- Adicionar Marca d’água de texto às planilhas do Excel
- Aplicar marca d’água a Planilha Excel específica
- Adicionar marca d’água à planilha do Excel como plano de fundo
.NET API para marcar planilhas do Excel com marca d’água
GroupDocs.Watermark fornece a API .NET para documentos e imagens de vários formatos de arquivo. Usaremos GroupDocs.Watermark for .NET para aplicar marcas d’água em planilhas de diferentes maneiras usando C#.
Você pode baixar o instalador de DLLs ou MSI na seção de downloads ou obtê-lo em NuGet.
Install-Package GroupDocs.Watermark
Folhas de Excel de marca d’água usando C
A API permite inserir texto nas planilhas como marca d’água com diferentes personalizações. A seguir estão as etapas para adicionar uma marca d’água a pastas de trabalho do Excel usando C# com os aplicativos .NET.
- Preparar as opções de carregamento da planilha.
- Carregue a planilha usando Watermarker.
- Defina o texto e a aparência da marca d’água usando TextWatermark.
- Adicione a marca d’água de texto à planilha do Excel usando o método Add.
- Salve a planilha resultante com marca d’água usando o método Save.
O exemplo de código C# a seguir aplica a marca d’água de texto a todas as planilhas da pasta de trabalho do Excel com rotação e opacidade.
/*
* Adicionar marca d'água a todas as planilhas da pasta de trabalho do Excel usando C#
*/
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
// Adicionar marca d'água de texto à planilha
TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
{
RotateAngle = -45,
Height = 200,
Width = 500,
Opacity = .2,
ForegroundColor = Color.DarkBlue
};
// Adicione marca d'água e salve a planilha com marca d'água.
watermarker.Add(textWatermark);
watermarker.Save(@"path/allpages-watermark-spreadsheet.xlsx");
}
Folha de Excel específica de marca d’água usando C
Da mesma forma, você pode aplicar marcas d’água apenas a qualquer planilha específica, em vez de aplicá-las a todas as planilhas da pasta de trabalho. As etapas a seguir orientam sobre como inserir marca d’água de texto na planilha específica da pasta de trabalho do Excel usando C#.
- Prepare as opções de carregamento.
- Carregue a planilha usando a classe Watermarker.
- Defina a aparência e o texto da marca d’água usando a classe TextWatermark.
- Defina o índice da planilha para que a marca d’água seja aplicada apenas na planilha mencionada.
- Adicione a marca d’água de texto à planilha do Excel usando o método Add com opções de marca d’água.
- Salve a planilha de saída com a marca d’água usando o método Save.
O trecho de código a seguir aplica a marca d’água de texto apenas à planilha mencionada da pasta de trabalho do Excel.
/*
* Adicione marca d'água apenas à planilha mencionada da pasta de trabalho do Excel usando C#
*/
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
// Adicionar marca d'água de texto à planilha
TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
{
RotateAngle = -45,
Height = 200,
Width = 500,
Opacity = .2,
ForegroundColor = Color.DarkBlue
};
// Definir o índice da planilha
SpreadsheetWatermarkShapeOptions textWatermarkOptions = new SpreadsheetWatermarkShapeOptions()
{
WorksheetIndex = 1
};
// Adicione marca d'água e salve a planilha com marca d'água.
watermarker.Add(textWatermark, textWatermarkOptions);
watermarker.Save(@"path/onepage-watermark-spreadsheet.xlsx");
}
Folhas de Excel de marca d’água como plano de fundo usando C
Da mesma forma, também podemos adicionar marcas d’água como plano de fundo da planilha. Haverá uma pequena mudança nas técnicas acima de aplicação de marcas d’água. A seguir estão as etapas que permitem inserir marca d’água de texto em segundo plano na planilha do Excel usando C#.
- Preparar as opções de carregamento para planilha de carregamento.
- Carregue a planilha usando Watermarker.
- Defina o texto e a aparência da marca d’água (rotação, posição, dimensões, opacidade, cor e mais) usando TextWatermark.
- Defina as opções de marca d’água de fundo obtendo conteúdo e definindo dimensões.
- Defina o índice da planilha para aplicar marca d’água. (Opcional)
- Adicione a marca d’água à planilha usando o método Add.
- Salve a planilha com marca d’água usando o método Save.
O exemplo de código a seguir mostra como adicionar uma marca d’água em segundo plano a uma planilha do Excel usando C# no aplicativo .NET.
/*
* Adicionar marca d'água como plano de fundo à pasta de trabalho do Excel usando C#
*/
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
using (Watermarker watermarker = new Watermarker(@"path/spreadsheet.xlsx", loadOptions))
{
// Definir a aparência da marca d'água
TextWatermark textWatermark = new TextWatermark("DRAFT", new Font("Arial", 100))
{
RotateAngle = -45,
X = 200,
Y = 200,
Height = 200,
Width = 500,
Opacity = .2,
ForegroundColor = Color.DarkBlue
};
// Obter dimensões do conteúdo da planilha
SpreadsheetContent content = watermarker.GetContent<SpreadsheetContent>();
SpreadsheetBackgroundWatermarkOptions options = new SpreadsheetBackgroundWatermarkOptions();
options.BackgroundWidth = content.Worksheets[0].ContentAreaWidthPx; /* set background width */
options.BackgroundHeight = content.Worksheets[0].ContentAreaHeightPx; /* set background height */
options.WorksheetIndex = 0;
// Adicione marca d'água e salve a planilha com marca d'água.
watermarker.Add(textWatermark, options);
watermarker.Save(@"path/background-watermark-spreadsheet.xlsx");
}
Obtenha uma licença de API gratuita
Você pode obter uma licença temporária gratuita para usar a API sem as limitações de avaliação.
Conclusão
Para resumir, discutimos diferentes maneiras de adicionar marca d’água a planilhas do Excel usando C#. Primeiro, adicionamos marcas d’água de texto a todas as planilhas da pasta de trabalho do Excel. Em seguida, aplicamos a marca d’água apenas na planilha específica. Por fim, inserimos a marca d’água baseada em texto na pasta de trabalho do Excel como plano de fundo.
Visite a documentação do produto para saber mais sobre a API. Para dúvidas, entre em contato conosco através do fórum.