SetStructElemScopeA

PDF con tag, accessibilità

Descrizione

Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a SetStructElemScope e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode

Imposta l'attributo /Scope (proprietario degli attributi Table) sull'elemento di struttura attualmente aperto nello stack dei tag. L'ambito indica se una cella TH (intestazione di tabella) si applica a una colonna, a una riga o a entrambe, come richiesto da PDF/UA-1 per le tabelle con celle di intestazione. Equivale a chiamare AddTagAttribute con Owner=Table, Name=Scope e il nome dell'ambito come valore

Sintassi

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

Parametri

Scope	Ambito della cella di intestazione. Deve essere uno dei seguenti valori, con distinzione tra maiuscole e minuscole: Column — l'intestazione si applica a tutte le celle della colonna Row — l'intestazione si applica a tutte le celle della riga Both — l'intestazione si applica sia alla colonna sia alla riga

Valore restituito

Restituisce 1 in caso di successo, 0 se nessun documento o tag è attualmente aperto

Note

Chiamare questa funzione dopo BeginTag con tag TH e prima di EndTag. L'attributo /Scope è definito in ISO 32000-1 §14.8.5.7.2 (proprietario Table)

PDF/UA-1 (ISO 14289-1 §7.10) richiede associazioni chiare tra intestazioni e celle dati. /Scope è il meccanismo consigliato quando il layout lo consente

Esempio

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

Vedere anche

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode