EndTag
Etiketli PDF, Erişilebilirlik
Açıklama
Etiket yığında en son açılan yapı ögesini kapatır, geçerli sayfa içerik akışına bir EMC işleci yazar ve ögeyi yığından çıkarır. Her BeginTag, BeginTagEx veya BeginTagEx2 çağrısı belge kaydedilmeden veya sonraki sayfa eklenmeden önce tam olarak bir EndTag çağrısıyla eşleşmelidir
Sözdizimi
Delphi
Function TPDFlib.EndTag: Integer;
ActiveX
Function PDFlib::EndTag() As Long
DLL
int DLEndTag(int InstanceID);
Dönüş değerleri
| 0 | Başarısız — açık belge yok veya etiket yığını boş (EndTag, karşılık gelen Begin* işlevlerinden daha fazla çağrıldı) |
|---|---|
| 1 | Yapı öğesi başarıyla kapatıldı |
Açıklamalar
Etiketler düzgün biçimde iç içe geçmelidir. Her EndTag en içteki açık yapı öğesini kapatır; kapanış sırası açılış sırasının tam tersidir, tıpkı sıradan blok öğelerinin HTML veya XML içinde iç içe geçmesi gibi
Belge bir veya daha fazla yapı öğesi açıkken kaydedilirse GetPDFUADiagnostics sayıyı STRUCT-UNCLOSED kodu altında bildirir. Kapanmamış öğeler kaydedilen yapı ağacında bulunmaz; bu nedenle her sayfadaki karşılık gelen işaretli içerik bölümlerinin mantıksal üst öğesi yoktur ve yardımcı teknoloji bunları atlar
Bir artifact bölgesini kapatmak için kesinlikle EndTag kullanmayın. Bölge BeginArtifact ile açıldıysa bunun yerine EndArtifact çağrısı yapın. Artifact'ler ve yapı öğeleri bağımsız işaretli içerik yığınlarında bulunur
Örnek
// Nested structure: a section with a heading and two paragraphs
PDF.BeginTag('Sect', '', '');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag; // H1
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 720, 'First paragraph of the introduction.');
PDF.EndTag; // P
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 690, 'Second paragraph follows in the same section.');
PDF.EndTag; // P
PDF.EndTag; // SectAyrıca bkz
BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics