ReplaceTagA
Paginamanipulatie
Beschrijving
Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan ReplaceTag en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel
Voert een letterlijke zoeken-en-vervangen uit op de tekstinhoud van de momenteel geselecteerde pagina. Elke keer dat Tag in de tekstweergave-operators van de pagina voorkomt wordt vervangen door NewValue en de operatorstream wordt ter plekke herschreven. Geeft het aantal uitgevoerde vervangingen terug
This is a content-stream level operation that does not relate to tagged PDF (structure tree) tagging — use BeginTag/EndTag for that. ReplaceTag is intended for form-letter style templates where placeholder tokens (for example {{customer-name}}) are pre-drawn into a template PDF and then filled in by code.
Syntaxis
Delphi
Function DLReplaceTagA(InstanceID: Integer; Tag, NewValue: PAnsiChar): Integer;DLL
int DLReplaceTagA(int InstanceID, const char * Tag, const char * NewValue);Parameters
| Tag | De letterlijke string die in de tekstinhoud van de pagina moet worden gezocht. De match is hoofdlettergevoelig en geldt alleen voor de momenteel geselecteerde pagina — roep één keer per pagina aan bij het verwerken van een Meerpagina-template |
|---|---|
| NewValue | De vervangende string. Mag langer of korter zijn dan Tag; de omliggende layout wordt niet opnieuw uitgelegd, dus zeer grote vervangingen kunnen voorbij de oorspronkelijke kolom lopen |
Retourwaarde
Het aantal keren dat Tag op de geselecteerde pagina is gevonden en vervangen. Nul betekent dat er geen voorkomsten zijn gevonden (of er is geen pagina geselecteerd)
Opmerkingen
Er wordt alleen gezocht in tekst binnen tekstweergave-operators (Tj, TJ, ', "). Placeholders die zijn gekernd of over meerdere operators zijn gesplitst matchen mogelijk niet — houd templateplaceholders kort en teken ze als één string. De functie doorzoekt geen annotatie-inhoud, formulierveldwaarden of ingesloten bestanden
Choose placeholder syntax that is unlikely to occur in real content, such as {{name}}, <<Customer>>, or ~~SKU~~.
Voorbeeld
// 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;