Fluent-Qt

API 레퍼런스

DiagnosticSession

위젯 트리와 선택적 로그 메시지에 대한 제한된 메모리 내 진단 세션을 기록합니다. UI 호출은 GUI 스레드에서 실행해야 하며, 스냅샷에는 위젯 텍스트와 경로가 제외되고 로그 메시지는 명시적으로 활성화된 경우에만 기록됩니다.

fluent::diagnostics::DiagnosticSession

상속 대상 QObject

생성자

소멸자

메서드

bool start(QWidget* root, bool includeLogMessages = false, int maximumDurationMs = 300000)

@p root에 대한 녹화를 시작합니다 (호출자가 소유권 유지). 이미 녹화 중이면 false를 반환합니다. @p maximumDurationMs가 0이면 stop()이 호출될 때까지 녹화하며, 양수이면 해당 밀리초 후에 자동으로 중지됩니다.

void stop()

녹화를 중지하고 최종 위젯 스냅샷을 캡처합니다.

void clear()

녹화를 중지하고 수집된 모든 데이터를 삭제합니다.

QVariantMap report() const

수집된 JSON 검사 보고서를 QVariantMap으로 반환합니다.

QVariantMap captureReport()

세션을 중지하지 않고 현재 위젯 상태의 JSON 검사 보고서를 캡처합니다 (GUI 스레드 전용).

static QByteArray createBundle(const QVariantMap& report, const QVariantMap& attachments = {})

report.json과 선택적 첨부 파일을 메모리 내 ZIP 아카이브로 패키징합니다 (최대 20 MiB). 첨부 파일 이름이 유효하지 않거나 크기 제한을 초과하면 빈 바이트 배열을 반환합니다.

static QVariantMap environment()

호스트 이름이나 파일 경로를 제외한 안전한 런타임 환경 메타데이터를 반환합니다.

void recordMessage(QtMsgType type, const QString& category, const QString& message)

로그 메시지를 기록합니다. 이 세션이 유지되는 동안 워커 스레드에서 안전하게 호출할 수 있습니다.

MessageSink messageSink() const

세션이 소멸된 후에는 아무 작업도 수행하지 않는 스레드 안전 로그 콜백을 반환합니다.

속성

bool recording
읽기 isRecording()알림 신호 recordingChanged()

시그널

타입 및 별칭

보호된 멤버

메서드

Qt 기본 클래스 문서: QObject