ReplaceTagA
페이지 조작
설명
끝의 A는 ANSI(char) DLL 진입점을 나타내며 ActiveX/COM 표면은 Unicode 형식만 노출합니다. 동작은 ReplaceTag와 동일하고 문자열 인수는 현재 SetAnsiMode 코드 페이지를 사용해 해석됩니다
현재 선택한 페이지의 텍스트 콘텐츠에서 리터럴 찾기 및 대체를 수행합니다. 페이지의 텍스트 표시 연산자에 있는 Tag의 모든 항목을 NewValue로 대체하고 연산자 스트림을 제자리에서 다시 씁니다. 수행한 대체 수를 반환합니다
태그 지정 PDF(구조 트리) 태깅과 관련 없는 콘텐츠 스트림 수준 작업입니다. 해당 용도에는 BeginTag/EndTag를 사용합니다. ReplaceTag는 자리 표시자 토큰(예: {{customer-name}})을 템플릿 PDF에 미리 그리고 코드에서 채우는 양식 편지 스타일 템플릿용입니다
구문
Delphi
Function DLReplaceTagA(InstanceID: Integer; Tag, NewValue: PAnsiChar): Integer;DLL
int DLReplaceTagA(int InstanceID, const char * Tag, const char * NewValue);매개변수
| Tag | 페이지의 텍스트 콘텐츠에서 검색할 리터럴 문자열입니다. 일치는 대소문자를 구분하고 현재 선택한 페이지에만 적용되므로 여러 페이지 템플릿을 처리할 때는 페이지마다 한 번씩 호출하십시오 |
|---|---|
| NewValue | 대체 문자열입니다. Tag보다 길거나 짧을 수 있습니다. 주변 레이아웃은 다시 배치되지 않으므로 매우 큰 대체 문자열은 원래 열을 벗어날 수 있습니다 |
반환 값
선택한 페이지에서 Tag를 찾아 바꾼 횟수입니다. 0은 일치 항목을 찾지 못했거나 선택된 페이지가 없음을 의미합니다
비고
텍스트 표시 연산자 안의 텍스트(Tj, TJ, ', ")만 검색합니다. 커닝되었거나 여러 연산자로 분할된 자리 표시자는 일치하지 않을 수 있으므로 템플릿 자리 표시자를 짧게 유지하고 하나의 문자열로 그리십시오. 이 함수는 주석 콘텐츠, 양식 필드 값 또는 포함 파일을 검색하지 않음
실제 콘텐츠에 나타날 가능성이 낮은 자리표시자 구문을 선택합니다. 예: {{name}}, <<Customer>>, ~~SKU~~
예제
// Fill in a single-page invoice template
PDF.LoadFromFile('invoice-template.pdf', '');
PDF.SelectPage(1);
PDF.ReplaceTag('{{customer-name}}', 'Alice Smith');
PDF.ReplaceTag('{{invoice-no}}', 'INV-2026-0042');
PDF.ReplaceTag('{{total}}', '$1,234.56');
PDF.SaveToFile('invoice-INV-2026-0042.pdf');
// Multi-page template: iterate over pages
for I := 1 to PDF.GetPageCount do
begin
PDF.SelectPage(I);
PDF.ReplaceTag('{{customer-name}}', CustomerName);
end;