Find

在此范围内查找给定文本的第一个匹配项，并将其作为新的 ApiTextRange 返回。如果未找到文本，则返回 null。

语法

expression.Find(findWhat, after, matchCase, wholeWords);

expression - 表示 ApiTextRange 类的变量。

参数

名称	必需/可选	数据类型	默认值	描述
findWhat	必需	string		要搜索的文本。
after	可选	number	1	在此范围内开始搜索的位置（从 1 开始）。
matchCase	可选	boolean	false	区分大小写搜索。
wholeWords	可选	boolean	false	仅匹配整个单词。

返回值

ApiTextRange | null

示例

在 PDF 页面的形状中在文本范围内查找单词。

// The result is a range that covers exactly the match.

// Paint the match red and report where it starts.

const doc = Api.GetDocument();
const page = doc.GetPage(0);

const fill = Api.CreateSolidFill(Api.RGB(255, 111, 61));
const stroke = Api.CreateStroke(0, Api.CreateNoFill());
const shape = Api.CreateShape("rect", 200 * 36000, 80 * 36000, fill, stroke);
shape.SetPosition(608400, 1267200);
page.AddObject(shape);

const docContent = shape.GetContent();
const paragraph = docContent.GetElement(0);
paragraph.AddText("alpha TARGET omega");

const range = shape.GetTextRange();

const found = range.Find("TARGET");
found.SetColor(Api.RGB(255, 0, 0));

const reportFill = Api.CreateSolidFill(Api.RGB(200, 230, 255));
const report = Api.CreateShape("rect", 200 * 36000, 40 * 36000, reportFill, stroke);
report.SetPosition(608400, 4000000);
page.AddObject(report);
report.GetContent().GetElement(0).AddText("Find: " + found.GetStartPos());