Link¶

어딘가(이 문서, 다른 문서, 인터넷)를 가리키는 포인터를 나타냅니다. 링크는 문서 페이지마다 존재하며, Page.first_link 속성으로 접근할 수 있는 초기 링크에서 시작하여 서로 순방향으로 연결됩니다.

링크와 해당 페이지 사이에는 부모-자식 관계가 있습니다. 페이지 객체가 사용 불가능해지면(문서 닫힘, 문서 구조 변경 등) 해당 페이지의 모든 기존 링크 객체도 사용 불가능해집니다 – 링크 속성이나 메서드에 접근할 때마다 객체가 “고아” 상태라는 예외가 발생합니다.

속성	간단한 설명
`Link.set_border()`	테두리 속성 수정
`Link.set_colors()`	색상 속성 수정
`Link.set_flags()`	링크 플래그 수정
`Link.border`	테두리 특성
`Link.colors`	테두리 선 색상
`Link.dest`	대상 세부 정보를 가리킴
`Link.is_external`	링크가 외부 대상인지 확인
`Link.flags`	링크 주석 플래그
`Link.next`	다음 링크를 가리킴
`Link.rect`	변환되지 않은 좌표에서 클릭 가능한 영역
`Link.uri`	링크 대상
`Link.xref`	항목의 `xref` 번호

클래스 API

class Link¶

set_border(border=None, width=0, style=None, dashes=None)¶

PDF 전용: 테두리 너비 및 점선 속성 변경.

(버전 1.16.9에서 변경됨) 딕셔너리를 사용하지 않고 지정을 허용합니다. border 가 딕셔너리가 아니면 직접 매개변수가 사용됩니다.

매개변수:

border (dict) – border 속성에 의해 반환되는 딕셔너리로, 키 “width” (float), “style” (str) 및 “dashes” (sequence)를 가집니다. 생략된 키는 해당 속성을 변경하지 않습니다. 예를 들어 점선을 제거하려면: “dashes”: [] 를 사용하세요. dashes가 빈 시퀀스가 아니면 “style”이 자동으로 “D”(점선)로 설정됩니다.
width (float) – 위를 참조하세요.
style (str) – 위를 참조하세요.
dashes (sequence) – 위를 참조하세요.

set_colors(colors=None, stroke=None)¶

PDF 전용: “stroke” 색상 변경.

참고

PDF에서 링크는 기술적으로 주석의 하위 유형이며 채우기 색상을 지원하지 않습니다. 그러나 일관된 API를 유지하기 위해 모든 주석과 마찬가지로 fill= 매개변수를 지정할 수 있지만 경고와 함께 무시됩니다.

(버전 1.16.9에서 변경됨) 색상을 직접 설정할 수 있도록 허용합니다. colors 가 딕셔너리가 아니면 이 매개변수가 사용됩니다.

매개변수:

colors (dict) – 색상 사양을 포함하는 딕셔너리. 허용되는 딕셔너리 키와 값은 아래를 참조하세요. 가장 실용적인 방법은 먼저 colors 속성의 복사본을 만든 다음 필요에 따라 이 딕셔너리를 수정하는 것입니다.
stroke (sequence) – 위를 참조하세요.

set_flags(flags)¶

v1.18.16에서 새로 추가됨

링크 주석의 PDF /F 속성을 설정합니다. 자세한 내용은 Annot.set_flags() 를 참조하세요. PDF가 아니면 이 메서드는 아무 작업도 수행하지 않습니다.

flags¶

v1.18.16에서 새로 추가됨

링크 주석 플래그를 반환합니다. 정수입니다(자세한 내용은 Annot.flags 참조). PDF가 아니면 0입니다.

colors¶

PDF에만 의미가 있음: 0 <= float <= 1 범위의 두 float 튜플 딕셔너리로 stroke 및 내부(fill) 색상을 지정합니다. PDF가 아니면 None 이 반환됩니다. 위에서 언급한 대로 링크의 채우기 색상은 항상 None 입니다. stroke 색상은 링크 사각형의 테두리에 사용됩니다. 튜플의 길이는 암시적으로 색 공간을 결정합니다: 1 = GRAY, 3 = RGB, 4 = CMYK. 따라서 (1.0, 0.0, 0.0) 은 RGB 색상 빨강을 나타냅니다. 각 float f 의 값은 계산 f = i / 255 를 통해 0에서 255 범위의 정수 값 i 에 매핑됩니다.

반환 형식:: dict

border¶

PDF에만 의미가 있음: 테두리 특성을 포함하는 딕셔너리. 비-PDF의 경우 None 이고 테두리 정보가 없으면 빈 딕셔너리입니다. 다음 키가 나타날 수 있습니다:

width – 포인트 단위의 테두리 두께를 나타내는 float. 너비가 지정되지 않으면 값은 -1.0입니다.
dashes – 선 점선 패턴을 지정하는 정수 시퀀스. [] 는 점선 없음을 의미하고, [n] 는 n 포인트의 동일한 on-off 길이를 의미하며, 더 긴 목록은 교대로 on-off 길이 값을 지정하는 것으로 해석됩니다. 자세한 내용은 Adobe PDF 참조 126페이지를 참조하세요.
style – 1바이트 테두리 스타일: S (Solid) = 주석을 둘러싸는 실선 사각형, D (Dashed) = 링크를 둘러싸는 점선 사각형, 점선 패턴은 dashes 항목으로 지정됨, B (Beveled) = 페이지 표면 위로 올라온 것처럼 보이는 시뮬레이션된 볼록한 사각형, I (Inset) = 페이지 표면 아래로 들어간 것처럼 보이는 시뮬레이션된 각인된 사각형, U (Underline) = 주석 사각형 하단을 따라가는 단일 선.

반환 형식:: dict

rect¶

변환되지 않은 좌표에서 클릭할 수 있는 영역.

유형:: Rect

is_external¶

링크 대상이 현재 문서 외부에 있는지 여부를 지정하는 bool입니다.

유형:: bool

uri¶

링크 대상을 지정하는 문자열입니다. 이 속성의 의미는 is_external 속성과 함께 평가해야 합니다:

is_external 이 true: uri 는 현재 PDF 외부의 대상을 가리키며, 인터넷 리소스(uri 가 http:// 또는 유사한 것으로 시작), 다른 파일(uri 가 “file:” 또는 “file://”로 시작) 또는 이메일 주소와 같은 기타 서비스(uri 가 mailto: 로 시작)일 수 있습니다.
is_external 이 false: uri 는 None 이거나 내부 위치를 가리킵니다. PDF 문서의 경우, 이것은 1부터 시작하는(!) 페이지 번호 nnnn 을 나타내는 #nnnn 이거나 이름이 지정된 위치여야 합니다. 형식은 다른 문서 유형에 따라 다릅니다. 예를 들어 XPS 문서의 페이지 번호 2(1부터 시작)의 경우 “../FixedDoc.fdoc#PG_2_LNK_1”입니다.

유형:: str

xref¶

PDF xref 를 지정하는 정수입니다. PDF가 아니면 0입니다.

유형:: int

next¶

다음 링크 또는 None.

유형:: Link

dest¶

링크 대상 세부 정보 객체.

유형:: linkDest

This software is provided AS-IS with no warranty, either express or implied. This software is distributed under license and may not be copied, modified or distributed except as expressly authorized under the terms of that license. Refer to licensing information at artifex.com or contact Artifex Software Inc., 39 Mesa Street, Suite 108A, San Francisco CA 94129, United States for further information.