SetStructElemScopeA

태그 지정 PDF, 접근성

설명

끝의 A는 ANSI(char) DLL 진입점을 나타내며 ActiveX/COM 표면에는 Unicode 형식만 제공됩니다. 동작은 SetStructElemScope와 동일하며 문자열 인수는 현재 SetAnsiMode 코드 페이지를 사용하여 해석됩니다

태그 스택에서 현재 열린 구조 요소에 /Scope 속성(Table 속성 소유자)을 설정합니다. 범위는 TH(표 머리글) 셀이 열, 행 또는 둘 다에 적용되는지를 식별하며 머리글 셀이 있는 표에서 PDF/UA-1이 요구합니다. AddTagAttribute를 Owner=Table, Name=Scope 및 값으로 범위 이름을 지정하여 호출하는 것과 같습니다

구문

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

매개변수

Scope	헤더 셀의 범위입니다. 다음 값 중 하나여야 합니다(대/소문자 구분): Column — 헤더가 열의 모든 셀에 적용됨 Row — 헤더가 행의 모든 셀에 적용됨 Both — 헤더가 열과 행 모두에 적용됨

반환 값

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

비고

BeginTag를 태그 형식 TH로 호출한 후 EndTag 전에 이 함수를 호출합니다. /Scope 특성은 ISO 32000-1 §14.8.5.7.2(Table 특성 소유자)에 정의되어 있습니다

PDF/UA-1(ISO 14289-1 §7.10)에서는 표 머리글 셀이 데이터 셀과 명확하게 연결되어야 합니다. 표 레이아웃에서 허용한다면 /Scope 속성을 제공하는 것이 권장되는 방식입니다

예제

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

참고 항목

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode