SetStructElemTitleA

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ış SetStructElemTitle 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ı öğesinin /T (başlık) girdisini ayarlar. Başlık yalnızca öğe türünü yinelemek yerine belirli öğeyi niteleyen, insan tarafından okunabilir bir etikettir — örneğin Bölüm 1, Özet Tablosu veya Şekil 3: Üç Aylık Satışlar

Sözdizimi

Delphi

Function DLSetStructElemTitleA(InstanceID: Integer; Title: PAnsiChar): Integer;

DLL

int DLSetStructElemTitleA(int InstanceID, const char * Title);

Parametreler

Title	Bu belirli öge örneğini tanımlayan, insanların okuyabileceği bir metin dizesi. Önceden ayarlanmış bir değeri temizlemek için boş dize geçirin

Dönüş değeri

Başarı durumunda 1; şu anda açık yapı öğesi yoksa veya belge seçili değilse 0 döndürür

Açıklamalar

/T girdisi ISO 32000-1 §14.7.2 Table 324 içinde tanımlanmıştır. Yapı öğesi sözlüğüne PDF metin dizesi olarak yazılır

Title, bir yapı öğesindeki diğer metin özelliklerinden farklı bir amaca hizmet eder:

/T (Title) — Öğenin gezinme ve etiketleme panellerinde kullanılan açıklayıcı etiketi. Bölüm başlıkları, tablo açıklamaları ve şekil açıklamaları için uygundur
/Alt (SetStructElemAltText bölümüne bakın) — öğe işlenemediğinde yardımcı teknoloji için öğenin eksiksiz metinsel karşılığı
/ActualText (bkz. SetStructElemActualText) — Ayıklanan metni yanlış olacak glif dizileri için tam Unicode karşılığı

PDF görüntüleyicileri, Etiketler gezinme panelindeki öğeleri etiketlemek için /T kullanır. Erişilebilirlik araçları ve düzeltme yazılımları bunu belge gezinmesi için bir yer işareti başlığı olarak kullanır. Başlık öğelerinde (H1–H6), öğe içeriğinin kendisi başlık metni işlevi görür; /T, açıklayıcı etiket gerektiren metin dışı öğeler (Table, Figure, Form) veya kapsayıcılar (Sect, Div) için daha kullanışlıdır

Örnek

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

Ayrıca bkz

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics