ReplaceTagA
Sayfa düzenleme
Açıklama
Sondaki A, ANSI (char) DLL giriş noktasını belirtir; ActiveX/COM yüzeyi yalnızca Unicode biçimini sunar. Davranış ReplaceTag ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır
Şu anda seçili sayfanın metin içeriğinde değişmez bul ve değiştir işlemi gerçekleştirir. Sayfanın metin gösterme işleçlerindeki her Tag örneği NewValue ile değiştirilir ve işleç akışı yerinde yeniden yazılır. Gerçekleştirilen değiştirme sayısını döndürür
Bu, etiketli PDF (yapı ağacı) etiketlemesiyle ilgili olmayan bir içerik akışı düzeyi işlemidir — bunun için BeginTag/EndTag kullanın. ReplaceTag, yer tutucu belirteçlerin (örneğin {{customer-name}}) bir şablon PDF'ye önceden çizildiği ve ardından kodla doldurulduğu standart mektup tarzı şablonlar için tasarlanmıştır
Sözdizimi
Delphi
Function DLReplaceTagA(InstanceID: Integer; Tag, NewValue: PAnsiChar): Integer;DLL
int DLReplaceTagA(int InstanceID, const char * Tag, const char * NewValue);Parametreler
| Tag | Sayfanın metin içeriğinde aranacak değişmez dize. Eşleşme büyük/küçük harfe duyarlıdır ve yalnızca geçerli seçili sayfaya uygulanır — çok sayfalı bir şablon işlenirken her sayfa için bir kez çağırın |
|---|---|
| NewValue | Değiştirme dizesi. Tag değerinden daha uzun veya daha kısa olabilir; çevresindeki düzen yeniden akıtılmaz, dolayısıyla çok büyük değiştirmeler özgün sütunun dışına taşabilir |
Dönüş değeri
Seçili sayfada Tag öğesinin bulunup değiştirildiği sayı. Sıfır, hiçbir eşleşme bulunmadığı (veya hiçbir sayfanın seçilmediği) anlamına gelir
Açıklamalar
Yalnızca metin gösterme işleçlerinin (Tj, TJ, ', ") içindeki metin aranır. Karakter aralığı ayarlanmış veya birden fazla işlece bölünmüş yer tutucular eşleşmeyebilir — şablon yer tutucularını kısa tutun ve tek bir dize olarak çizin. İşlev ek açıklama içeriklerinde, form alanı değerlerinde veya gömülü dosyalarda arama yapmaz
Gerçek içerikte bulunması olası olmayan yer tutucu söz dizimini seçin; örneğin {{name}}, <<Customer>> veya ~~SKU~~
Örnek
// 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;