You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
nmWTAI-Platform/Include/nmNum/nmSubWnd/nmSubWndUtils.h

229 lines
10 KiB
C++

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

#pragma once
#include <QMap>
#include <QObject>
#include <QSet>
#include "nmSubWnd_global.h"
class iRibbonXmlCmd;
class iRibbonXmlTab;
class ZxMainWindow;
class iSubWnd;
class iDockBaseWx;
class ZxTabWidget;
class QMdiSubWindow;
class ZxMdiSubWindow;
class QEvent;
class iSubWndFitting;
class nmDataAnalyzeManager;
class nmWxParaPropertyPebi;
class nmSubWndMain;
class nmNumericalSaveSession;
// 本来主要是为数值部分提供SubWnd初始化构造的方法
class NM_SUB_WND_EXPORT nmSubWndUtils : public QObject
{
Q_OBJECT
public:
static nmSubWndUtils* getInstance();
nmSubWndUtils();
~nmSubWndUtils();
public:
/// @brief 构造窗体根据RibbonXmlCmd
/// @param pCmdInfoconst in) 命令Cmb定义
/// @param pMainWndconst in) 主窗体
/// @param bCreatedNewOne(out) 返回是否新建的,还是 原先的
/// @note 权宜之计:此处构造的窗体,无需额外删除(析构),系统会统一处理
static iSubWnd* createSubWnd(const iRibbonXmlCmd* pCmdInfo, \
const ZxMainWindow* pMainWnd, \
bool& bCreatedNewOne);
/// @brief 构造窗体根据sID和sExt
/// @param sIDsExt 命令Cmb定义来自RibbonXmlCmd
/// @param pMainWndconst in) 主窗体
/// @param bCreatedNewOne 返回是否新建的,还是 原先的
/// @param bCreatedNewOne(out) 返回是否新建的,还是 原先的
/// @param bOnlyOneForCurTabWx(in) 为true则如果已有则直接返回false每次都会自动创建新的
/// @note 权宜之计:此处构造的窗体,无需额外删除(析构),系统会统一处理
static iSubWnd* makesureSubWnd(QString sID, QString sExt, \
const ZxMainWindow* pMainWnd, \
bool& bCreatedNewOne, \
bool bOnlyOneForCurTabWx = true);
/// @brief 执行一些特殊的功能按钮
/// @param pCmdInfo const in)命令Cmb定义
/// @param pMainWnd const in)主窗体
/// @return 只要是数值模块自己的按钮请返回true否则返回false
/// @note 此处指的是与SubWnd无关即不受SubWnd限制的功能按钮
static bool runCmdBySpecial(const iRibbonXmlCmd* pCmdInfo, \
const ZxMainWindow* pMainWnd);
/// @brief 执行一些特殊的功能按钮
/// @param sIDsExt(in) 命令Cmb定义来自RibbonXmlCmd
/// @param pMainWndconst in) 主窗体
/// @return 只要是数值模块自己的按钮请返回true否则返回false
/// @note 此处指的是与SubWnd无关即不受SubWnd限制的功能按钮
/// sID和sExt也是来自于RibbonXmlCmd
static bool runCmdBySpecial(QString sID, QString sExt, \
const ZxMainWindow* pMainWnd);
/// @brief 在当前没有激活数值SubWnd的情况下判断是否某些命令是否Enable
/// @param sID(in) 命令ID
/// @param sName(in) 命令Name
/// @param bLicensedconst in)当前是否正式授权
/// @param pMainWndconst in) 主窗体
/// @note sID和sName也是来自于RibbonXmlCmd
static bool isEnableOfID_Common(QString sID, QString sName, \
const bool bLicensed, \
const ZxMainWindow* pMainWnd);
/// @brief 当Ribbon上顶级Tab选项切换时触发/允许外部[比如数值试井]做些相应处理
/// @param pTab(in) 当前激活的是哪个Tab请iRibbonXmlTab进行筛选是不是自己需要的Tab
/// @param pMainWndconst in) 主窗体
static bool dealwithRibbonTab(iRibbonXmlTab* pTab, \
const ZxMainWindow* pMainWnd);
/// @brief 当首次切换为数值解时进行Dock目前设定两个的内容设定
/// @param pSubWndin) 当前的SubWndFitting窗体
static bool fillNmDockWxs(iSubWnd* pSubWnd);
/// @brief 解析解计算及结果刷新部分
/// @param pSubWndin) 当前的SubWndFitting窗体
/// @param pMainWndconst in) 主窗体
static bool nmCalAndFresh(iSubWnd* pSubWnd, \
const ZxMainWindow* pMainWnd);
/// @brief 获取解析解的当前参数相关信息,请根据需要调整该函数
/// @param pSubWndin) 当前的SubWndFitting窗体
static bool getAnaDockParas(iSubWnd* pSubWnd);
/// @brief 在成果保存时,辅助信息(如数值解相关)保存
/// @param pSubWndin) 基本上指的是 SubWndFitting 窗体
/// @param sRstName(in) 指的是成果的名称
/// @param pMainWndconst in) 主窗体
static bool saveRsts(iSubWnd* pSubWnd, \
QString sRstName, \
const ZxMainWindow* pMainWnd);
/**
* @brief 显式开始一次跨窗口数值成果保存会话。
* @note 外层遍历无论成功、失败或提前退出,都必须 commit 或 abort。
*/
static bool beginNumericalSaveSession(iSubWnd* pFirstSubWnd,
const QString& sRstName,
QString* pError = NULL);
/** @brief 将一个数值分析窗口写入当前保存代次。 */
static bool saveWindowGeneration(iSubWnd* pSubWnd,
const QString& sRstName,
QString* pError = NULL);
/** @brief 校验全部窗口并发布根清单,成功后结束会话。 */
static bool commitNumericalSaveSession(QString* pError = NULL);
/** @brief 中止当前保存会话,清理未发布代次。 */
static void abortNumericalSaveSession();
/// @brief 在成果加载时,辅助信息(如数值解相关)加载
/// @param pSubWndin) 基本上指的是 SubWndFitting 窗体
/// @param sRstName(in) 指的是成果的名称
/// @param pMainWndconst in) 主窗体
static bool loadRsts(iSubWnd* pSubWnd, \
QString sRstName, \
const ZxMainWindow* pMainWnd);
/// @brief 获取缓存的TabWidget指针确保弹窗与MDI切换使用同一个容器指针比较才能正确
ZxTabWidget* getTabWidget() const { return m_pTabWx; }
/// @brief 建立井列表变化与PEBI参数面板的刷新连接
/// @param pDataManager 数据管理器
/// @param pParaWx PEBI参数面板
static void connectWellListSignals(nmDataAnalyzeManager* pDataManager,
nmWxParaPropertyPebi* pParaWx);
public slots:
// 声明处理 ZxTabWidget 切换的槽函数
// 信号 currentChanged(int) 传递一个 int 参数
void slotHandleTabChange(int index);
// 外层MDI成果窗口切换后同步当前流动段分析窗口和左侧数值解面板
void slotHandleMdiSubWindowActivated(QMdiSubWindow* pSubWindow);
// 关闭成果或流动段分析后,释放对应的数据管理器
void slotHandleFittingDestroyed(QObject* pObject);
// 外层成果取消关闭时,恢复正常的页签清理逻辑
void slotHandleMdiClosing(bool& bAllowClose);
// 外层成果窗口析构后,移除保存的关闭状态
void slotHandleMdiDestroyed(QObject* pObject);
// 当前外层保存调用栈结束后,允许下一次保存重新发布完整代次
void slotClearCompletedNumericalSaveRoots();
protected:
// 在窗口仍完整时处理关闭事件,避免析构阶段访问已释放的画布对象
virtual bool eventFilter(QObject* pObject, QEvent* pEvent) override;
private:
// 统一装配新建、加载分析共用的数值设计与参数属性Dock控件
static void setupNumericalDockWidgets(nmDataAnalyzeManager* pDataManager,
nmSubWndMain* pSubWndMain,
iSubWndFitting* pSubWndFitting,
iDockBaseWx* pWxDockNm1,
iDockBaseWx* pWxDockNm2);
// 监听外层MDI成果窗口切换区别于成果窗口内部的页签切换
void connectMdiActivation(iSubWndFitting* pSubWndF);
// 单独关闭流动段分析页签时,移除仍引用其数据的画布图元
void detachFittingPlot(iSubWndFitting* pSubWndF);
// 关闭外层成果窗口时提前解除其Map图元对分析数据的引用
void detachMdiFittingPlots(ZxMdiSubWindow* pMdiChild);
// 因为边界是可以旋转的所以真实的顺序并非ee,se,we,ne根据索引传递查阅真实的比如 ee,se,we,ne
// xIndex 从1开始如果矩形则分别传入1,2,3,4 如果是圆形则传入1
static QString getBdyRealNameOf(int xIndex, QMap<QString, QVariant>& map);
// 存储当前操作的是哪一个窗体
ZxMainWindow* m_pMainWnd;
ZxTabWidget* m_pTabWx;
// destroyed信号异步处理时通过QObject地址取回析构前保存的分析窗口key
QMap<QObject*, iSubWndFitting*> m_mapFittingKeys;
// 外层成果窗口关闭时其画布已在MDI Close阶段清理后续子窗口Close不再重复处理
QSet<QObject*> m_closingMdiChildren;
/** @brief 当前显式跨窗口保存会话;析构时自动中止未提交代次。 */
nmNumericalSaveSession* m_pNumericalSaveSession;
/** @brief 本轮外层回调中已经完整发布的成果根目录,避免逐窗口重复写入。 */
QSet<QString> m_setCompletedNumericalSaveRoots;
};
/**
* @brief 外层跨窗口保存使用的 VS2010 兼容 RAII 中止守卫。
*
* begin 成功后立即创建守卫commit 成功后调用 release()。其他返回路径
* 会在析构时自动 abort确保未完成代次不会留给下一轮保存。
*/
class NM_SUB_WND_EXPORT nmNumericalSaveSessionAbortGuard
{
public:
/** @brief 创建仍处于生效状态的中止守卫。 */
nmNumericalSaveSessionAbortGuard();
/** @brief 未解除时中止当前数值保存会话。 */
~nmNumericalSaveSessionAbortGuard();
/** @brief commit 成功后解除自动中止。 */
void release();
private:
/** @brief 禁止复制中止守卫。 */
nmNumericalSaveSessionAbortGuard(
const nmNumericalSaveSessionAbortGuard&);
/** @brief 禁止赋值中止守卫。 */
nmNumericalSaveSessionAbortGuard& operator=(
const nmNumericalSaveSessionAbortGuard&);
private:
/** @brief 析构时是否仍需自动中止。 */
bool m_bAbortRequired;
};