GetAPIScopeReportJSON

Diagnostica, ispezione dei flussi di contenuto, modifica dei documenti

Descrizione

Restituisce un report JSON deterministico delle violazioni di ambito API, degli ambiti runtime attivi e della convalida facoltativa del contenuto della pagina

Sintassi

Delphi

Function TPDFlib.GetAPIScopeReportJSON(
  Options: Integer= PDF_API_SCOPE_INCLUDE_CONTENT): WideString;

ActiveX

Function PDFlib::GetAPIScopeReportJSON(Options As Long) As String

DLL

const wchar_t* DLGetAPIScopeReportJSON(int InstanceID, int Options);
const char* DLGetAPIScopeReportJSONA(int InstanceID, int Options);

Parametri

Valori restituiti

Restituisce JSON contenente i flag complessivi valid e balanced, documento e pagina selezionati, currentScope, campi del contenitore attivo e della profondità, conteggi totali e conservati delle violazioni, eventi di runtime ordinati e un oggetto di convalida content

Ogni evento runtime include sequenza monotona, documento, pagina, nome API, codice stabile, ambiti previsti ed effettivi e messaggio diagnostico

La convalida segnala sequenze q/Q, BT/ET, contenuto contrassegnato e percorsi non corrispondenti o non chiusi con posizioni token

Restituisce una stringa vuota e imposta LastErrorCode su 117 quando Options contiene bit non supportati

Note

Il monitoraggio runtime ha costo costante nelle transizioni riuscite e conserva le ultime 256 violazioni senza allocare durante il disegno ordinario

Le transizioni tracciate non valide restituiscono immediatamente zero e impostano LastErrorCode 117, impedendo la perdita silenziosa dei tracciati, l'underflow dello stato grafico, la chiusura non corrispondente del contenuto contrassegnato o modifiche del contesto con ambiti aperti

La chiamata non cancella violazioni conservate né cambia ambiti attivi; usare ClearAPIScopeReport dopo il report

Vedere anche

ClearAPIScopeReport, GetAPIScopeReportJSONA, TraceGraphicsStates