成员函数文档

[信号]void QDltRegistration::logLevelChanged(const QLoggingCategory *category)

每当 dlt-daemon 更改 dlt 上下文的日志级别并且该 dlt 上下文与 QLoggingCategory 注册时，都会发出此信号。更新的 QLoggingCategory 作为 category 传递。

注意：此信号需要一个等于 2.12 或更高版本的 dlt-daemon。

[静态]void QDltRegistration::messageHandler(QtMsgType msgType, const QMessageLogContext &msgCtx, const QString &msg)

Qt 消息处理器，将所有日志消息转发到 dlt-daemon。

此函数将 msgTypes 映射到相应的 dlt 日志级别，并将 msg 转发到与 msgCtx 中的类别匹配的 dlt 上下文。

如果 msgCtx 中的类别尚未与 dlt 上下文注册，则将使用后备日志类别（如果已注册）。

此 messageHandler 需要通过以下方式安装

qInstallMessageHandler(QDltRegistration::messageHandler);

void QDltRegistration::registerApplication(const char *dltAppID, const char *dltAppDescription)

使用 dltAppID 和 dltAppDescription 注册应用程序到 dlt-daemon。

每个进程只能注册一个应用程序。在应用程序已经被注册后调用此函数，将在新的 dltAppID 和 dltAppDescription 下注册应用程序，并填充此应用程序下已注册的所有 dlt 上下文。如果应用程序之前已注册，使用空 dltAppID 调用该方法只会更新描述。

另请参阅：QDLT_REGISTER_APPLICATION。

void QDltRegistration::registerCategory(const QLoggingCategory *category, const char *dltCtxName, const char *dltCtxDescription)

使用 dltCtxName 和 dltCtxDescription 将 category 注册到 dlt-daemon。

不应直接使用此函数，而应使用便利宏。

另请参阅：QDLT_LOGGING_CATEGORY 和 QDLT_REGISTER_LOGGING_CATEGORY。

void QDltRegistration::registerUnregisteredContexts()

将所有尚未注册的上下文与 dlt-daemon 注册。

该函数可以与 setRegisterContextOnFirstUseEnabled 结合使用，以延迟对 dlt-daemon 的注册，直到真正需要注册，并且所有尚未注册的上下文都安全注册后，例如使用相关的日志类别。

另请参阅setRegisterContextOnFirstUseEnabled。

void QDltRegistration::setDefaultContext(const char *categoryName)

将 categoryName 设置为后备日志类别。

categoryName 需要是 dlt-daemon 中已注册的有效 QLoggingCategory 名称。可以通过使用 QDLT_LOGGING_CATEGORY 或 QDLT_REGISTER_LOGGING_CATEGORY 实现。

不应直接使用此函数，而应使用便利宏。

另请参阅QDLT_FALLBACK_CATEGORY。

void QDltRegistration::setRegisterContextOnFirstUseEnabled(bool enabled)

当设置为 enabled 时，类别第一次使用时进行注册。

否则，在调用 QDLT_LOGGING_CATEGORY 或 QDLT_REGISTER_LOGGING_CATEGORY 时立即进行注册。

不应直接使用此函数，而应使用便利宏。

另请参阅QDLT_REGISTER_CONTEXT_ON_FIRST_USE。

void QDltRegistration::unregisterApplication()

从 dlt-daemon 中注销应用程序。将删除已注册的应用程序以及所有已注册的 dlt 上下文。

void QDltRegistration::unregisterCategories()

从 dlt-daemon 注销所有类别及其关联的上下文 ID。

此函数的一个应用可以是更新日志级别：在此函数调用后，所有类别将在下次使用时重新注册（带有新日志级别）。