PDFium Delphi Component Docs

WebLink 속성

컴포넌트: TPdf  ·  유닛: PDFium
페이지에서 자동 탐지된 웹 링크의 URL과 바운딩 사각형입니다

Syntax

property WebLink[PageNumber, Index: Integer]: TWebLink; // read only

Description

WebLink는 지정된 1 기반 PageNumber와 0 기반 Index에서 탐지된 URL의 TWebLink 레코드를 반환합니다. 레코드에는 Url 문자열(보통 http://, https://, 또는 mailto:), TPdfRectangle 바운딩 박스의 Rectangles 배열 — URL 하나가 여러 줄로 줄 바꿈되면 PDFium이 줄마다 별도의 사각형을 보고하므로 시각적 줄마다 사각형이 하나씩입니다 — 그리고 링크가 커버하는 텍스트 페이지 문자 범위인 StartCharIndex와 CharCount가 들어 있습니다

Index는 0부터 WebLinkCount[PageNumber] - 1까지입니다. 범위 밖이면 PDFium은 빈 레코드를 반환합니다(Url이 비고 Rectangles가 nil). 웹 링크 탐색은 주어진 페이지를 처음 읽을 때 지연 실행되고 페이지가 다시 로드될 때까지 캐시됩니다. 스캔이 끝난 뒤 WebLink를 읽는 것 자체는 O(1)입니다

WebLink는 PDF 작성자가 선언한 명시적 /Link 어노테이션을 드러내는 LinkAnnotation과 상호 보완적입니다. 사각형을 사용해 커스텀 렌더러 위에 클릭 오버레이를 만들거나 추출된 텍스트에서 URL을 강조하세요. 데이터는 읽기 전용입니다 — PDFium Delphi Component는 탐지 결과를 노출할 뿐 수정 프리미티브는 제공하지 않습니다. 실제 링크 어노테이션을 삽입하려면 기반 Page 핸들에서 FPDFPage_CreateAnnot 경로를 사용하세요

Remarks

Example

var Link: TWebLink;
var I: Integer;
for I := 0 to Pdf1.WebLinkCount[1] - 1 do
begin
  Link := Pdf1.WebLink[1, I];
  Memo1.Lines.Add(Format('%s  (%d rects)',
    [Link.Url, Length(Link.Rectangles)]));
end;

See Also

WebLinkCount, LinkAnnotation, TPdfView.OnWebLinkClick, TPdfView.LinkOptions