EndTag

Тагнат PDF, Достъпност

Описание

Затваря най-скоро отворения структурен елемент на стека с тагове, като записва оператор EMC (End Marked Content) в потока със съдържание на текущата страница и премахва елемента от стека. Всяко извикване на BeginTag, BeginTagEx или BeginTagEx2 трябва да бъде сдвоено с точно едно извикване на EndTag преди документът да бъде записан или да се добави следващата страница

Синтаксис

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Върнати стойности

0	Неуспех — няма отворен документ или стекът с тагове е празен (`EndTag` е извикван повече пъти от съответните функции `Begin*`)
1	Структурният елемент беше затворен успешно

Бележки

Таговете трябва да се влагат правилно. Всеки EndTag затваря най-вътрешния отворен структурен елемент; редът на затваряне е строго обратен на реда на отваряне, по същия начин, по който обикновените блокови елементи се влагат в HTML или XML

Ако документът бъде записан с един или повече все още отворени структурни елемента, GetPDFUADiagnostics отчита броя им под кода STRUCT-UNCLOSED. Незатворените елементи липсват от записаното дърво на структурата, така че съответните секции от маркирано съдържание на всяка страница нямат логически родител — помощната технология ще ги пропусне

Не използвайте EndTag, за да затворите област на артефакт, отворена с BeginArtifact; за това извикайте EndArtifact. Артефактите и структурните елементи съществуват върху независими стекове на маркирано съдържание

Пример

// Nested structure: a section with a heading and two paragraphs
PDF.BeginTag('Sect', '', '');
  PDF.BeginTag('H1', '', '');
    PDF.PrintText(50, 750, 'Introduction');
  PDF.EndTag;   // H1
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 720, 'First paragraph of the introduction.');
  PDF.EndTag;   // P
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 690, 'Second paragraph follows in the same section.');
  PDF.EndTag;   // P
PDF.EndTag;     // Sect

Вижте още

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics