PDFium Delphi Component Docs

SetPageObjectMarkParam 메서드

컴포넌트: TPdf  ·  유닛: PDFium

Syntax

procedure SetPageObjectMarkParam(Index, MarkIndex: Integer; const Param: TPdfContentMarkParam);

Description

네이티브 PDFium mark 핸들을 통해 기존 marked-content 항목에 속성 하나를 추가하거나 교체합니다

이 연산은 mark 이름, mark 순서, 네이티브 핸들, 관련 없는 모든 속성을 보존합니다

IndexMarkIndex는 0 기반이며 현재 페이지를 가리킵니다

Parameter values

Param.Key를 설정하고 Param.Kind에서 pmpInt, pmpFloat, pmpString, pmpBlob 중 하나를 고릅니다

일치하는 값 필드(IntValue, FloatValue, StringValue, BlobValue)만 읽힙니다

키는 PDF 이름이어야 하고 바이트 호환 비어 있지 않은 문자열이어야 하며 blob 값은 최소 한 바이트를 담아야 합니다

이미 있는 키는 값 종류가 바뀌어도 교체됩니다

Removing a parameter

procedure RemovePageObjectMarkParam(Index, MarkIndex: Integer; const Key: WString);

이름이 지정된 속성만 제거하고 marked-content 항목은 보존합니다

변경이 일어나지 않은 경우를 구별하기 위해 없는 키는 EPdfError를 발생시킵니다

Adding or removing a mark

AddPageObjectMark는 초기 형식화 속성 배열로 새 mark를 만들고 그 인덱스를 반환합니다

RemovePageObjectMark는 marked-content 항목 전체를 제거합니다

초기 파라미터 검증이 실패하면 새로 만들어진 mark가 롤백됩니다

Persistence and performance

성공한 변경마다 텍스트 페이지 캐시를 무효화하고 현재 페이지 콘텐츠를 한 번 재생성하므로 이후 저장에 갱신된 BDC 속성 목록이 담깁니다

PageObjectMarks를 즉시 읽으면 새 스냅샷을 얻을 수 있습니다

정수가 아닌 PDF number 값은 pmpFloat로 반환됩니다

See Also

고급 페이지 콘텐츠 API, GenerateTaggedLayout, StructureElements