BeginTagExA
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ış BeginTagEx ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır
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 DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;
DLL
int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * 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;