SetStructElemColSpan

Etiketli PDF, Erişilebilirlik

Açıklama

Etiket yığınında o anda açık olan yapı öğesinde /ColSpan özniteliğini (Table özniteliği sahibi) ayarlar. Değer, geçerli tablo hücresinin kaç sütuna yayıldığını gösterir. Bu, AddTagAttribute işlevini Owner=Table, Name=ColSpan ve dize biçimindeki tamsayı değerle çağırmaya eşdeğerdir

Sözdizimi

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

Parametreler

ColSpan	Geçerli tablo hücresinin yayıldığı sütun sayısı. Pozitif bir tamsayı olmalıdır. 1 değeri, hücrenin tam olarak bir sütun kapladığı anlamına gelir (ColSpan ayarlanmadığında varsayılan davranış). 1'den büyük değerler, yayılan bir başlık veya veri hücresini belirtir

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 veya TD etiket türüyle) ve EndTag çağrısından önce yapın. /ColSpan özniteliği ISO 32000-1 §14.8.5.7.2 içinde tanımlanmıştır (Table özniteliği sahibi, Table 337)

Yayılan hücreler karmaşık tablolarda yaygındır — örneğin iki veri sütununa yayılan bir sütun başlığı. /ColSpan özniteliğinin sağlanması, yardımcı teknolojinin hücre konumlarını doğru hesaplamasına ve tüm tablo ızgarası boyunca başlıkları veri hücreleriyle ilişkilendirmesine olanak tanır

Bir hücre birden çok satıra da yayılıyorsa bu işlevle birlikte SetStructElemRowSpan kullanın

Örnek

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

Ayrıca bkz

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag