BeginTag

Etiketli PDF, Erişilebilirlik

Açıklama

Geçerli sayfada etiketli PDF yapı öğesi açar. İçerik akışına bir BDC (Begin Marked Content with Dictionary) işleci yazar ve öğeyi belge mantıksal yapı ağacına kaydeder. Belge kaydedildiğinde yapı ağacı otomatik olarak tamamlanır

Etiketler dengeli olmalıdır: her BeginTag çağrısını eşleşen bir EndTag çağrısı izlemelidir. Etiketler iç içe yerleştirilebilir

Sözdizimi

Delphi

Function TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

Function PDFlib::BeginTag(TagType As String, AltText As String, ActualText As String) As Long

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText);

Parametreler

TagType	PDF standart yapı türü: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` vb. (bkz. ISO 32000-1 §14.8.4)
AltText	Görüntüler ve diğer metin dışı içerik için alternatif metin (PDF `/Alt` özniteliğine eşlenir). Gerekli değilse boş bir dize geçirin
ActualText	Görsel gösterimi mantıksal anlamından farklı olan içerik için değiştirme metni (PDF `/ActualText` özniteliğine eşlenir). Gerekmiyorsa boş dize geçirin

Dönüş değerleri

0	Başarısız (açık belge yok)
1	Etiket başarıyla açıldı

Örnek

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

Açıklamalar

Ekran okuyucular tarafından okunmaması gereken dekoratif içerik (sayfa üstbilgileri, altbilgiler, arka plan öğeleri) için BeginArtifact/EndArtifact kullanın

Belge yazma modunda olmalıdır (oluşturulmuş veya değişiklik için açılmış). PDF/UA-1 gereksinimlerini karşılamak üzere etiketlemeden önce SetPDFUAMode çağrısını yapın

Bir belgeyi etiketlemek, kaydedildiğinde onu etiketli olarak işaretler; okuyucunun yapıyı var kabul etmesi için önce buna gereksinimi vardır. Çağıran tarafından yapılan SetMarkInfo ayarı olduğu gibi bırakılır