BeginTagEx2

Etiketli PDF & Erişilebilirlik

Açıklama

Yeni bir yapı öğesi açar ve tüm ana öğe özelliklerini tek çağrıda ayarlayarak etiket yığınına iter. BeginTagEx2, BeginTagEx ardından SetStructElemTitle, SetStructElemID ve SetStructElemExpansion çağrılarını yapan kolaylık sarmalayıcısıdır. Title, ElemID veya Expansion için boş dize geçirilmesi ilgili ayarlayıcıyı atlar; diğer parametreler BeginTagEx ile aynı davranır

Bir öğeyi açtığınız anda tüm açıklayıcı özelliklerini biliyorsanız art arda birkaç ayarlayıcı çağrısından kaçınmak için BeginTagEx2 kullanın. Herhangi bir özellik daha sonra belirleniyorsa (örneğin AltText eşzamansız geliyorsa) BeginTag veya BeginTagEx kullanın ve ardından ayrı ayarlayıcıları çağırın

Sözdizimi

Delphi

Function TPDFlib.BeginTagEx2(Const TagType, AltText, ActualText, Lang, Title, ElemID, Expansion: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx2(TagType As String, AltText As String, ActualText As String, Lang As String, Title As String, ElemID As String, Expansion As String) As Long

DLL

int DLBeginTagEx2(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang, const wchar_t * Title, const wchar_t * ElemID, const wchar_t * Expansion);

Parametreler

TagType	Yapı öğesi türünün adı; örneğin `Figure`, `Table`, `Span`, `P`. BeginTag tarafından kabul edilen türlerle aynıdır
AltText	/Alt girdisine yazılan alternatif metin (ISO 32000-1 §14.9.3). Atlamak için boş bir dize geçirin
ActualText	/ActualText girdisine yazılan gerçek metin (ISO 32000-1 §14.9.4). Atlamak için boş bir dize iletin
Lang	/Lang girdisine yazılan BCP 47 dil etiketi (ISO 32000-1 §14.9.2), ör. `en-US`, `fr`, `zh-Hant-TW`. Belge dilini devralmak için boş dize geçirin
Title	/T girdisine yazılan, insanlarca okunabilir etiket (ISO 32000-1 §14.7.2). Tags gezinme panelinde gösterilir. Atlamak için boş dize geçirin
ElemID	/ID girdisine yazılan benzersiz öğe tanımlayıcısı (ISO 32000-1 §14.7.4). Ayarlanırsa belge içinde benzersiz olmalıdır. Atlamak için boş dize geçirin
Expansion	Bir kısaltmanın veya akronimin /E girdisine yazılan açılımı (ISO 32000-1 §14.9.5). Atlamak için boş bir dize geçirin

Dönüş değeri

Başarılı olduğunda 1, hiçbir belge seçili değilse 0 döndürür

Açıklamalar

Her başarılı EndTag çağrısının öğesini etiket yığınından çıkarmak üzere, karşılık gelen BeginTagEx2 çağrısı için EndTag işlevini bir kez çağırın. Yapı öğeleri iç içe geçebilir: başka bir öğe açıkken BeginTagEx2 çağrısı bir alt öğe oluşturur

Dâhili uygulama tam olarak şuna eşdeğerdir:

BeginTagEx(TagType, AltText, ActualText, Lang);
if Title <> '' then SetStructElemTitle(Title);
if ElemID <> '' then SetStructElemID(ElemID);
if Expansion <> '' then SetStructElemExpansion(Expansion);

Tek tek ayarlayıcılar, öge açıldıktan sonra belirlenen özellikler veya BeginTagEx2 tarafından kapsanmayan özellikler için (örneğin tablo hücresi özniteliklerinde AddTagAttribute) kullanılabilir olmaya devam eder

Örnek

// Tag a figure with all descriptive properties in one call
PDFlib.BeginTagEx2(
  'Figure',                              // TagType
  'Bar chart: Q1 120, Q2 145, Q3 98',   // AltText
  '',                                    // ActualText (not needed for images)
  '',                                    // Lang (inherit document language)
  'Figure 3: Quarterly Sales',           // Title
  'fig-quarterly-sales',                 // ElemID
  ''                                     // Expansion (not an abbreviation)
);
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

// Tag an acronym span with its expansion
PDFlib.BeginTagEx2(
  'Span',
  '',                                          // AltText
  '',                                          // ActualText
  '',                                          // Lang
  '',                                          // Title
  '',                                          // ElemID
  'World Wide Web Consortium'                  // Expansion
);
PDFlib.WriteText('W3C');
PDFlib.EndTag;

Ayrıca bkz

BeginTag, BeginTagEx, EndTag, SetStructElemTitle, SetStructElemID, SetStructElemExpansion