SetAutoTagMode

PDF con tag

Descrizione

Abilita la marcatura della struttura associata automaticamente dalle normali chiamate di disegno

Sintassi

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

Parametri

Mode	Maschera di bit: `1` applica tag al testo, `2` contrassegna gli elementi decorativi della pagina come artefatti, `4` applica tag alle immagini come figure, `8` applica tag alle tabelle disegnate, `15` esegue tutte e quattro le operazioni, `0` disattiva la funzione

Valori restituiti

Mode	La modalità attiva prima di questa chiamata
0	Restituito anche quando viene fornita una modalità negativa, che viene rifiutata lasciando invariata la modalità

Note

Con i tag testo attivi, il testo diventa paragrafo e dopo RegisterHeading diventa intestazione del livello indicato. Intestazioni e piè di pagina ricorrenti diventano artefatti

Con l'applicazione dei tag alle figure attiva, un'immagine disegnata diventa una figura con la descrizione lasciata da RegisterFigure, oppure viene disegnata all'interno di un artefatto di layout quando RegisterDecoration ha indicato che non ha alcun significato

Con i tag tabella attivi, DrawTableRows inserisce tabella, righe e celle nella struttura. Le righe indicate da SetTableHeaderRowCount diventano intestazioni

L'attivazione della modalità contrassegna inoltre il documento come documento con tag. Un lettore considera assente la struttura finché tale contrassegno non è presente, quindi un documento con tag ma privo del contrassegno viene letto come se non avesse alcuna struttura

L'applicazione automatica dei tag si sospende all'interno di un tag aperto con BeginTag: mentre il chiamante descrive la struttura, nulla viene annidato nell'elemento che ha aperto. Non applica mai tag all'interno di un artefatto, dove un elemento di struttura renderebbe il file non valido, né apre un elemento per testo vuoto, che verrebbe annunciato come spazio vuoto da un lettore

La modalità appartiene all'istanza della libreria, non a un documento

Esempio

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

Vedere anche

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount