SetStructElemSpaceBefore

태그 지정 PDF, 접근성

설명

현재 태그 스택에서 열려 있는 구조 요소에 /SpaceBefore 속성(Layout 속성 소유자)을 설정합니다. 값은 블록 수준 요소 앞에 추가할 공간의 양을 지정하며 CSS margin-top 또는 padding-top과 유사합니다. AddTagAttribute를 Owner=Layout, Name=SpaceBefore, 숫자 값을 문자열로 지정하여 호출하는 것과 같습니다

구문

Delphi

Function TPDFlib.SetStructElemSpaceBefore(Space: Double): Integer;

ActiveX

Function PDFlib::SetStructElemSpaceBefore(Space As Double) As Long

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

매개변수

Space	기본 사용자 공간 단위(포인트, 1/72인치)로 나타낸 요소 앞 간격. 음수가 아닌 값이어야 합니다. 0은 요소 앞에 추가 간격이 없음을 의미합니다

반환 값

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

비고

BeginTag 또는 BeginTagEx 이후, EndTag 이전에 이 함수를 호출합니다 /SpaceBefore 특성은 ISO 32000-1 §14.8.5.4.2(Layout 특성 소유자, Table 340)에 정의되어 있습니다

레이아웃 속성(SpaceBefore, SpaceAfter, StartIndent, EndIndent)은 권고 사항으로 리플로 및 내보내기 엔진에서 의도한 시각적 레이아웃을 설명합니다(예: PDF를 HTML 또는 EPUB로 리플로할 때). 이러한 속성은 PDF 자체의 렌더링된 모양에는 영향을 주지 않습니다. 정확한 레이아웃 속성을 제공하면 접근성 도구의 리플로 출력 품질이 향상됩니다

예제

// Tag a heading with extra space above it
PDFlib.BeginTag('H1', '', '', '');
PDFlib.SetStructElemSpaceBefore(12.0);  // 12 pt above the heading
PDFlib.DrawText('Introduction', 72, 700);
PDFlib.EndTag;

참고 항목

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute