PDFium Delphi Component Docs

InsertObjectAtIndex メソッド

コンポーネント: TPdf  ·  ユニット: PDFium
ページオブジェクトを上に追加するのではなく、描画順序の選択した位置に挿入します

構文

procedure InsertObjectAtIndex(StackIndex: Integer; PageObj: Pointer);

StackIndexInteger. Zero-based position in the content stream where the object is placed. Objects at or after this position move up by one.
PageObjPointer. Handle of a page object created but not yet inserted, such as the handle returned by ObjectHandle for an object detached with RemoveObject.

説明

ページオブジェクトはコンテンツストリーム順に描画されるため、オブジェクトが重なる場所では最後に描画されたオブジェクトが勝ちます。追加は常に新しいコンテンツを上に置きますが、このメソッドは任意の深さに配置します。既存のテキストの下に透かしを滑り込ませたり、削除して再追加したオブジェクトを積み直すために呼び出し側が必要とするものです

ページがオブジェクトの所有権を取得します。nil の受け渡しは無視され、基盤エントリポイントをエクスポートしない PDFium ビルドでの呼び出しも無視されるため、このメソッドは無条件に呼んでも安全です

キャッシュされたテキストページは破棄され、ページは変更済みとしてマークされます。保存前に UpdatePage を呼び出して、編集されたコンテンツストリームを再生成します

関連項目

RemoveObject, ObjectHandle, ObjectCount, UpdatePage