Lokalisasi ini langsung membahas Delphi PDF Reports with HotPDF: TextOut, Fonts, and Images dan memakai artikel bahasa Inggris yang sudah diperbarui sebagai acuan teknis untuk tim Delphi, PDF, dan perangkat lunak dokumen
Halaman ini mengubah artikel dasar yang diperbarui menjadi titik pemeriksaan konkret untuk desain, implementasi, dan validasi
Materi yang disinkronkan dari artikel bahasa Inggris
Artikel dasar berbahasa Inggris kini memiliki konteks implementasi, keputusan teknis, dan contoh yang lebih konkret, sehingga halaman ini diposisikan sebagai panduan kerja, bukan ringkasan pendek
Bagian penting dalam artikel dasar yang diperbarui:
- Gunakan file masukan kecil yang dapat direproduksi sebelum fitur disambungkan ke data produksi
- Pertahankan nama produk, nama API, nama file, dan nilai literal apa adanya
- Simpan keluaran validator dan informasi versi bersama file contoh yang dibuat
Pilihan implementasi praktis
Mulailah dari jenis file, keluaran yang diharapkan, dan kondisi kesalahan yang harus dilihat pengguna. Lalu hubungkan setiap panggilan API dengan hasil yang bisa diperiksa agar validasi, logging, dan dukungan dapat mereproduksi kasus pelanggan
- Gunakan file masukan kecil yang dapat direproduksi sebelum fitur disambungkan ke data produksi
- Pertahankan nama produk, nama API, nama file, dan nilai literal apa adanya
- Simpan keluaran validator dan informasi versi bersama file contoh yang dibuat
Kode dan titik API
Contoh kode dipertahankan apa adanya agar pengembang dapat membandingkannya langsung dengan proyek Delphi, C++Builder, dan Lazarus/FPC
var
Pdf: THotPDF;
begin
Pdf := THotPDF.Create(nil);
try
Pdf.FileName := 'invoice-0001.pdf';
Pdf.BeginDoc;
Pdf.CurrentPage.SetFont('Arial', [fsBold], 16);
Pdf.CurrentPage.TextOut(50, 792 - 50, 0, 'INVOICE'); // 50pt from top of Letter
Pdf.CurrentPage.SetFont('Arial', [], 10);
Pdf.CurrentPage.TextOut(50, 792 - 70, 0, 'Date: 2026-06-11');
Pdf.CurrentPage.TextOut(300, 400, 45, 'COPY'); // rotated stamp
Pdf.AddPage; // CurrentPage now points here
Pdf.CurrentPage.SetFont('Arial', [], 10); // font state does not carry over
Pdf.CurrentPage.TextOut(50, 742, 0, 'Page 2 detail rows');
Pdf.EndDoc;
finally
Pdf.Free;
end;
end;Pdf.RegisterUnicodeTTF('C:\ProgramData\MyApp\Fonts\NotoSans.ttf');
Pdf.CurrentPage.SetFont('NotoSans', [], 12);
Pdf.CurrentPage.TextOut(50, 700, 0, WideString('Łódź — Ünïcode test ✓'));var
Png: TPngImage;
Logo: TBitmap;
LogoIdx: Integer;
begin
Png := TPngImage.Create;
Logo := TBitmap.Create;
try
Png.LoadFromFile('brand-logo.png');
Logo.Assign(Png); // decode PNG to a bitmap
LogoIdx := Pdf.AddImage(Logo, icFlate); // lossless for flat-color art
finally
Logo.Free;
Png.Free;
end;
// (Index, X, Y, Width, Height, Angle) — not (X1, Y1, X2, Y2)
Pdf.CurrentPage.ShowImage(LogoIdx, 50, 700, 120, 40, 0);
end;Pemeriksaan sebelum rilis
Periksa file keluaran dengan alat yang sama seperti yang digunakan pelanggan atau arsip. Catat versi komponen, data uji, versi validator, dan hasil yang diamati agar regresi berikutnya dapat dilacak dengan tepat
Bacaan terkait
- our article on complex script text shaping with HotPDF
- the HotPDF PDF/A, PDF/X, and PDF/UA guide
- HotPDF Component
Contoh kode tambahan
// Horizontal rule under the table header
Pdf.CurrentPage.SetLineWidth(0.75);
Pdf.CurrentPage.MoveTo(50, 660);
Pdf.CurrentPage.LineTo(545, 660);
Pdf.CurrentPage.Stroke;
// Shaded totals box: X, Y, width, height
Pdf.CurrentPage.SetRGBFillColor(RGB(235, 235, 235));
Pdf.CurrentPage.Rectangle(395, 120, 150, 40);
Pdf.CurrentPage.Fill;Catatan tambahan
Tambahan ini membuat versi ringkas menjadi panduan kerja yang lebih berguna, sambil tetap selaras dengan Delphi PDF Reports with HotPDF: TextOut, Fonts, and Images dan kerangka teknis artikel bahasa Inggrisnya. Teks perlu menjelaskan dari input seperti apa topik dimulai, output apa yang dituju, dan pada titik mana perilaku harus diverifikasi.
Saat menulis ulang, urutan keputusan penting: mulai dari bentuk data, lalu batas perubahan, kemudian dependensi API, dan akhirnya perilaku hasil. Jika artikel menyebut beberapa jalur, jelaskan juga jalur mana yang paling kuat untuk maintenance, support, dan reproduksi masalah.
Setiap code block, nama file, nama API, dan nilai literal harus tetap sama. Penjelasan sekitarnya boleh lebih luas, tetapi contoh kode harus menjadi referensi yang presisi agar pembaca bisa membandingkannya langsung dengan proyek Delphi, C++Builder, atau Lazarus/FPC mereka.
Bagian validation harus menyebut file sampel kecil, perbandingan output, dan pencatatan versi component atau validator. Jika halaman membahas bug fix atau migrasi, jalur reproduksi, kondisi awal yang terlihat, dan titik verifikasi harus dijelaskan dengan jelas supaya regression dapat dilacak tanpa tebakan.
Perluasan seperti ini membuat halaman tetap berguna setelah dibaca sekali: untuk reviewer sebagai alasan keputusan, untuk support sebagai konteks diagnosis, dan untuk tim pemeliharaan sebagai catatan yang bisa dirujuk saat perubahan berikutnya.
- Jangan ubah nama produk, API, file, atau literal
- Jika ada code block, pertahankan apa adanya
- Jelaskan validation dengan file contoh dan output yang bisa dibandingkan
- Uraikan urutan keputusan dengan jelas, bukan hanya ringkasan singkat