BeginTagEx

Etiketli PDF, Erişilebilirlik

Açıklama

Geçerli sayfada açık bir doğal dil özniteliğiyle etiketli PDF yapı öğesi açar. BeginTag ile aynıdır ancak yapı öğesinin Lang parametresini /Lang özniteliğine yazar

Bu işlevi, dili belgenin varsayılan dilinden (SetPDFUAMode veya SetDocumentLanguage ile ayarlanır) farklı olan içerik için kullanın. ISO 14289-1 §7.2, belgenin birincil dilinde olmayan tüm metin bölümlerinde /Lang özniteliğinin ayarlanmasını gerektirir

Etiketler dengeli olmalıdır: her BeginTagEx çağrısını eşleşen bir EndTag çağrısı izlemelidir. Etiketler iç içe geçebilir

Sözdizimi

Delphi

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

ActiveX

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

DLL

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

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çerikler için alternatif metin (`/Alt` özniteliği). Gerekmiyorsa boş bir dize geçirin
ActualText	Görsel biçimi mantıksal anlamından farklı olan içerik için değiştirme metni (`/ActualText` özniteliği). Gerekmiyorsa boş bir dize geçirin
Lang	Bu öğedeki içerik için BCP 47 dil etiketi, örneğin `en-US`, `fr-FR`, `zh-Hans`. Belge dilini devralmak için boş bir dize geçirin. Boş olmadığında bu öğe ve tüm alt öğeleri için belge düzeyindeki dili geçersiz kılar

Dönüş değerleri

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

Örnek

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;