AddTagAttributeA

태그 지정 PDF, 접근성

설명

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

태그 스택에서 현재 구성 중인 구조 요소에 이름이 지정된 속성을 추가합니다. 문서 저장 시 속성은 PDF /A 속성 사전 또는 사전 배열로 기록됩니다. BeginTag 또는 BeginTagEx 호출 후, EndTag 호출 전에 사용합니다

구문

Delphi

Function DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;

DLL

int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * Value);

매개변수

Owner	ISO 32000-1 Table 348에서 정의한 특성 소유자 이름(예: `Layout`, `Table`, `List`, `PrintField`)입니다. 특성 사전의 `/O` 키가 됩니다
Name	지정한 소유자의 속성 이름입니다(예: Layout의 `BBox`, Table의 `Scope`). 비어 있으면 안 됩니다
Value	문자열 형식의 속성 값입니다. 공백으로 구분된 숫자만 포함한 값(예: `"0 0 200 100"`)은 PDF 실수 배열로 기록됩니다. 그 밖의 값은 선행 `/` 없이 PDF 이름 객체로 기록됩니다. 비어 있으면 안 됩니다

반환 값

성공하면 1을 반환합니다. 열린 문서가 없거나 현재 열린 태그가 없거나 Owner 또는 Name이 비어 있으면 0을 반환합니다

비고

같은 열린 태그에 대한 여러 AddTagAttribute 호출은 누적됩니다. 속성이 한 소유자에 속하면 라이브러리는 단일 /A 속성 사전을 기록합니다. 여러 소유자를 사용하면 소유자별로 속성을 그룹화하여 속성 사전 배열로 기록합니다

공통 속성에는 편의 래퍼 SetStructElemScope와 SetStructElemBBox를 사용하여 AddTagAttribute 직접 호출을 대신할 수 있습니다

새 태그를 열면 특성이 재설정되며 하위 요소에 상속되지 않습니다

예제

// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;

// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;

참고 항목

BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox