SetStructElemAltTextA

Tagged PDF & 접근성

설명

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

태그 스택에서 현재 작성 중인 구조 요소에 /Alt 항목을 설정합니다 대체 텍스트는 이미지, 그림 또는 수학 수식처럼 요소를 시각적으로 렌더링할 수 없을 때 보조 기술(화면 판독기, 점자 디스플레이)이 사용자에게 제공하는 텍스트 설명입니다

이 함수는 비어 있지 않은 AltText 인수를 BeginTag 또는 BeginTagEx에 전달하는 것과 같지만 요소를 연 뒤 대체 텍스트를 설정하거나 업데이트할 수 있습니다. 요소 형식을 확인한 뒤 설명을 비동기로 계산하거나 가져올 때 유용합니다

구문

Delphi

Function DLSetStructElemAltTextA(InstanceID: Integer; AltText: PAnsiChar): Integer;

DLL

int DLSetStructElemAltTextA(int InstanceID, const char * AltText);

매개변수

반환 값

성공하면 1, 현재 열린 구조 요소가 없거나 문서를 선택하지 않았으면 0을 반환함

비고

대상 요소가 태그 스택 맨 위에 있을 때 BeginTag 직후 또는 일치하는 EndTag 호출 전 어느 시점에든 이 함수를 호출합니다

AltText와 ActualText는 용도가 다릅니다. AltText는 전체 요소의 완전한 텍스트 대체물로, 렌더링 결과를 인지할 수 없는 사용자를 위해 시각 콘텐츠를 대체합니다. ActualText(ISO 32000-1 §14.9.4)는 추출 텍스트가 부정확할 수 있는 인라인 글리프의 정확한 Unicode 문자 시퀀스를 제공하며 렌더링은 대체하지 않습니다. 화면 판독기는 보통 Figure와 Formula 요소에서는 AltText를 읽고 문자 수준 수정에는 ActualText를 사용합니다

ISO 32000-1 §14.9.3은 /Alt 항목을 정의합니다. PDF/UA-1(ISO 14289-1 §7.5)은 Figure 및 Formula 구조 요소에 대체 설명을 요구합니다. GetPDFUADiagnostics는 Figure 또는 Formula 요소에 Alt 텍스트가 없으면 FIGURE-NO-ALT:N 문제 코드를 보고합니다

예제

// Tag an embedded chart image with alternative text
PDFlib.BeginTag('Figure', '', '');
PDFlib.SetStructElemAltText('Bar chart: Q1 sales 120, Q2 sales 145, Q3 sales 98');
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

참고 항목

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics