BeginTagA
Etiketli PDF, Erişilebilirlik
Açıklama
Sondaki A, ANSI (char) DLL giriş noktasını belirtir; ActiveX/COM yüzeyi yalnızca Unicode biçimini sunar. Davranış BeginTag ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır
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 DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;DLL
int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * 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