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/nmSubWxs/nmWellboreStorageUiSupport.h

336 lines
16 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.

#ifndef NMWELLBORESTORAGEUISUPPORT_H
#define NMWELLBORESTORAGEUISUPPORT_H
#include "nmParameterField.h"
#include "iUnitGroup.h"
#include "iUnitHelper.h"
#include "ZxBaseUtil.h"
#include <QAbstractItemModel>
#include <QByteArray>
#include <QComboBox>
#include <QDialogButtonBox>
#include <QGridLayout>
#include <QHeaderView>
#include <QLabel>
#include <QKeyEvent>
#include <QLineEdit>
#include <QPersistentModelIndex>
#include <QPointer>
#include <QPushButton>
#include <QStyledItemDelegate>
#include <QTableWidget>
#include <QtCore/qnumeric.h>
// 仅供井筒储集计算器及其子窗口共用,不依赖井、分析管理器或求解器。
namespace nmWellboreStorageUi
{
// 由框架单位表处理上标别名及换算;失败时不返回带错误单位的原始数值。
inline bool convert(double dValue, const QString& sFrom, const QString& sTo, double& dResult)
{
if (!qIsFinite(dValue)) return false;
const QString sSource = nmParameterField::resolveUnitSpelling(sFrom);
const QString sTarget = nmParameterField::resolveUnitSpelling(sTo);
if (sSource == sTarget) {
dResult = dValue;
return true;
}
iUnitGroup* pGroup = iUnitHelper::getUnitGroupByUnit(sSource);
int nDigits = 6;
return pGroup && pGroup->indexOf(sTarget) >= 0
&& pGroup->convert(sSource, dValue, sTarget, dResult, nDigits) && qIsFinite(dResult);
}
// 自动回显最多六位有效数字并省略尾零;极小值使用科学计数法,避免显示成零。
// 仅缩短显示文字,计算和回填使用完整精度缓存;不截断用户正在输入的数字。
inline QString number(double dValue)
{
return qIsFinite(dValue) ? QString::number(dValue, 'g', 6) : QString();
}
// 统一主题高度和横向伸展策略;单位选项完全来自框架,缺失时仅保留基准单位。
inline QString populateUnits(QComboBox* pCombo, const QString& sBaseUnit)
{
const QString sUnit = nmParameterField::resolveUnitSpelling(sBaseUnit);
iUnitGroup* pGroup = iUnitHelper::getUnitGroupByUnit(sUnit);
const bool bBlocked = pCombo->blockSignals(true);
pCombo->clear();
if (pGroup) pCombo->addItems(pGroup->getAllUnitNames());
if (pCombo->count() == 0) pCombo->addItem(sUnit);
pCombo->setCurrentIndex(pCombo->findText(sUnit));
pCombo->setEnabled(pGroup && pCombo->count() > 1);
pCombo->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
pCombo->setSizeAdjustPolicy(QComboBox::AdjustToContents);
pCombo->blockSignals(bBlocked);
return sUnit;
}
// 单位切换失败时恢复旧选择,保留用户尚未修正的输入,避免递归触发切换槽。
inline void restoreUnit(QComboBox* pCombo, const QString& sUnit)
{
const bool bBlocked = pCombo->blockSignals(true);
pCombo->setCurrentIndex(pCombo->findText(sUnit));
pCombo->blockSignals(bBlocked);
}
// 参数名称右对齐,字段和单位按 8:5 分配宽度;控件高度由字体与主题决定。
inline QGridLayout* form(QWidget* pParent)
{
pParent->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
QGridLayout* pGrid = new QGridLayout(pParent);
pGrid->setContentsMargins(8, 15, 8, 10);
pGrid->setHorizontalSpacing(6);
pGrid->setVerticalSpacing(6);
pGrid->setColumnStretch(1, 8);
pGrid->setColumnStretch(2, 5);
return pGrid;
}
// 标准确定/取消按钮,文本由调用窗口翻译,避免子窗口依赖彼此的翻译上下文。
inline QDialogButtonBox* buttons(QWidget* pParent, const QString& sOk, const QString& sCancel)
{
QDialogButtonBox* pButtons = new QDialogButtonBox(
QDialogButtonBox::Ok | QDialogButtonBox::Cancel, Qt::Horizontal, pParent);
pButtons->button(QDialogButtonBox::Ok)->setText(sOk);
pButtons->button(QDialogButtonBox::Ok)->setIcon(zxLoadIcon("OK"));
pButtons->button(QDialogButtonBox::Cancel)->setText(sCancel);
pButtons->button(QDialogButtonBox::Cancel)->setIcon(zxLoadIcon("Cancel"));
pButtons->button(QDialogButtonBox::Ok)->setAutoDefault(false);
pButtons->button(QDialogButtonBox::Cancel)->setAutoDefault(false);
pButtons->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
pButtons->setContentsMargins(4, 5, 4, 5);
return pButtons;
}
}
// 一个数值/单位字段,缓存业务基准值;控件由窗口拥有,字段对象跟随父窗口释放。
class nmWellboreStorageUnitField : public QObject
{
public:
// 创建框架单位下拉框及输入框;只读字段用于计算结果。
nmWellboreStorageUnitField(QWidget* pParent, const QString& sBaseUnit, bool bReadOnly = false)
: QObject(pParent), m_pEdit(new QLineEdit(pParent)), m_pUnitCombo(new QComboBox(pParent)),
m_sBaseUnit(nmWellboreStorageUi::populateUnits(m_pUnitCombo, sBaseUnit)),
m_sDisplayUnit(m_sBaseUnit), m_dBaseValue(qQNaN())
{
m_pEdit->setReadOnly(bReadOnly);
m_pEdit->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
}
// 将完整字段加入表单,不设置固定像素宽高。
void addTo(QGridLayout* pGrid, int nRow, const QString& sLabel)
{
QLabel* pLabel = new QLabel(sLabel, m_pEdit->parentWidget());
pLabel->setAlignment(Qt::AlignRight | Qt::AlignVCenter);
pGrid->addWidget(pLabel, nRow, 0);
pGrid->addWidget(m_pEdit, nRow, 1);
pGrid->addWidget(m_pUnitCombo, nRow, 2);
}
// 返回编辑器供窗口连接输入变化信号,不转移所有权。
QLineEdit* editor() const { return m_pEdit; }
// 返回单位框供窗口连接切换信号,不转移所有权。
QComboBox* unitCombo() const { return m_pUnitCombo; }
// 未修改显示文本时直接读取原值;非法文本返回失败,不恢复或复用旧结果。
bool read(double& dValue)
{
if (m_pEdit->text() != m_sShownText) {
bool bOk = false;
const double dDisplay = m_pEdit->text().toDouble(&bOk);
double dBase = 0.0;
if (!bOk || !nmWellboreStorageUi::convert(dDisplay, m_sDisplayUnit, m_sBaseUnit, dBase))
return false;
m_dBaseValue = dBase;
m_sShownText = m_pEdit->text();
}
dValue = m_dBaseValue;
return qIsFinite(dValue);
}
// 写入基准值并刷新显示;失败则清空结果,避免继续显示过期数值。
bool setValue(double dValue)
{
double dDisplay = 0.0;
if (!nmWellboreStorageUi::convert(dValue, m_sBaseUnit, m_sDisplayUnit, dDisplay)) {
clear();
return false;
}
m_dBaseValue = dValue;
showValue(dDisplay);
return true;
}
// 先按旧单位收齐文本,再按候选单位显示;任何失败均恢复旧单位选择。
bool changeUnit()
{
const QString sNext = m_pUnitCombo->currentText();
double dBase = 0.0, dDisplay = 0.0;
// 无有效结果时仍允许选择显示单位,后续计算成功后按新单位回显。
if (m_pEdit->isReadOnly() && !qIsFinite(m_dBaseValue)) {
if (!nmWellboreStorageUi::convert(0.0, m_sBaseUnit, sNext, dDisplay)) {
nmWellboreStorageUi::restoreUnit(m_pUnitCombo, m_sDisplayUnit);
return false;
}
m_sDisplayUnit = sNext;
return true;
}
if (!read(dBase) || !nmWellboreStorageUi::convert(dBase, m_sBaseUnit, sNext, dDisplay)) {
nmWellboreStorageUi::restoreUnit(m_pUnitCombo, m_sDisplayUnit);
return false;
}
m_sDisplayUnit = sNext;
showValue(dDisplay);
return true;
}
// 清空无效结果及原值缓存,之后不能从旧文字获得可回填数值。
void clear()
{
m_dBaseValue = qQNaN();
m_sShownText.clear();
const bool bBlocked = m_pEdit->blockSignals(true);
m_pEdit->clear();
m_pEdit->blockSignals(bBlocked);
}
private:
// 程序回显屏蔽 textChanged;由业务窗口在操作结束时统一重新计算。
void showValue(double dDisplay)
{
m_sShownText = nmWellboreStorageUi::number(dDisplay);
const bool bBlocked = m_pEdit->blockSignals(true);
m_pEdit->setText(m_sShownText);
m_pEdit->blockSignals(bBlocked);
}
QLineEdit* m_pEdit; // 数值编辑器,Qt 父控件负责释放。
QComboBox* m_pUnitCombo; // 框架单位列表,Qt 父控件负责释放。
QString m_sBaseUnit; // 计算和跨窗口传值使用的基准单位。
QString m_sDisplayUnit; // 上次成功切换的单位,用于解释尚未提交的文字。
QString m_sShownText; // 与缓存原值对应的显示文字,避免单位往返损失精度。
double m_dBaseValue; // 完整精度的业务基准值,NaN 表示当前没有有效结果。
};
// 体积表格的编辑委托,负责在单位切换、删行和确定前提交尚未失焦的单元格。
class nmWellboreStorageCellDelegate : public QStyledItemDelegate
{
public:
// 委托由表格拥有,不持有业务数据。
explicit nmWellboreStorageCellDelegate(QObject* pParent) : QStyledItemDelegate(pParent), m_bRestoring(false) {}
// 创建文本编辑器,支持科学计数法且不截断原有精度。
QWidget* createEditor(QWidget* pParent, const QStyleOptionViewItem&, const QModelIndex& oIndex) const
{
m_pEditor = new QLineEdit(pParent);
m_oIndex = oIndex;
m_sOriginalText = oIndex.data(Qt::EditRole).toString();
m_oOriginalBaseValue = oIndex.data(Qt::UserRole);
if (m_pEditReceiver)
QObject::connect(m_pEditor, SIGNAL(textEdited(QString)), m_pEditReceiver, m_sEditSlot.constData());
return m_pEditor;
}
// 记录初始文本,仅进入编辑再离开不反向覆盖基准值。
void setEditorData(QWidget* pEditor, const QModelIndex& oIndex) const
{
QLineEdit* pLine = static_cast<QLineEdit*>(pEditor);
const QString sText = oIndex.data(Qt::EditRole).toString();
// 即时提交引起的 model 更新不能重置用户的光标和选区。
if (pLine->property("initialText").isValid() && pLine->text() == sText) return;
pLine->setText(sText);
pLine->setProperty("initialText", sText);
pLine->selectAll();
}
// 真正修改后交由窗口解析;非法文本保留供用户修正。
void setModelData(QWidget* pEditor, QAbstractItemModel* pModel, const QModelIndex& oIndex) const
{
QLineEdit* pLine = static_cast<QLineEdit*>(pEditor);
if (pLine->text() != pLine->property("initialText").toString())
pModel->setData(oIndex, pLine->text(), Qt::EditRole);
pLine->setProperty("initialText", pLine->text());
}
// Esc 保留表格原有的撤销单元格语义,并恢复完整精度基准值。
bool eventFilter(QObject* pObject, QEvent* pEvent)
{
if (pObject == m_pEditor && pEvent->type() == QEvent::KeyPress
&& static_cast<QKeyEvent*>(pEvent)->key() == Qt::Key_Escape && m_oIndex.isValid()) {
m_bRestoring = true;
m_pEditor->setText(m_sOriginalText);
emit commitData(m_pEditor);
// 即使用户重新输入了相同显示文本,也要恢复编辑前的未舍入原值。
QAbstractItemModel* pModel = const_cast<QAbstractItemModel*>(m_oIndex.model());
pModel->setData(m_oIndex, m_oOriginalBaseValue, Qt::UserRole);
m_bRestoring = false;
}
return QStyledItemDelegate::eventFilter(pObject, pEvent);
}
// 在撤销通知期间向业务窗口提供原始缓存,避免再次解析舍入显示文字。
bool restoredBaseValue(QVariant& oValue) const
{
oValue = m_oOriginalBaseValue;
return m_bRestoring;
}
// 将输入变化交给业务窗口即时重算,使最后一个单元格填完后即可点击确定。
void setEditReceiver(QObject* pReceiver, const char* pSlot)
{
m_pEditReceiver = pReceiver;
m_sEditSlot = pSlot;
}
// 即时写入当前文字但保留编辑器、光标及选区,不打断连续输入。
void commit()
{
if (m_pEditor && m_pEditor->isVisible() && m_oIndex.isValid()) emit commitData(m_pEditor);
}
// Qt 4 关闭编辑器后延迟删除,检查可见性和索引以免重复提交旧编辑器。
void finish()
{
if (!m_pEditor || !m_pEditor->isVisible() || !m_oIndex.isValid()) return;
QLineEdit* pEditor = m_pEditor;
emit commitData(pEditor);
emit closeEditor(pEditor, QAbstractItemDelegate::NoHint);
m_pEditor = nullptr;
}
private:
mutable QPointer<QLineEdit> m_pEditor; // 当前活动编辑器的弱引用。
mutable QPersistentModelIndex m_oIndex; // 当前编辑位置,结构变化时可检测失效。
QPointer<QObject> m_pEditReceiver; // 业务窗口弱引用,负责即时计算及确定按钮状态。
QByteArray m_sEditSlot; // 业务窗口接收输入变化的槽签名。
mutable QString m_sOriginalText; // 本次进入编辑时的显示文本,供 Esc 撤销。
mutable QVariant m_oOriginalBaseValue; // 本次进入编辑时的完整精度基准值。
bool m_bRestoring; // 撤销单元格期间通知业务层直接恢复基准缓存。
};
// 两个子窗口共用的主题表格,单位行不作为数据行,纵向空间交给表格伸展。
class nmWellboreStorageTable : public QTableWidget
{
public:
// 预留单位行;调用方按用途指定推荐数据行数和每列字符数,仅用于初始尺寸。
nmWellboreStorageTable(int nColumns, QWidget* pParent, int nPreferredRows, int nColumnCharacters)
: QTableWidget(1, nColumns, pParent), m_pDelegate(new nmWellboreStorageCellDelegate(this)),
m_nPreferredRows(qMax(1, nPreferredRows)), m_nColumnCharacters(qMax(1, nColumnCharacters))
{
setItemDelegate(m_pDelegate);
setAlternatingRowColors(true);
setSelectionBehavior(QAbstractItemView::SelectRows);
setSelectionMode(QAbstractItemView::SingleSelection);
horizontalHeader()->setResizeMode(QHeaderView::Stretch);
verticalHeader()->setResizeMode(QHeaderView::ResizeToContents);
setVerticalHeaderItem(0, new QTableWidgetItem(QString()));
}
// 按字体和推荐行数计算初始尺寸;仅提供布局建议,实际宽高仍可随窗口伸展。
QSize sizeHint() const
{
// 有数据时使用实际行高,避免主题行高与默认行高不同导致可见行数偏差。
const int nDataRowHeight = rowCount() > 1 ? rowHeight(1) : verticalHeader()->defaultSectionSize();
return QSize(fontMetrics().width(QLatin1Char('0')) * m_nColumnCharacters * columnCount()
+ verticalHeader()->sizeHint().width() + frameWidth() * 2,
horizontalHeader()->sizeHint().height() + rowHeight(0)
+ nDataRowHeight * m_nPreferredRows + frameWidth() * 2);
}
// 指定即时编辑通知的接收者,规格只读表不需要设置。
void setEditReceiver(QObject* pReceiver, const char* pSlot) { m_pDelegate->setEditReceiver(pReceiver, pSlot); }
// 撤销单元格时读取编辑前的基准缓存,正常编辑返回 false。
bool restoredBaseValue(QVariant& oValue) const { return m_pDelegate->restoredBaseValue(oValue); }
// 即时提交输入并保留编辑器,供体积窗口更新当前结果。
void commitEditing() { m_pDelegate->commit(); }
// 将表格活动编辑写回旧单位上下文,再执行后续业务操作。
void finishEditing() { m_pDelegate->finish(); }
private:
nmWellboreStorageCellDelegate* m_pDelegate; // 表格持有的文本编辑委托。
int m_nPreferredRows; // 初始推荐展示的数据行数,不含第 0 行单位行。
int m_nColumnCharacters; // 每列推荐容纳的字符数,结合当前字体计算列宽。
};
#endif // NMWELLBORESTORAGEUISUPPORT_H