QML基础——基本语法

獠

墨衍会员 · AI 创作全网分发码龄16年

关注

转载最新推荐文章于 2026-08-26 13:38:17 发布 991 阅读 AI 写同款· GEO 优化 ›

QML教程（一）基础语法 QML教程阅读详情

QML 的基本语法
QML看起来像这样

import Qt 4.7

 Rectangle {
     width: 200
     height: 200
     color: "blue"

     Image {
         source: "pics/logo.png"
         anchors.centerIn: parent
     }
 }

对象是通过类型而直接被指定的，紧随其后的是一对大括号。对象类型总是以大写字母开头。在上面的例子中，存在两个对象Rectangle和Image。在大括号之间，我们可以指定对象的相关信息，例如它的属性。属性是通过“property: value”这样的方式被呈现的。在上面的例子中，我们可以看到Image拥有一个属性叫做source，它被分配了一个值叫做"pics/logo.png"。属性和值被冒号分隔。

属性可以被一行行指定：

Rectangle {
     width: 100
     height: 100
 }

或单行输写多个属性：

Rectangle { width: 100; height: 100 }

当单行输写多属性/值时，必须由分号来分隔开来。

Import语句导入Qt模块，它包含所有标准的QML元素。如果没有Import语句；那么Rectangle与Image元素将无效。

表达式

除了赋值属性外；你也可以用JavaScript编写的表达式来指定。

Rotation {
     angle: 360 * 3
 }

这些表达式可以包含其它的对象与属性的引用，在这种情况下就会建立约束关联：当该表达式改变值时；该属性值将自动更新。

Item {
     Text {
         id: text1
         text: "Hello World"
     }
     Text {
         id: text2
         text: text1.text
     }
 }

在上面的示例中，text2对象将显示与text1相同的文本。如果text1改变值；那么text2也将自动更新为相同的值。

注意这里我们通过使用id值引用其它的对象。（详情请参见id属性信息）

QML注释

在QML中的注释类似于JavaScript。

单选注释以 // 开始。

多行注释以 /* 开始，以 */ 结束。

import Qt 4.7

注释是不被执行的，添加注释可对代码进行解释或者提高其可读性。

注释同样还可用于防止代码执行，这对跟踪问题是非常有用的。

Text {
     text: "Hello world!"
     //opacity: 0.5
 }

在上面的示例中，这个Text对象将正常显示，一旦opacity: 0.5这行关掉注释，这是以半透明方式显示文本。

属性

属性命名

属性命名以首字母为小字（附加属性除外）。

属性类型

QML支持许多类型的属性（参阅QML基本类型）。基本类型包括整型、实数型、布尔、字符串、颜色以及列表。

Item {
     x: 10.5             // a 'real' property
     ...
     state: "details"    // a 'string' property
     focus: true         // a 'bool' property
 }

QML属性是有类型安全检测的。也就是说，它们只允许你指定一个与属性类型相匹配的值。例如，项目x属性类型是实数，如果你赋值一个字符串；那么将会得到错误的信息。

Item {
    x: “hello” // illegal!
}

id属性

每个对象可给予一个特定唯一的属性称之为id。在同一个QML文件中不可能拥有与其它对象同名的id值。指定一个id可以允许该对象可以被其它的对象与脚本引用。

下面的示例中，第一个矩形元素的id名为”myRect”。第二个矩形元素的宽度是引用的myRect.widtch，这意味着它将与第一矩形具有相同的width值。

Item {
     Rectangle {
         id: myRect
         width: 100
         height: 100
     }
     Rectangle {
         width: myRect.width
         height: 200
     }
 }

请注意，一个id首字符必须是小写字母或下划线并且不能包含字母，数字和下划线以外的字符。

列表属性

列表属性类似于下面这样：

Item {
     children: [
         Image {},
         Text {}
     ]
 }

列表是包含在方括号内，以逗号分隔的列表元素。在你只分配单一项目列表的情况下，是可以省略方括号：

Image {
     children: Rectangle {}
 }

默认属性

每个对象类型可以指定列表或对象属性之一作为其默认属性。如果一属性已被声明为默认属性，该属性标记可以被省略。例如该代码：

State {
     changes: [
         PropertyChanges {},
         PropertyChanges {}
     ]
 }

可以简化成这样：

State {
         PropertyChanges {},
         PropertyChanges {}
 }

因为changes是State类型的默认属性。

分组属性

在某些情况下使用一个‘.’符号或分组符号形成一个逻辑组。

分组属性可写以下这样：

Text {
     font.pixelSize: 12
     font.bold: true
 }

或者这样：

Text {
     font { pixelSize: 12; bold: true }
 }

在元素文件分组属性使用‘.‘符号显示。

附加属性

有些对象的属性附加到另一个对象。附加属性的形式为Type.property其中Type是附加property元素的类型。

例如：

Component {
     id: myDelegate
     Text {
         text: "Hello"
         color: ListView.isCurrentItem ? "red" : "blue"
     }
 }
 ListView {
     delegate: myDelegate
 }

ListView元素附加ListView.isCurrentItem属性到每个它创建的代理上。

另一个附加属性的例子就是Keys元素，它用于处理任意可视项目上的按键，例如：

Item {
     focus: true
     Keys.onSelectPressed: console.log("Selected")
 }

信号处理器

信号处理器允许响应事件时处理动作。例如，MouseArea元素有信号处理器来处理鼠标按下，释放以及单击：

MouseArea {
     onPressed: console.log("mouse button pressed")
 }

所有信号处理器开始都是启用的。

有一些信号处理器包含一个可选的参数，例如MouseArea onPressed信号处理程序有鼠标参数：

 MouseArea {
     acceptedButtons: Qt.LeftButton | Qt.RightButton
     onPressed: if (mouse.button == Qt.RightButton) console.log("Right mouse button pressed")
 }