成都网站建设设计

将想法与焦点和您一起共享

QScintilla入门指南之编辑器设置

一、文本环绕

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

在连云港等地区,都构建了全面的区域性战略布局,加强发展的系统性、市场前瞻性、产品创新能力,以专注、极致的服务理念,为客户提供做网站、成都网站设计 网站设计制作定制网站开发,公司网站建设,企业网站建设,成都品牌网站建设,营销型网站建设,外贸网站建设,连云港网站建设费用合理。

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入门指南之 自动补全(正在更新...)

名称栏目:QScintilla入门指南之编辑器设置
文章位置:http://chengdu.cdxwcx.cn/article/dscgico.html