注釈とネイティブテキスト

対応する PDF 注釈を挿入し、インポートしたネイティブテキストを編集可能なテキストボックスに昇格します。

編集可能な注釈は永続オーバーレイです。インポートしたテキストは、表示中のテキスト範囲を Facade で昇格するまでネイティブのままです。

注釈を挿入する

TypeScript
const highlight = page.insertAnnotation({  annotationType: univerAPI.Enum.PdfAnnotationType.HIGHLIGHT,  left: 36,  top: 72,  width: 180,  height: 18,  markup: {    color: '#fde047',    opacity: 0.6,  },})

Facade から挿入できるのは、ハイライト、下線、取り消し線、波線、インク注釈です。インクには空でないパスが必要です。コアのその他の注釈サブタイプはこの API では挿入できません。

注釈のデータとスタイルを取得する

TypeScript
const markup = highlight.getMarkup()const style = highlight.getStyle()highlight.setStyle({  stroke: { color: '#ca8a04', width: 1 },  opacity: 0.75,})

getMarkup() と getInk() は PDF ポイントの切り離された形状を返します。setStyle() は対応する塗り、線、透明度を更新します。透明度は 0 から 1 です。

インポートしたネイティブテキストを置き換える

TypeScript
const matchingSpan = page  .getTextSpans()  .find((span) => span.getText().includes('Draft'))if (matchingSpan) {  const textBox = matchingSpan.replaceText('Final')  textBox.setTextStyle({ bold: true })}

getTextSpans() は、現在表示され抑制されていないネイティブテキストのスナップショットを返します。replaceText() はソース操作を不可分に抑制し、取得した位置に編集可能な FPdfTextBox を挿入します。

FPdfTextSpan はスナップショットハンドルです。置き換え後は無効になるため、次の操作前に getTextSpans() を再度列挙してください。

このガイドはいかがですか?

© 2026 DreamNum Co., Ltd.