SetStructElemListNumberingA

태그 지정 PDF, 접근성

설명

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

현재 태그 스택에서 열려 있는 구조 요소에 /ListNumbering 속성(List 속성 소유자)을 설정합니다. 값은 L(목록) 구조 요소의 항목에 사용하는 마커 또는 번호 체계를 선언하여 보조 기술이 목록 형식을 올바르게 알릴 수 있게 합니다. AddTagAttribute를 Owner=List, Name=ListNumbering, 체계 이름을 값으로 지정하여 호출하는 것과 같습니다

구문

Delphi

Function DLSetStructElemListNumberingA(InstanceID: Integer; Numbering: PAnsiChar): Integer;

DLL

int DLSetStructElemListNumberingA(int InstanceID, const char * Numbering);

매개변수

Numbering목록 번호 매기기 방식입니다. 다음 값 중 하나여야 합니다(대소문자 구분):

None — 표시되는 표식 없음(특성이 없을 때 기본값)
Disc — 채운 원(•)
Circle — 빈 원(○)
Square — 채운 사각형(■)
Decimal — 1, 2, 3 …
UpperRoman — I, II, III …
LowerRoman — i, ii, iii …
UpperAlpha — A, B, C …
LowerAlpha — a, b, c …

반환 값

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

비고

BeginTag를 태그 형식 L(목록)로 호출한 후 EndTag 전에 이 함수를 호출합니다. /ListNumbering 속성은 ISO 32000-1 §14.8.5.3.2(List 속성 소유자, Table 336)에 정의되어 있습니다

속성은 이를 포함하는 L 요소에 적용되며 개별 LI 항목에는 적용되지 않습니다. L 요소를 연 직후 한 번 설정합니다. 이 속성은 권고 정보로서 실제 PDF 렌더러가 어떤 시각적 표시 글리프를 그렸는지와 관계없이 보조 기술이 목록 종류를 이해하여 "글머리 기호 목록", "번호 목록" 등으로 안내할 수 있게 합니다

목록에 명시적인 번호 체계가 없으면(예: 시각적 글머리표가 없는 일련의 용어) None을 사용하거나 속성을 완전히 생략합니다

예제

// An ordered decimal list
PDFlib.BeginTag('L', '', '', '');
PDFlib.SetStructElemListNumbering('Decimal');

  PDFlib.BeginTag('LI', '', '', '');
    PDFlib.BeginTag('Lbl', '', '', '');
    PDFlib.DrawText('1.', 72, 700);
    PDFlib.EndTag;
    PDFlib.BeginTag('LBody', '', '', '');
    PDFlib.DrawText('First item', 90, 700);
    PDFlib.EndTag;
  PDFlib.EndTag;

  PDFlib.BeginTag('LI', '', '', '');
    PDFlib.BeginTag('Lbl', '', '', '');
    PDFlib.DrawText('2.', 72, 680);
    PDFlib.EndTag;
    PDFlib.BeginTag('LBody', '', '', '');
    PDFlib.DrawText('Second item', 90, 680);
    PDFlib.EndTag;
  PDFlib.EndTag;

PDFlib.EndTag; // L

참고 항목

SetStructElemExpansion, AddTagAttribute, BeginTag, EndTag, GetPDFUADiagnostics