草庐IT

QML 信号与响应方法的总结

ENG八戒 2023-03-28 原文

以下内容为本人的著作,如需要转载,请声明原文链接 微信公众号「englyf」https://mp.weixin.qq.com/s/8orMKb803oz_G0sSOnDjDw


如果面试过程中,面试官想了解你对 Qt 的理解有多少,少不了会涉及到信号槽这一块,毕竟这是 Qt 最经典的一项技术。

刚开笔,我可能有点狂妄了。

信号槽,分为两部分,信号和对信号响应的槽函数。在可视化开发过程中,无论你用 QWidget 还是 QtQuick 都可以运用到信号槽。QtQuick 是目前 Qt 公司主推的可视化框架了,当然不会缺失对信号槽的支持。

QtQuick 的模块提供了丰富的预定义信号,当然也允许用户自定义信号。

下面就斗胆总结一下在 QML 中信号槽的使用。

1. QtQuick 提供的预定义信号

这些信号都是Qt库里已经预定义好了的,为了使用这些信号,我们需要的是导入类型所在模块和定义响应过程即可。

上来就手掰一个栗子:比如,为了响应 MouseArea 的 clicked 信号,仅需要在 MouseArea 类型对象声明中添加以下形式的语句即可:

onClicked: {
    // do something ....
}

on后边紧跟着的信号名字 clicked 必须首字母大写。冒号后边如果仅是单语句,可以不用大括号{},多语句结尾可以添加分号;结尾。

提醒一下,这种对信号槽的使用方式,适用于信号所属对象的内部。因为这里边其实是包含了隐式的连接(信号和槽),在信号 signal 所属对象的内部直接声明槽函数。

槽函数声明,一般形式如下:

on<Signal>: {
    // do something ....
}

signal 首字母要大写。

2. 属性变化时会触发信号

假设声明了一自定义属性 property,当这个属性被修改后,QML 引擎会发射形式如下的信号

<property>Changed

可添加以下形式语句响应这个属性的变化:

on<Property>Changed: {
    // do something ....
}

在声明响应时,属性名 property 同样需要首字母大写。

无论是自定义的属性,还是预定义的属性,变化时引擎都会发射信号,这些信号响应的形式和上面信号的类似,只不过需要多加个 Changed

3. 附加类型对象Component的信号

简单点理解,QML 引擎会自动在 QML 文件里声明的对象中附加一个 Component 对象。当 QML 文件定义的顶层对象加载完成时,会触发 Component 对象的 completed 信号,为了响应此信号,可以添加以下形式语句:

Component.onCompleted: {
    // do something ....
}

关于 Component 更多信息可以参考

https://doc.qt.io/qt-6/qml-qtqml-component.html

4. 自定义信号

大多数时候,定义的 QML 对象都会需要在其中添加或多或少的自定义信号,同时也会需要定义相应的响应。

用以下形式声明自定义的信号

signal <name>[([<type> <parameter name>[, ...]])]

一般可视化的自定义的 QML 对象都会基于 Item 或者 Rectangle 来做扩展,包括添加自定义信号以及其它必要的功能等,其实这个过程也相当于对原有的类型做了派生(参考C++的习惯)。

Rectangle {
    id: root

    signal mysignal(int x, int y)

    MouseArea {
        anchors.fill: parent
        onPressed: root.mysignal(mouse.x, mouse.y)
    }
}

上面代码中,Rectangle 对象定义了信号 mysignal,带有整形参数x和y。然后添加了针对鼠标区域定义的组件 MouseArea,在其中通过信号槽去触发父对象的自定义信号 mysignal。

MouseArea 属于预定义类型,pressed 信号自带参数 mouse。更多信息可以参考下面的链接:

https://doc.qt.io/qt-6/qml-qtquick-mousearea.html#pressed-signal

自定义信号的处理形式和预定义信号一致,参考上面预定义信号的响应方法。

5. 通过信号的方法connect指定响应

关于 connect,简单的说,就是用于针对具体信号指定响应的方法或者触发的下一个信号。啰嗦点来讲,一个信号被触发了,那么它可以指定响应的方法,也可以指定触发下一个信号形成信号的连锁反应,这个过程就通过 connect 来指定。

如果你熟悉 Qt, 应该对 C++ 的 QObject::connect 方法不陌生。和 C++ 部分类似,QML 中也有 connect 方法,可以连接任意的(包括多个)信号和方法,但是 QML 的 connect 更灵活而且调用方式不太一样。不一样的是,C++ 中 QObject::connect 是静态方法,而 QML 的 connect 由信号提供。参考以下形式:

signal.connect(signal / function_name)

要注意一下,QML 对象的信号必须通过对象来引用。

看个例子:

Rectangle {
    id: root

    signal mySignal()
    // 信号响应处理
    onMySignal: console.log("clicked connect mySignal")

    // 普通方法
    function slt_clicked() {
      console.log("clicked connect slt_clicked");
    }

    Component.onCompleted: {
        mousearea.clicked.connect(slt_clicked);
        mousearea.clicked.connect(mySignal);
    }

    MouseArea {
        id: mousearea
        anchors.fill: parent
    }
}

通过上面的代码可知,在引用的组件 Component 的信号 completed 的响应中,通过另一个组件 mousearea 的信号 ( clicked ) 调用 connect 连接父组件的函数 slt_clicked 和信号 mySignal。

如果信号 clicked 带有参数,那么被连接的方法 ( slt_clicked ) 和信号 ( mySignal ) 也应该有同样数目的参数。

当 MouseArea 组件的信号 clicked 被触发后,可以看到下面的输出:

clicked connect slt_clicked
clicked connect mySignal

当然,如果连接不再需要,那么 disconnect 也是不能缺少的。disconnect 的作用和 connect 相反,专用于解绑已有连接,也是通过信号调用。

Rectangle {
    id: relay
    // ... 省略

    function removeSignal() {
        mousearea.clicked.disconnect(slt_clicked);
        mousearea.clicked.disconnect(mySignal);
    }
}

6. 处理任意对象的信号:

QtQuick 框架提供了一个超级好用的类型:Connections,它可以用于响应任意对象的信号(官方说法是generalized)。

大多数情况下,用于连接其它 QML 文件中定义的对象的信号,具体需要指定信号所属对象的 id。参考以下形式:

import QtQml

Connections {
    target: object_id

    onSignal: {
        // do something ....
    }
}

target 属性用于指定响应信号所属对象的 id。


好了,暂时介绍到这里,下回见......

有关QML 信号与响应方法的总结的更多相关文章

  1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

    我正在学习如何使用Nokogiri,根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

  2. ruby - 如何从 ruby​​ 中的字符串运行任意对象方法? - 2

    总的来说,我对ruby​​还比较陌生,我正在为我正在创建的对象编写一些rspec测试用例。许多测试用例都非常基础,我只是想确保正确填充和返回值。我想知道是否有办法使用循环结构来执行此操作。不必为我要测试的每个方法都设置一个assertEquals。例如:describeitem,"TestingtheItem"doit"willhaveanullvaluetostart"doitem=Item.new#HereIcoulddotheitem.name.shouldbe_nil#thenIcoulddoitem.category.shouldbe_nilendend但我想要一些方法来使用

  3. ruby - 为什么我可以在 Ruby 中使用 Object#send 访问私有(private)/ protected 方法? - 2

    类classAprivatedeffooputs:fooendpublicdefbarputs:barendprivatedefzimputs:zimendprotecteddefdibputs:dibendendA的实例a=A.new测试a.foorescueputs:faila.barrescueputs:faila.zimrescueputs:faila.dibrescueputs:faila.gazrescueputs:fail测试输出failbarfailfailfail.发送测试[:foo,:bar,:zim,:dib,:gaz].each{|m|a.send(m)resc

  4. ruby - Facter::Util::Uptime:Module 的未定义方法 get_uptime (NoMethodError) - 2

    我正在尝试设置一个puppet节点,但ruby​​gems似乎不正常。如果我通过它自己的二进制文件(/usr/lib/ruby/gems/1.8/gems/facter-1.5.8/bin/facter)在cli上运行facter,它工作正常,但如果我通过由ruby​​gems(/usr/bin/facter)安装的二进制文件,它抛出:/usr/lib/ruby/1.8/facter/uptime.rb:11:undefinedmethod`get_uptime'forFacter::Util::Uptime:Module(NoMethodError)from/usr/lib/ruby

  5. Ruby 方法() 方法 - 2

    我想了解Ruby方法methods()是如何工作的。我尝试使用“ruby方法”在Google上搜索,但这不是我需要的。我也看过ruby​​-doc.org,但我没有找到这种方法。你能详细解释一下它是如何工作的或者给我一个链接吗?更新我用methods()方法做了实验,得到了这样的结果:'labrat'代码classFirstdeffirst_instance_mymethodenddefself.first_class_mymethodendendclassSecond使用类#returnsavailablemethodslistforclassandancestorsputsSeco

  6. ruby-on-rails - Rails 3.2.1 中 ActionMailer 中的未定义方法 'default_content_type=' - 2

    我在我的项目中添加了一个系统来重置用户密码并通过电子邮件将密码发送给他,以防他忘记密码。昨天它运行良好(当我实现它时)。当我今天尝试启动服务器时,出现以下错误。=>BootingWEBrick=>Rails3.2.1applicationstartingindevelopmentonhttp://0.0.0.0:3000=>Callwith-dtodetach=>Ctrl-CtoshutdownserverExiting/Users/vinayshenoy/.rvm/gems/ruby-1.9.3-p0/gems/actionmailer-3.2.1/lib/action_mailer

  7. ruby - Highline 询问方法不会使用同一行 - 2

    设置:狂欢ruby1.9.2高线(1.6.13)描述:我已经相当习惯在其他一些项目中使用highline,但已经有几个月没有使用它了。现在,在Ruby1.9.2上全新安装时,它似乎不允许在同一行回答提示。所以以前我会看到类似的东西:require"highline/import"ask"Whatisyourfavoritecolor?"并得到:Whatisyourfavoritecolor?|现在我看到类似的东西:Whatisyourfavoritecolor?|竖线(|)符号是我的终端光标。知道为什么会发生这种变化吗? 最佳答案

  8. ruby - 主要 :Object when running build from sublime 的未定义方法 `require_relative' - 2

    我已经从我的命令行中获得了一切,所以我可以运行rubymyfile并且它可以正常工作。但是当我尝试从sublime中运行它时,我得到了undefinedmethod`require_relative'formain:Object有人知道我的sublime设置中缺少什么吗?我正在使用OSX并安装了rvm。 最佳答案 或者,您可以只使用“require”,它应该可以正常工作。我认为“require_relative”仅适用于ruby​​1.9+ 关于ruby-主要:Objectwhenrun

  9. ruby - 多个属性的 update_column 方法 - 2

    我有一个具有一些属性的模型:attr1、attr2和attr3。我需要在不执行回调和验证的情况下更新此属性。我找到了update_column方法,但我想同时更新三个属性。我需要这样的东西:update_columns({attr1:val1,attr2:val2,attr3:val3})代替update_column(attr1,val1)update_column(attr2,val2)update_column(attr3,val3) 最佳答案 您可以使用update_columns(attr1:val1,attr2:val2

  10. ruby - 检查方法参数的类型 - 2

    我不确定传递给方法的对象的类型是否正确。我可能会将一个字符串传递给一个只能处理整数的函数。某种运行时保证怎么样?我看不到比以下更好的选择:defsomeFixNumMangler(input)raise"wrongtype:integerrequired"unlessinput.class==FixNumother_stuffend有更好的选择吗? 最佳答案 使用Kernel#Integer在使用之前转换输入的方法。当无法以任何合理的方式将输入转换为整数时,它将引发ArgumentError。defmy_method(number)

随机推荐