Skip to content

背景

背景指文档页面的底层图层或底纹,用于呈现文档的基础视觉效果。添加背景可以改变文档的外观,使其更具个性化或专业性,可以用于强调品牌,保护版权,或提高文档的阅读体验。

在 PDF 文档中只能存在一个背景,对包含背景的文档页面添加背景会覆盖旧的背景。

设置颜色背景

设置颜色背景的步骤如下:

  1. 获取文档背景对象。

  2. 设置背景类型为颜色。

  3. 设置背景的属性。

  4. 将背景更新到文档上。

以下是设置颜色背景的示例代码:

C#
CPDFBackground background = document.GetBackground();
background.SetBackgroundType(C_Background_Type.BG_TYPE_COLOR);
background.SetColor(new byte[] { 255, 0, 0 });
background.SetOpacity(255);// 0-255
background.SetScale(1);// 1 == 100%
background.SetRotation(0);// 单位:弧度制
background.SetHorizalign(C_Background_Horizalign.BG_HORIZALIGN_CENTER);
background.SetVertalign(C_Background_Vertalign.BG_VERTALIGN_CENTER);
background.SetXOffset(0);
background.SetYOffset(0);
background.SetPages("0-2");
background.Update();

设置图片背景

设置图片背景的步骤如下:

  1. 获取文档背景对象。

  2. 设置背景类型为图片。

  3. 设置背景属性。

  4. 将背景更新到文档上。

以下是设置图片背景的代码:

C#
CPDFBackground background = document.GetBackground();
background.SetBackgroundType(C_Background_Type.BG_TYPE_IMAGE);
Bitmap bitmap = new Bitmap("logo.png");
background.SetImage(BitmapToByteArray(bitmap), bitmap.Width, bitmap.Height, ComPDFKit.Import.C_Scale_Type.fitCenter);
background.SetOpacity(128);// 0-255
background.SetScale(1);// 1 == 100%
background.SetRotation(1f);// 单位:弧度制
background.SetHorizalign(C_Background_Horizalign.BG_HORIZALIGN_CENTER);
background.SetVertalign(C_Background_Vertalign.BG_VERTALIGN_CENTER);
background.SetXOffset(0);
background.SetYOffset(0);
background.SetPages("0-2");
background.Update();

移除背景

移除背景的步骤如下:

  1. 获取文档背景对象。

  2. 删除文档背景。

以下是移除背景的代码:

C#
CPDFBackground background = document.GetBackground();
background.Clear();