SetStructElemColor

태그 지정 PDF, 접근성

설명

태그 스택에서 현재 열려 있는 구조 요소에 /Color 특성(Layout 특성 소유자)을 설정합니다. 값은 요소 콘텐츠의 전경색(텍스트 또는 스트로크)을 RGB 삼중값으로 지정합니다. AddTagAttribute를 Owner=Layout, Name=Color, 공백으로 구분된 R G B 문자열로 호출하는 것과 같습니다

구문

Delphi

Function TPDFlib.SetStructElemColor(R, G, B: Double): Integer;

ActiveX

Function PDFlib::SetStructElemColor(R As Double, G As Double, B As Double) As Long

DLL

int DLSetStructElemColor(int InstanceID, double R, double G, double B);

매개변수

R	색상의 빨간색 성분으로, 범위는 0.0(빨간색 없음)부터 1.0(완전한 빨간색)까지입니다
G	색상의 초록 성분이며 범위는 0.0~1.0
B	0.0부터 1.0 범위의 파란색 성분

반환 값

성공하면 1을 반환합니다. 열린 문서가 없거나 태그 스택에 현재 열린 태그가 없으면 0을 반환합니다

비고

BeginTag 또는 BeginTagEx 이후, EndTag 이전에 이 함수를 호출합니다 /Color 특성은 ISO 32000-1 §14.8.5.4.2(Layout 특성 소유자, Table 340)에 정의되며 숫자 세 개로 구성된 PDF 배열로 저장됩니다

이 특성은 보조 기술 또는 리플로 엔진이 인식하는 요소의 전경색을 설명합니다. 이는 권고 정보이며 PDF에 렌더링되는 시각적 색상은 이 특성이 아니라 그래픽 상태에 의해 제어됩니다. 그러나 정확한 색상 정보를 제공하면 후속 도구가 색상 대비 비율(WCAG 2.x Success Criterion 1.4.3)을 확인하고 콘텐츠 리플로 시 충실도를 유지할 수 있음

일반적인 색상 값: 검은색 = (0.0, 0.0, 0.0); 흰색 = (1.0, 1.0, 1.0); 빨간색 = (1.0, 0.0, 0.0)

예제

// Tag a heading rendered in dark blue
PDFlib.BeginTag('H2', '', '', '');
PDFlib.SetStructElemColor(0.0, 0.18, 0.39);  // RGB for dark blue
PDFlib.DrawText('Section 2', 72, 700);
PDFlib.EndTag;

참고 항목

SetStructElemEndIndent, SetStructElemBBox, AddTagAttribute, BeginTag, EndTag