一、文本环绕

如果没有文本换行，那么一行可能会变得越来越⻓。而文本环绕则会⾃动断行，使得所有内容都适应可见窗口。注意，如果开启文本环绕，则环绕行不会增加行号。

1.1 环绕模式

文本环绕有多种风格，更改环绕模式的接口如下：

virtual void QsciScintilla::setWrapMode(WrapMode mode)

其中，枚举变量WrapMode的不同类型如下：

• WrapNone ：关闭环绕模式
• WrapWord ：在单词边界处环绕
  
• WrapCharacter ：在字符边界处环绕
  
• WrapWhitespace : 在空白符边界环绕
  

1.2 环绕标志可见性

文本环绕标志可通过如下接口 开启/关闭：

void QsciScintilla::setWrapVisualFlags(WrapVisualFlag endFlag, WrapVisualFlag startFlag = WrapFlagNone, int indent = 0)

其中，枚举变量WrapVisualFlag的不同类型如下：

• WrapFlagNone ：不显示环绕标志
• WrapFlagByText ：在文本中环绕标志
• WrapFlagByBorder ：在边界显示环绕标志
• WrapFlagInMargin ：在行号区显示环绕标志

endFlag参数和startFlag参数用来确定是否以及在何处显示行尾和行首的标志。indent参数则用来设置换行的缩进字符数。

indent 参数只有将WrapIndentMode设置为WrapIndentFixed，才可以看到其效果，设置方法见环绕缩进模式。

endFlag 和 startFlag 设置为不同参数的样式如下：

---

• 如果 endFlag == WrapFlagNone
  
• 如果 endFlag == WrapFlagByText
  
• 如果 endFlag == WrapFlagByBorder
  
• 如果 endFlag == WrapFlagInMargin
  

---

• 如果 startFlag == WrapFlagNone
  
• 如果 startFlag == WrapFlagByText
  
• 如果 startFlag == WrapFlagInMargin
  

1.3 环绕缩进模式

环绕模式可以有缩进，可以通过如下接口设置：

void QsciScintilla::setWrapIndentMode(WrapIndentMode mode)

其中，枚举变量WrapIndentMode的不同模式如下：

• WrapIndentFixed ：环绕的子行按照由setWrapVisualFlags()设置的值进行缩进
  
• WrapIndentSame ：环绕的子行与第一个子行相同
  
• WrapIndentIndented ：环绕的子行与第一个子行相同的量上再加上一个缩进级别
  
• WrapIndentDeeplyIndented ：环绕的子行与第一个子行相同的量上再加上两个缩进级别
  

缩进的宽度可以通过如下接口设置：

virtual void QsciScintilla::setTabWidth(int width)

二、行结尾符

文本中的每一行都是以行结尾符(End of Line, EOF)来结尾。在⼤多数⽂本编辑器⾥，此字符不可见。但是，如果需要，可以显示它。注意，EOL 字符对于 Linux、Windows 和 Mac 等不同的操作系统其内容是不⼀样的：

• Windows： \r\n
• Unix/Linux： \n
• Mac： \r

2.1 EOL模式

EOL模式可以通过如下接口设置：

virtual void QsciScintilla::setEolMode(EolMode mode)

其中，对于不同系统枚举变量EolMode的设置方法如下：

editor->setEolMode(QsciScintilla::EolWindows);
editor->setEolMode(QsciScintilla::EolUnix);
editor->setEolMode(QsciScintilla::EolWMac);

2.2 EOL可见性

EOL符号的可见性可以通过如下接口设置：

virtual void QsciScintilla::setEolVisibility(bool visible)

• 如果设置为false：则 EOL 符号不可见
  
• 如果设置为true：则 EOL 符号可见
  

三、缩进

3.1 缩进字符

默认的缩进字符是" "，即空格。可以通过如下函数设置是否使用\t字符，即 Tab：

virtual void QsciScintilla::setIndentationsUseTabs(bool tabs)

如果设置为false，则采用空格缩进；如果设置为true，则采用 Tab 缩进。

3.2 缩进宽度

可以通过如下接口设置缩进的宽度：

virtual void QsciScintilla::setTabWidth	(int width)

使用 Tab 键完成缩进时，此参数定义了 Tab 字符的宽度，即为空格的倍数。

3.3 缩进提示

QScintilla 可以显示虚线垂直线以用来指示该行的缩进级别，其接口为：

virtual void QsciScintilla::setIndentationGuides(bool enable)

• 如果设置为false：则缩进级别不可见
  
• 如果设置为true：则缩进级别可见
  

3.4 空格缩进

如果需要当在光标处存在空格时影响 Tab 键的行为，则可以使用如下接口设置：

virtual void QsciScintilla::setTabIndents(bool indent)

• 如果设置为false：则每当按下 Tab 键时，编辑器只需插入 n 个空格（也就是一个\t字符）
  
• 如果设置为true：则编辑器会将第一个非空格字符推送到下一个缩进级别处
  

3.5 自动缩进

插入新行时，自动缩进会将光标推送到与前一个光标相同的缩进级别，其设置的接口如下：

virtual void QsciScintilla::setAutoIndent(bool autoindent)

• 如果设置为false：
  
• 如果设置为true：
  

注意：词法分析器可以使用其 setAutoIndentStyle 方法来修改此行为。

四、光标

编辑器可以以不同的颜色和形状来显示光标。

4.1 光标前景色

光标前景色即为光标本身的颜色，可以通过如下接口设置：

virtual void setCaretForegroundColor(const QColor &col)

4.2 高亮当前行

可以通过如下接口来设置是否高亮当前行：

virtual void QsciScintilla::setCaretLineVisible(bool enable)

• 如果设置为false：
  
• 如果设置为true：
  

4.3 当前行背景色

默认情况下，高亮当前行的颜色为黄色，可以通过如下接口修改当前行的颜色：

virtual void setCaretLineBackgroundColor(const QColor &col)

4.4 光标宽度

可以通过如下接口来设置光标宽度，其以像素为单位。注意：如果设置为0，则光标不可见！

virtual void setCaretWidth(int width)

五、代码实例

在mainwindow.cpp中添加如下代码：

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    editor = new QsciScintilla(this);
    setCentralWidget(editor);

    // 编辑器设置
    // ----------------------------------------
    // 设置Tab键为4个空格
    editor->setTabWidth(4);
    // 开启自动缩进
    editor->setAutoIndent(true);
    // 高亮当前行
    editor->setCaretLineVisible(true);
    // 设置当前行颜色
    editor->setCaretLineBackgroundColor(QColor("#E8E8FF"));
    // 编辑器放大
    editor->zoomIn(8);
}

运行结果如下图所示：

---

其余该系列文章如下：

1. QScintilla入门指南之 基本介绍
2. QScintilla入门指南之 边界栏
3. QScintilla入门指南之 词法分析器(正在更新...)
4. QScintilla入门指南之 可点击文本(正在更新...)
5. QScintilla入门指南之 自动补全(正在更新...)