AddTagAttribute

Etiketli PDF, Erişilebilirlik

Açıklama

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 TPDFlib.AddTagAttribute(Const Owner, Name, Value: WideString): Integer;

ActiveX

Function PDFlib::AddTagAttribute(Owner As String, Name As String, Value As String) As Long

DLL

int DLAddTagAttribute(int InstanceID, const wchar_t * Owner, const wchar_t * Name, const wchar_t * 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. Tek bir sayı PDF sayısı olarak yazılır ve 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. Sayılar her sistemde ondalık ayracı olarak nokta kullanır; sistemin kendi ondalık ayracıyla yazılmış bir sayı da kabul edilir. 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