如何用iText在PDF特定元素或文本末尾插入图片？求元素搜索方法

因找不到iText的合适文档，仅能获取API参考，故提出以下问题：是否可仅通过iText获取元素或文本位置后，在PDF中添加图片？我当前使用正则定位策略找到页面文本末尾，但想知道是否可直接搜索元素，而非用".*"正则遍历所有PdfTextLocation，相关代码如下：

var regex = new Regex(".*");
var strat = new RegexBasedLocationExtractionStrategy(regex);

PdfCanvasProcessor pdfCanvasProcessor = new PdfCanvasProcessor(strat);
pdfCanvasProcessor.ProcessPageContent(page);

var locs = strat.GetResultantLocations();

var rect = locs.OrderBy(r => r.GetRectangle().GetY()).FirstOrDefault();
var x = rect?.GetRectangle().GetX() ?? 0;
var y = rect?.GetRectangle().GetY() ?? 0;

核心问题解答 #

1. 能通过iText获取位置后添加图片吗？ #

当然可以。iText完全支持先定位文本或元素的坐标，再基于这些坐标在PDF指定位置插入图片，步骤如下：

• 用文本定位策略（比如你用的RegexBasedLocationExtractionStrategy）获取目标位置的矩形坐标；
• 创建PdfCanvas对象操作目标页面的内容流；
• 调用AddImage方法，结合坐标设置图片的位置和尺寸。

基于你现有代码的扩展示例：

// 假设已获取到目标rect
if (rect != null) {
    PdfCanvas canvas = new PdfCanvas(page.NewContentStreamBefore(), page.GetResources(), pdfDocument);
    // 加载目标图片
    ImageData imageData = ImageDataFactory.Create("your-image-path.png");
    // 按需调整图片尺寸（这里按50%缩放）
    float scaledWidth = imageData.GetWidth() * 0.5f;
    float scaledHeight = imageData.GetHeight() * 0.5f;
    // 在rect的左下角位置插入图片（可根据需求调整坐标原点）
    canvas.AddImage(imageData, rect.GetRectangle().GetX(), rect.GetRectangle().GetY(), scaledWidth, false);
}

2. 能直接搜索元素，不用.*正则遍历吗？ #

可以不用.*这种全匹配正则。RegexBasedLocationExtractionStrategy本身支持针对特定文本内容的正则匹配，比如你要定位页面末尾的特定文本，直接写对应的正则表达式，这样只会返回匹配该文本的PdfTextLocation，无需遍历所有文本位置。

如果需要更灵活的元素定位（比如按文本块、段落或布局特征筛选），可以自定义LocationExtractionStrategy：

• 继承LocationExtractionStrategy抽象类；
• 重写EventOccurred方法，在处理PDF内容时捕获文本的渲染信息（内容、字体、位置等）；
• 自定义筛选逻辑，直接提取目标元素的位置。

自定义策略示例框架：

public class CustomLocationStrategy : LocationExtractionStrategy {
    private readonly List<PdfTextLocation> _targetLocations = new List<PdfTextLocation>();

    public override void EventOccurred(IEventData data, EventType type) {
        if (type == EventType.RENDER_TEXT) {
            TextRenderInfo renderInfo = (TextRenderInfo)data;
            string text = renderInfo.GetText();
            // 自定义筛选条件：比如匹配页面末尾的特定标识文本
            if (text.EndsWith("文档末尾标识")) {
                Rectangle textRect = renderInfo.GetDescentLine().GetBoundingRectangle();
                _targetLocations.Add(new PdfTextLocation(0, textRect, text));
            }
        }
    }

    public override ICollection<PdfTextLocation> GetResultantLocations() {
        return _targetLocations;
    }

    // 重写其他必要方法
    public override string GetResultantText() {
        return string.Join("\n", _targetLocations.Select(loc => loc.GetText()));
    }
}

使用时替换原策略即可：

var strat = new CustomLocationStrategy();
PdfCanvasProcessor pdfCanvasProcessor = new PdfCanvasProcessor(strat);
pdfCanvasProcessor.ProcessPageContent(page);
var locs = strat.GetResultantLocations();

内容的提问来源于stack exchange，提问作者leryler