GetAPIScopeReportJSON

Tanılama, içerik akışı inceleme, belge düzenleme

Açıklama

API kapsamı ihlallerini, o anda etkin çalışma zamanı kapsamlarını ve isteğe bağlı seçili sayfa içeriği doğrulamasını içeren belirlenimci JSON raporu döndürür

Sözdizimi

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);

Parametreler

OptionsSıfır, çalışma zamanı durumunu ve korunan ihlalleri bildirir; PDF_API_SCOPE_INCLUDE_CONTENT ayrıca seçilen sayfanın tüm içerik katmanlarını ayrıştırır

Dönüş değerleri

Genel valid ve balanced bayraklarını, seçilen belge ve sayfayı, currentScope değerini, etkin kapsayıcı ve derinlik alanlarını, toplam ve saklanan ihlal sayılarını, sıralı çalışma zamanı olaylarını ve bir content doğrulama nesnesini içeren JSON döndürür

Her çalışma zamanı olayı tekdüze artan bir sıra numarası, belge, sayfa, API adı, kararlı kod, beklenen ve gerçek kapsamlar ile bir tanılama iletisi içerir

İçerik doğrulaması eşleşmeyen veya kapanmamış q/Q, BT/ET, işaretli içerik ve yol dizilerini belirteç konumlarıyla bildirir

Boş dize döndürür ve LastErrorCode değerini 117 yapar; bu durum Options desteklenmeyen bitler içerdiğinde gerçekleşir

Açıklamalar

Çalışma zamanı izlemesi başarılı geçişlerde sabit zamanlı ek yüke sahiptir ve olağan çizim çağrılarında ayırma yapmadan en son 256 ihlali saklar

Geçersiz izlenen geçişler hemen sıfır döndürür ve LastErrorCode 117 değerini ayarlar; böylece sessiz yol kaybı, grafik durumu alt taşması, eşleşmeyen işaretli içerik kapatma veya açık kapsamlarla bağlam değişiklikleri önlenir

Bu yöntemi çağırmak saklanan ihlalleri temizlemez veya etkin kapsamları değiştirmez; bir raporu tükettikten sonra ClearAPIScopeReport kullanın

Ayrıca bkz

ClearAPIScopeReport, GetAPIScopeReportJSONA, TraceGraphicsStates