SetStructElemHeadersA

태그 지정 PDF, 접근성

설명

끝의 A는 ANSI(char) DLL 진입점을 나타내며, ActiveX/COM 인터페이스에서는 Unicode 형식만 노출됩니다. 동작은 SetStructElemHeaders와 동일하고 문자열 인수는 현재 SetAnsiMode 코드 페이지를 사용해 해석됩니다

태그 스택에서 현재 열려 있는 구조 요소에 /Headers 특성(Table 특성 소유자)을 설정합니다 이 특성은 현재 표 데이터 또는 머리글 셀을 요소 ID로 식별되는 하나 이상의 표 머리글 셀과 연결합니다 위치만으로 추론할 수 없는 복잡한 표 구조를 설명하는 데 사용합니다 BeginTag 또는 BeginTagEx 이후, EndTag 이전에 호출합니다

구문

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

매개변수

Headers	현재 TD 또는 TH 셀의 열 또는 행 머리글인 TH 셀 요소 ID의 쉼표 구분 목록입니다. 각 ID는 같은 문서에서 이전에 SetStructElemID를 통해 TH 요소에 할당한 ElemID와 일치해야 합니다. 쉼표 주변 공백은 무시합니다. 예: `TH-ProductName,TH-Price`

반환 값

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

비고

이 함수는 AddTagAttribute를 Owner=Table, Name=Headers, 그리고 같은 쉼표 구분 ID 목록을 Value로 지정해 호출하는 것과 같습니다. 속성은 PDF 텍스트 문자열의 /Headers 배열로 구조 요소의 /A 속성 사전에 기록됩니다

/Headers 속성은 ISO 32000-1 §14.8.5.7.2(Table 속성 소유자)에 정의되어 있습니다. 열 머리글이 데이터 셀 바로 위에 있는 단순한 표에서는 일반적으로 /Scope 속성을 SetStructElemScope로 설정하면 충분합니다. 셀 병합이나 다단계 머리글이 있는 불규칙한 표에는 /Headers를 사용합니다

PDF/UA-1(ISO 14289-1 §7.10)은 읽기 순서만으로 연결 관계를 결정할 수 없는 표에서 모든 TD 셀이 해당 머리글 셀과 명시적으로 연결되도록 요구합니다

예제

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

참고 항목

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode