SetStructElemScopeA

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ış SetStructElemScope 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 o anda açık olan yapı öğesinde /Scope özniteliğini (Table öznitelik sahibi) ayarlar. Kapsam, bir TH (tablo başlığı) hücresinin bir sütuna, satıra veya her ikisine uygulanıp uygulanmadığını belirtir — başlık hücreleri bulunan tablolar için PDF/UA-1 tarafından zorunlu tutulur. Bu işlem, AddTagAttribute işlevini Owner=Table, Name=Scope ve değer olarak kapsam adıyla çağırmaya eşdeğerdir

Sözdizimi

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

Parametreler

ScopeBaşlık hücresinin kapsamı. Aşağıdaki büyük/küçük harfe duyarlı değerlerden biri olmalıdır:

Column — başlık sütundaki tüm hücrelere uygulanır
Row — başlık satırdaki tüm hücrelere uygulanır
Both — başlık hem sütuna hem satıra uygulanır

Dönüş değeri

Başarıda 1 döndürür. Açık belge veya etiket yığınında açık etiket yoksa 0 döndürür

Açıklamalar

Bu işlevi BeginTag çağrısından sonra (TH etiket türüyle) ve EndTag çağrısından önce yapın. /Scope özniteliği ISO 32000-1 §14.8.5.7.2 içinde tanımlanmıştır (Table özniteliği sahibi)

PDF/UA-1 (ISO 14289-1 §7.10), tablo başlık hücrelerinin veri hücreleriyle açıkça ilişkilendirilmesini gerektirir. Tablo yerleşimi izin verdiğinde önerilen yöntem /Scope özniteliğini sağlamaktır

Örnek

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

Ayrıca bkz

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode