SetStructElemColSpan

태그 지정 PDF, 접근성

설명

현재 태그 스택에 열려 있는 구조 요소에 /ColSpan 특성(Table 특성 소유자)을 설정합니다. 이 값은 현재 표 셀이 걸치는 열의 수를 나타냅니다. AddTagAttribute를 Owner=Table, Name=ColSpan 및 문자열로 표현한 정숫값으로 호출하는 것과 같습니다

구문

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

매개변수

ColSpan	현재 표 셀이 차지하는 열 수입니다 양의 정수여야 합니다 값 1은 셀이 정확히 한 열을 차지한다는 뜻입니다(ColSpan을 설정하지 않았을 때의 기본 동작) 1보다 큰 값은 여러 열에 걸친 머리글 또는 데이터 셀을 나타냅니다

반환 값

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

비고

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

복잡한 테이블에는 두 데이터 열에 걸친 열 머리글처럼 여러 칸에 걸친 셀이 흔합니다. /ColSpan 속성을 제공하면 보조 기술이 셀 위치를 올바르게 계산하고 전체 테이블 그리드에서 머리글을 데이터 셀과 연결할 수 있습니다

셀이 여러 행에도 걸치면 SetStructElemRowSpan을 이 함수와 함께 사용합니다

예제

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

참고 항목

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag