AddRoleMapA

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ış AddRoleMap ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfasıyla yorumlanır

Özel bir yapı ögesi türü adından belgenin RoleMap sözlüğündeki standart PDF yapı türüne eşleme kaydeder

Etiketli PDF içeriği standart olmayan etiket adları kullandığında PDF belirtimi bu adların yapı ağacı kökünün /RoleMap girdisinde standart PDF yapı türüne eşlenmesini gerektirir. ISO 14289-1 §7.1, standart olmayan yapı öğesi türleri içeren tüm PDF/UA-1 belgelerinde bu eşlemeyi zorunlu kılar

Her özel tür için bir kez AddRoleMap çağrısı yapın; bu çağrı o türle BeginTag veya BeginTagEx çağrılmadan önce yapılmalıdır. Birden çok eşleme kaydedilebilir. Aynı özel tür birden fazla kez kaydedilirse son eşleme geçerli olur

En az bir eşleme kaydedilmişse belge kaydedildiğinde RoleMap yapı ağacı köküne yazılır

Sözdizimi

Delphi

Function DLAddRoleMapA(InstanceID: Integer; CustomType, StandardType: PAnsiChar): Integer;

DLL

int DLAddRoleMapA(int InstanceID, const char * CustomType, const char * StandardType);

Parametreler

CustomTypeBeginTag veya BeginTagEx çağrılarında kullanılan özel (standart olmayan) yapı öğesi türü adı, ör. Headline, Caption, Callout
StandardTypeÖzel türün eşlendiği standart PDF yapı türü: P, H1–H6, Figure, Table, Span, Link, Note vb. (bkz. ISO 32000-1 §14.8.4). Eşlemenin PDF/UA uygunluk denetleyicilerini karşılaması için tanınan bir standart tür olmalıdır

Dönüş değerleri

0Başarısız (açık belge yok)
1Eşleme başarıyla kaydedildi

Örnek

// Document with custom element types mapped to standard PDF structure types
PDF.SetPDFUAMode('en-US');
PDF.AddRoleMap('Headline', 'H1');
PDF.AddRoleMap('Subheadline', 'H2');
PDF.AddRoleMap('Caption', 'P');

PDF.BeginTag('Headline', '', '');
PDF.PrintText(50, 750, 'Annual Report 2026');
PDF.EndTag;

PDF.BeginTag('Subheadline', '', '');
PDF.PrintText(50, 720, 'Financial Highlights');
PDF.EndTag;