AddTagAttributeA
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ış AddTagAttribute ile aynıdır ve dize bağımsız değişkenleri geçerli SetAnsiMode kod sayfası kullanılarak yorumlanır
Etiket yığınında oluşturulmakta olan yapı öğesine adlandırılmış öznitelik ekler. Öznitelik belge kaydedildiğinde PDF /A öznitelik sözlüğü (veya sözlük dizisi) olarak yazılır. Bunu BeginTag veya BeginTagEx çağrısından sonra ve EndTag çağrısından önce yapın
Sözdizimi
Delphi
Function DLAddTagAttributeA(InstanceID: Integer; Owner, Name, Value: PAnsiChar): Integer;DLL
int DLAddTagAttributeA(int InstanceID, const char * Owner, const char * Name, const char * Value);Parametreler
| Owner | ISO 32000-1 Tablo 348'de tanımlanan öznitelik sahibi adı (örn. Layout, Table, List, PrintField). Bu, öznitelik sözlüğündeki /O anahtarı olur |
|---|---|
| Name | Belirtilen sahip için öznitelik adı (ör. Layout için BBox, Table için Scope). Boş olmamalıdır |
| Value | Dize olarak öznitelik değeri. Yalnızca boşlukla ayrılmış sayılar içeren değerler (ör. "0 0 200 100") gerçek sayılardan oluşan bir PDF dizisi olarak yazılır. Diğer tüm değerler PDF ad nesnesi olarak (başında / olmadan) yazılır. Boş olmamalıdır |
Dönüş değeri
Başarı durumunda 1 döndürür. Açık belge yoksa, şu anda açık etiket yoksa veya Owner ya da Name boşsa 0 döndürür
Açıklamalar
Aynı açık etiket için birden çok AddTagAttribute çağrısı biriktirilir. Öznitelikler tek bir sahibe ait olduğunda kitaplık tek bir /A öznitelik sözlüğü yazar. Birden çok sahip kullanıldığında öznitelikler sahibe göre gruplandırılır ve öznitelik sözlükleri dizisi olarak yazılır
Yaygın öznitelikler için SetStructElemScope ve SetStructElemBBox kolaylık sarmalayıcıları, doğrudan AddTagAttribute çağrısı yerine kullanılabilir
Yeni bir etiket açıldığında öznitelikler sıfırlanır; alt öğeler tarafından devralınmaz
Örnek
// Mark a table header cell with column scope
PDFlib.BeginTag('TH', '', '', '');
PDFlib.AddTagAttribute('Table', 'Scope', 'Column');
// ... draw cell content
PDFlib.EndTag;
// Mark a figure with a bounding box
PDFlib.BeginTag('Figure', 'Company logo', '', '');
PDFlib.AddTagAttribute('Layout', 'BBox', '72 600 200 700');
PDFlib.EndTag;Ayrıca bkz
BeginTag, BeginTagEx, EndTag, SetStructElemScope, SetStructElemBBox