Qt文本编辑器缩进异常求助：显示错误与自定义缩进失效排查

需求：获取文本部件当前左右缩进值并显示，接收用户输入的自定义缩进值（范围0-14）并应用。
存在两个问题：

• 显示的缩进值不正确
• 对话框输入自定义值后，有时仅将值递增1，有时无任何响应

相关代码 #

增加缩进函数 #

/*!
 * \fn MainWindow::on_actionIncrease_Indent_triggered
 * \brief Adding Indentation upto 14.65 {i.e. touched right margin} {in cm}
*/
void MainWindow::on_actionIncrease_Indent_triggered(int left, int right)
{
    if(!curr_browser || curr_browser->isReadOnly())
        return;
    QMargins margin = curr_browser->contentsMargins();
    QTextCursor cursor = curr_browser->textCursor();

    QTextBlock block = cursor.block();
    QTextBlockFormat blockFormat = block.blockFormat();

    int presentIndent = blockFormat.indent();


    int indent = 1+presentIndent;

    if(left != 0) indent = left;
    if(indent > 14) return;

    if(right == 0)blockFormat.setRightMargin(margin.right());
    else blockFormat.setRightMargin(right);
    blockFormat.setIndent(indent);

    //    qDebug()<<"Increase Indent ->"<<blockFormat.indent();

    cursor.mergeBlockFormat(blockFormat);

}

减少缩进函数 #

/*!
 * \fn MainWindow::on_actionDecrease_Indent_triggered
 * \brief Removing Indentation upto 0 {i.e. touches Left margin} {in cm}
*/
void MainWindow::on_actionDecrease_Indent_triggered()
{
    if(!curr_browser || curr_browser->isReadOnly())
        return;
    QMargins margin = curr_browser->contentsMargins();
    QTextCursor cursor = curr_browser->textCursor();

    QTextBlock block = cursor.block();
    QTextBlockFormat blockFormat = block.blockFormat();

    int presentIndent = blockFormat.indent();

    int indent = presentIndent-1;

    if(indent < 0) return;

    blockFormat.setLeftMargin(margin.left());
    blockFormat.setIndent(presentIndent - 1);

    //    qDebug()<<"Decrease Indent ->"<<blockFormat.indent();

    cursor.mergeBlockFormat(blockFormat);
}

缩进选项对话框触发函数 #

void MainWindow::on_actionIndentation_Options_triggered()
{
    if(!curr_browser || curr_browser->isReadOnly())
        return;
    QMargins margin = curr_browser->contentsMargins();
    QTextCursor cursor = curr_browser->textCursor();
    QTextBlock block = cursor.block();
    QTextBlockFormat blockFormat = block.blockFormat();
    int left = blockFormat.indent(), right = margin.right() - blockFormat.rightMargin();
    indentOptions *i = new indentOptions(this, &left, &right);
    i->show();
    connect(i, &indentOptions::dialogAccepted, this, [=](){
        if(left + right <= 14){
            on_actionIncrease_Indent_triggered(left, right);
        }
        i->deleteLater();
    });
}

缩进对话框构造函数 #

indentOptions::indentOptions(QWidget *parent, int* left, int* right) :
    QDialog(parent),
    ui(new Ui::indentOptions)
{
    ui->setupUi(this);
    this->left = left;
    this->right = right;
    setWindowTitle("Set Indentation");
    ui->textEdit_left->setText(QString::number(*left));
    ui->textEdit_right->setText(QString::number(*right));
}

错误排查与修复方案 #

1. 显示缩进值不正确的原因与修复 #

原因

• 右缩进计算逻辑错误：right = margin.right() - blockFormat.rightMargin()混淆了QTextBlockFormat::rightMargin()的含义，该函数返回的是文本内容到部件右边界的距离，用户需要的右缩进值应直接取此值，而非反向计算。
• 对话框未同步用户输入：indentOptions仅初始化显示值，但未将用户输入的新值写回传入的指针变量，导致后续应用的仍是初始值。

修复

• 修正右缩进计算逻辑：

  // 原代码
  // int left = blockFormat.indent(), right = margin.right() - blockFormat.rightMargin();
  // 修正为
  int left = blockFormat.indent();
  int right = blockFormat.rightMargin(); // 直接取文本到右边界的距离作为右缩进值
  

• 给indentOptions添加确认按钮槽函数，同步用户输入：

  // 在indentOptions类中实现
  void indentOptions::on_buttonBox_accepted()
  {
      bool ok;
      int newLeft = ui->textEdit_left->text().toInt(&ok);
      if (ok && newLeft >= 0 && newLeft <= 14) {
          *left = newLeft;
      }
      int newRight = ui->textEdit_right->text().toInt(&ok);
      if (ok && newRight >= 0 && newRight <= 14) {
          *right = newRight;
      }
      emit dialogAccepted();
  }
  

  确保UI中QDialogButtonBox的accepted信号连接到该槽函数。

2. 自定义缩进应用无效/仅递增1的原因与修复 #

原因

• 默认参数冲突：on_actionIncrease_Indent_triggered默认参数为0，而0是合法缩进值，导致用户输入0时被判定为默认递增逻辑，执行indent = 1+presentIndent。
• 右缩进设置逻辑错误：原代码中blockFormat.setRightMargin(right)未校验右缩进的范围，且逻辑依赖默认值0的判断存在歧义。
• 减少缩进函数冗余操作：blockFormat.setLeftMargin(margin.left())会覆盖indent()设置的左缩进，导致缩进值异常。

修复

• 修改on_actionIncrease_Indent_triggered默认参数为-1，区分默认递增与用户输入0的场景：

  // 修改函数声明为
  void MainWindow::on_actionIncrease_Indent_triggered(int left = -1, int right = -1)
  // 函数内部逻辑修正
  void MainWindow::on_actionIncrease_Indent_triggered(int left, int right)
  {
      if(!curr_browser || curr_browser->isReadOnly())
          return;
      QTextCursor cursor = curr_browser->textCursor();
      QTextBlock block = cursor.block();
      QTextBlockFormat blockFormat = block.blockFormat();
  
      int targetIndent = blockFormat.indent();
      int targetRightMargin = blockFormat.rightMargin();
  
      // 处理左缩进
      if (left != -1) {
          if (left < 0 || left > 14) return;
          targetIndent = left;
      } else {
          targetIndent += 1;
          if (targetIndent > 14) return;
      }
  
      // 处理右缩进
      if (right != -1) {
          if (right < 0 || right > 14) return;
          targetRightMargin = right;
      }
  
      blockFormat.setIndent(targetIndent);
      blockFormat.setRightMargin(targetRightMargin);
      cursor.mergeBlockFormat(blockFormat);
  }
  

• 移除减少缩进函数中的冗余代码：

  void MainWindow::on_actionDecrease_Indent_triggered()
  {
      if(!curr_browser || curr_browser->isReadOnly())
          return;
      QTextCursor cursor = curr_browser->textCursor();
      QTextBlock block = cursor.block();
      QTextBlockFormat blockFormat = block.blockFormat();
  
      int presentIndent = blockFormat.indent();
      int indent = presentIndent - 1;
      if(indent < 0) return;
  
      blockFormat.setIndent(indent);
      // 移除blockFormat.setLeftMargin(margin.left());
      cursor.mergeBlockFormat(blockFormat);
  }
  

内容的提问来源于stack exchange，提问作者AayushGupta69