QML学习(四)——<Text显示>

文本显示是界面开发必不可少的内容，在Qt Quick模块中提供了 Text 项目来进行文本的显示，其中可以使用 font 属性组对文本字体进行设置。这一篇我们来看看它们的具体使用。

使用字体

就像前面教程中提到过的，在文本中可以使用 font 属性组来设置字体，常用的属性如下：

• font.bold：是否加粗，取值为true或false
• font.capitalization：大写策略，取值为
  • Font.MixedCase不改变大小写（默认值）；
  • Font.AllUppercase全部大写；
  • Font.AllLowercase全部小写；
  • Font.SmallCaps小型大写字母（即小写字母变为大写但不改变字体原始的大小）；
  • Font.Capitalize：首字母大写
• font.family：字体族，取值为字体族的名字（区分大小写）
• font.italic：是否斜体，取值为true或false
• font.letterSpacing：字符间距，正值加大间距，负值减小间距
• font.pixelSize：字号大小，取值为整数（单位为像素，依赖于设备）
• font.pointSize：字号大小，取值为大于0的值（是设备无关的）
• font.strikeout：是否有删除线，取值为true或false
• font.underline：是否有下划线，取值为true或false
• font.weight：字体重量，取值为Font.Thin、Font.Light、Font.ExtraLight、Font.Normal（默认）、Font.Medium、Font.DemiBold、Font.Bold、Font.ExtraBold 和 Font.Black
• font.wordSpacing：单词间距，正值加大间距，负值减小间距

我们可以直接使用点表示法来使用一个属性，也可以使用组表示法来一次指定多个属性，建议使用组表示法，这样代码的可读性更好。下面来看一个示例：

Text {
    id: text1
    anchors.centerIn: parent
    text: "hello qt! Hello World!"
}

Text {
    id: text2
    anchors.top: text1.bottom
    anchors.topMargin: 10
    anchors.horizontalCenter: text1.horizontalCenter
    text: "hello qt! Hello World!"

    font.weight: Font.ExtraBold
    font.pointSize: 20
    font.letterSpacing: 3
    font.wordSpacing: 6
    font {
        capitalization: Font.AllLowercase
        italic: true
        underline: true
    }
    font.family: webFont.name
    FontLoader {
        id: webFont
        source: "http://qter-images.qter.org/other/myfont.ttf"
        onStatusChanged: if (webFont.status == FontLoader.Ready)
                                 console.log('Loaded')
    }
}

这里最后使用了 FontLoader 类型来加载一个字体，可以通过设置 source 属性来指定一个字体名称或者网络 url 地址，比如这里使用了网上的一个 ttf 字体，当使用网络字体时，可以通过 status 属性来获取加载的状态。下图是运行效果。

文本裁剪

Text 项目是可以设置宽度的，当里面的文本内容超出 Text 的宽度时，可以使用 clip 属性设置文本是否被裁剪。下面来看一个例子：

Column{
    anchors.centerIn: parent
    spacing: 5

    Rectangle {
         186; height: 30
        color: "lightblue"

        Text {
            text: "hello qt! Hello World!"
            font.pointSize: 15
        }
    }
    Rectangle {
         186; height: 30
        color: "lightblue"

        Text {
            text: "hello qt! Hello World!"
            font.pointSize: 15
             186
            clip: true
        }
    }

    Rectangle {
         186; height: 30
        color: "lightgreen"

        Text {
            anchors.centerIn: parent
            text: "hello qt! Hello World!"
            font.pointSize: 15
        }
    }

    Rectangle {
         186; height: 30
        color: "lightgreen"

        Text {
            anchors.centerIn: parent
            text: "hello qt! Hello World!"
            font.pointSize: 15
             186
            clip: true
        }
    }
}

运行效果如下图所示。

文本省略

如果使用 clip 属性，当文本超出边界后会被突然截断，这样可能在边界只显示了单词或字母的局部，非常不友好。在 Text 中还提供了 elide 属性，可以通过省略文本的部分内容来匹配文本的宽度，其取值包括Text.ElideNone （默认）、Text.ElideLeft、Text.ElideMiddle 和 Text.ElideRight ，需要注意的是，该属性也是在设置了 Text 宽度时才有作用。下面看一段示例代码：

Column{
    anchors.centerIn: parent
    spacing: 5

    Rectangle {
         186; height: 30
        color: "lightblue"

        Text {
             186
            text: qsTr("hello qt! Hello World!文本省略")
            font.pointSize: 15
            elide: Text.ElideLeft
        }
    }

    Rectangle {
         186; height: 30
        color: "lightblue"

        Text {
             186
            text: qsTr("hello qt! Hello World!文本省略")
            font.pointSize: 15
            elide: Text.ElideMiddle
        }
    }

    Rectangle {
         186; height: 30
        color: "lightblue"

        Text {
             186
            text: qsTr("hello qt! Hello World!文本省略")
            font.pointSize: 15
            elide: Text.ElideRight
        }
    }
}

运行效果如下图所示。

文本换行

对于过长的文本，除了进行省略以外，也可以使用 wrapMode 来设置换行，可用的换行模式包括：Text.NoWrap (默认) 、Text.WordWrap、Text.WrapAnywhere 和Text.Wrap。当设定了 Text 的高度 height，或者最大行数 maximumLineCount 后，换行和省略可以同时使用。下面来看一个例子，在前面代码的基础上继续添加如下代码：

Rectangle {
     186; height: 50
    color: "lightgreen"

    Text {
         186
        text: qsTr("hello qt! Hello World!文本换行")
        font.pointSize: 15
        wrapMode: Text.WordWrap
    }
}

Rectangle {
     186; height: 50
    color: "lightgreen"

    Text {
         186
        text: qsTr("hello qt! Hello World!文本换行")
        font.pointSize: 15
        wrapMode: Text.WrapAnywhere
    }
}

Rectangle {
     186; height: 50
    color: "lightgreen"

    Text {
         186; height: 50
        text: qsTr("hello qt! Hello World!文本换行的同时也可以省略")
        font.pointSize: 15
        wrapMode: Text.WrapAnywhere
        elide: Text.ElideRight
    }
}

运行效果如下图所示。

文本样式

使用 Text 的 style 属性可以设置文本的样式，包括：Text.Normal(默认)、Text.Outline、Text.Raised 和 Text.Sunken ，下面是示例：

Row { 
    spacing: 10

    Text { font.pointSize: 24; text: "Normal" }

    Text { font.pointSize: 24; text: "Raised"; color: "white"
        style: Text.Raised; styleColor: "blue" }

    Text { font.pointSize: 24; text: "Outline";
        style: Text.Outline; styleColor: "red" }

    Text { font.pointSize: 24; text: "Sunken"; color: "white"
        style: Text.Sunken; styleColor: "black" }
}

运行效果如下图所示。

对齐方式

当设置了 Text 的宽度和高度以后，可以通过 horizontalAlignment 和 verticalAlignment 来设置文本内容的对齐方式，水平方向包括：Text.AlignLeft、 Text.AlignRight、 Text.AlignHCenter 和 Text.AlignJustify；垂直方向包括：Text.AlignTop、 Text.AlignBottom  和 Text.AlignVCenter 。下面是示例代码：

Rectangle {
     300; height: 50
    color: "gold"

    Text {
         300; height: 50
        text: qsTr("hello qt! Hello World!")
        font.pointSize: 15
        horizontalAlignment: Text.AlignHCenter
        verticalAlignment: Text.AlignBottom
    }
}

运行效果如下图所示。

显示富文本

Text 项目除了显示纯文本以外，也可以显示富文本。通过 textFormat 属性可以设置文本格式，包括：

• Text.AutoText (默认)：自动判断以什么样式来进行显示；

• Text.PlainText：以纯文本进行显示；

• Text.StyledText：是一种支持基本文本样式标签的优化格式，例如HTML 3.2中的标签：

  <b></b>
  <strong></strong>
  <i></i>
  <br>
  <p>
  <u>
  <font color="color_name" size="1-7"></font>
  <h1> to <h6>
  <a href="">
  <img src="" align="top,middle,bottom" width="" height="">
  <ol type="">, <ul type=""> , <li>
  <pre></pre>
  > < &

• Text.RichText：可以显示富文本，支持 HTML 4 规范的标签，具体支持的标签内容可以在帮助 Supported HTML Subset 文档种进行查看。为了获取更好的性能，建议使用 Text.PlainText 或 Text.StyledText 。

下面是示例代码：

Text {
    font.pointSize: 24
    text: "<b>Hello</b> <i>World!</i>"
}
Text {
    font.pointSize: 24
    textFormat: Text.StyledText
    text: "<b>Hello</b> <i>World!</i>"
}
Text {
    font.pointSize: 24
    textFormat: Text.RichText
    text: "<b>Hello</b> <i>World!</i>"
}
Text {
    font.pointSize: 24
    textFormat: Text.PlainText
    text: "<b>Hello</b> <i>World!</i>"
}

效果如下图所示：