Python使用Spire.Doc for Python实现给Word文档设置背景

pip install Spire.Doc

from spire.doc import *
from spire.doc.common import *

def SetGradientBackground():
    """为 Word 文档设置渐变背景"""
    inputFile = "./Data/Template_Docx_2.docx"
    outputFile = "SetGradientBackground.docx"
    
    # 创建 Word 文档对象并加载文件
    document = Document()
    document.LoadFromFile(inputFile)
    
    # 设置背景类型为渐变
    document.Background.Type = BackgroundType.Gradient
    
    # 获取渐变背景对象并设置颜色
    gradient = document.Background.Gradient
    gradient.Color1 = Color.get_White()      # 第一种颜色：白色
    gradient.Color2 = Color.get_LightBlue()  # 第二种颜色：浅蓝色
    
    # 设置渐变样式和变体
    gradient.ShadingVariant = GradientShadingVariant.ShadingDown  # 向下渐变
    gradient.ShadingStyle = GradientShadingStyle.Horizontal       # 水平方向
    
    # 保存文档
    document.SaveToFile(outputFile, FileFormat.Docx2013)
    document.Close()
    print(f"渐变背景文档已保存至: {outputFile}")

if __name__ == "__main__":
    SetGradientBackground()

from spire.doc import *
from spire.doc.common import *

def SetImageBackground():
    """为 Word 文档设置图片背景"""
    inputFile = "./Data/Template_Docx_2.docx"
    inputFile_Img = "./Data/Background.png"
    outputFile = "SetImageBackground.docx"
    
    # 加载 Word 文档
    document = Document()
    document.LoadFromFile(inputFile)
    
    # 设置背景类型为图片
    document.Background.Type = BackgroundType.Picture
    
    # 设置背景图片
    document.Background.SetPicture(inputFile_Img)
    
    # 保存文档
    document.SaveToFile(outputFile, FileFormat.Docx)
    document.Close()
    print(f"图片背景文档已保存至: {outputFile}")

if __name__ == "__main__":
    SetImageBackground()

import os
from spire.doc import *
from spire.doc.common import *

def BatchSetBackground(folder_path, background_type, **kwargs):
    """批量为文件夹中的所有 Word 文档设置背景"""
    for filename in os.listdir(folder_path):
        if filename.endswith('.docx') or filename.endswith('.doc'):
            file_path = os.path.join(folder_path, filename)
            
            document = Document()
            document.LoadFromFile(file_path)
            
            if background_type == "gradient":
                document.Background.Type = BackgroundType.Gradient
                gradient = document.Background.Gradient
                gradient.Color1 = kwargs.get('color1', Color.get_White())
                gradient.Color2 = kwargs.get('color2', Color.get_LightBlue())
                gradient.ShadingVariant = GradientShadingVariant.ShadingDown
                gradient.ShadingStyle = GradientShadingStyle.Horizontal
            
            elif background_type == "picture":
                document.Background.Type = BackgroundType.Picture
                document.Background.SetPicture(kwargs.get('image_path', ''))
            
            document.SaveToFile(file_path, FileFormat.Docx2013)
            document.Close()
            print(f"已处理: {filename}")

# 使用示例
# BatchSetBackground("./Documents", "gradient", 
#                   color1=Color.get_White(), 
#                   color2=Color.get_LightYellow())

from spire.doc import *
from spire.doc.common import *

class WordBackgroundManager:
    """Word 文档背景管理器"""
    
    def __init__(self, input_file):
        """初始化并加载文档"""
        self.document = Document()
        self.document.LoadFromFile(input_file)
        self.input_file = input_file
    
    def set_solid_color(self, color):
        """设置纯色背景"""
        self.document.Background.Type = BackgroundType.Color
        self.document.Background.Color = color
    
    def set_gradient(self, color1, color2, style=GradientShadingStyle.Horizontal,
                    variant=GradientShadingVariant.ShadingDown):
        """设置渐变背景"""
        self.document.Background.Type = BackgroundType.Gradient
        gradient = self.document.Background.Gradient
        gradient.Color1 = color1
        gradient.Color2 = color2
        gradient.ShadingStyle = style
        gradient.ShadingVariant = variant
    
    def set_image(self, image_path):
        """设置图片背景"""
        self.document.Background.Type = BackgroundType.Picture
        self.document.Background.SetPicture(image_path)
    
    def save(self, output_file):
        """保存文档"""
        self.document.SaveToFile(output_file, FileFormat.Docx2013)
        self.document.Close()
        print(f"文档已保存至: {output_file}")

# 使用示例
def main():
    input_file = "./Data/Template_Docx_2.docx"
    
    # 创建背景管理器实例
    manager = WordBackgroundManager(input_file)
    
    # 设置渐变背景
    manager.set_gradient(
        color1=Color.get_White(),
        color2=Color.get_LightCyan(),
        style=GradientShadingStyle.Vertical,
        variant=GradientShadingVariant.ShadingRight
    )
    
    # 保存结果
    manager.save("CustomGradientBackground.docx")

if __name__ == "__main__":
    main()