今天我们来讲讲自定义组件和它的构造函数。

在前面的文章里我们已经接触了好几个自定组件,这次的示例是一个自定义对话框,他有一个about按钮,点击按钮可以显示出Qt的信息或者用户输入的信息。这是效果图:
【golang-GUI开发】struct tags系统(二)qt的自定义组件和构造函数 go 第1张
【golang-GUI开发】struct tags系统(二)qt的自定义组件和构造函数 go 第2张
【golang-GUI开发】struct tags系统(二)qt的自定义组件和构造函数 go 第3张

SRE实战 互联网时代守护先锋,助力企业售后服务体系运筹帷幄!一键直达领取阿里云限量特价优惠。

下面我们就来重点讲解自定义组件和它的构造函数吧。

构造函数的声明

先上代码:

type MyDialog struct {
    widgets.QDialog
    
    _ func() `constructor:"init"`
    
    _ func(string) `signal:"showAbout"`
    _ func() `signal:"showAboutQt"`
    
    _ func(bool)   `slot:"aboutClicked,auto"`
    _ func(string) `slot:"enableAboutButton,auto"`
    
    label         *widgets.QLabel
    edit          *widgets.QLineEdit
    testCheck     *widgets.QCheckBox
    isDialogCheck *widgets.QCheckBox
    aboutButton   *widgets.QPushButton
    closeButton   *widgets.QPushButton
}

构造函数用 “ _ func() `constructor:"init"` ”
来声明,目前只支持无参数的构造函数,以后会逐步扩展。之后我们需要实现一个名字是init的类方法,这是构造函数的实体。

qt的moc系统遇到派生自QObject及其派生类的类时,会自动生成一个New[type name]的函数(type name也会被Title处理),它会返回一个已经初始化的指向自定义类型实例的指针,这个函数的参数类型会根据最先继承的QObject或是其派生类的New[type name]而定,举个例子:

假设我们的类继承自QLineEdit,在qt里有NewQLineEdit(parent QWidget_ITF),那么我们这个类自动生成的New[type name]就会是New[type name](parent QWidget_ITF);
再举个例子,我们的组件继承自QWidget,它有NewQWidget(parent QWidget_ITF, fo core.Qt__WindowType),那么我们的类会自动生成New[type name](parent QWidget_ITF, fo core.Qt__WindowType)

我们实现的init会被New[type name]自动调用。不过这里有个问题,如果我想实现自己的New[type name]函数呢,比如需要加上自己的配置参数,其实也很简单,我们再定义一个New[type name]WithXXX然后在其中调用New[type name]即可,向下面这样:

func NewYourTypeWithConfig(conf Config) *YourType {
    // 假设继承自QWidget
    obj := NewYourType(nil, 0)
    // 一些额外的初始化处理
    // 一般在init里进行界面的初始化,如果你的界面初始化依赖外部数据,那么可以不指定constructor,
    // 这样New[type name]就不会自动调用init,你可以在自定义函数里调用它。
    obj.conf = conf
  
    // obj.init()
}

这就是构造函数的全貌了,接着我们来看看界面的初始化,也就是我们要实现的init函数:

func (d *MyDialog) init() {
    d.label = widgets.NewQLabel2("About &Text:", d, 0)
    d.edit = widgets.NewQLineEdit(nil)
    // 将label和edit绑定
    d.label.SetBuddy(d.edit)
    
    d.testCheck = widgets.NewQCheckBox2("Test case", nil)
    // 选择显示自定义组件的About还是Qt的About
    d.isDialogCheck = widgets.NewQCheckBox2("Show &Dialog's about", nil)

    // 当用户输入要显示的内容时才可以点击
    d.aboutButton = widgets.NewQPushButton2("&About", nil)
    d.aboutButton.SetDefault(true)
    d.aboutButton.SetEnabled(false)
    
    d.closeButton = widgets.NewQPushButton2("&Close", nil)
    d.closeButton.ConnectClicked( func(_ bool) {
        d.Done(0)
    })
    
    d.edit.ConnectTextChanged(d.EnableAboutButton)
    d.aboutButton.ConnectClicked(d.aboutClicked)
    
    topLeftLayout := widgets.NewQHBoxLayout()
    topLeftLayout.AddWidget(d.label, 0, 0)
    topLeftLayout.AddWidget(d.edit, 0, 0)
    
    leftLayout := widgets.NewQVBoxLayout()
    leftLayout.AddLayout(topLeftLayout, 0)
    leftLayout.AddWidget(d.testCheck, 0, 0)
    leftLayout.AddWidget(d.isDialogCheck, 0, 0)
    
    rightLayout := widgets.NewQVBoxLayout()
    rightLayout.AddWidget(d.aboutButton, 0, 0)
    rightLayout.AddWidget(d.closeButton, 0, 0)
    rightLayout.AddStretch(0)
    
    mainLayout := widgets.NewQHBoxLayout()
    mainLayout.AddLayout(leftLayout, 0)
    mainLayout.AddLayout(rightLayout, 0)
    d.SetLayout(mainLayout)
    
    d.SetWindowTitle("about")
}

代码也很简单,初始化widgets之后使用QBoxLayout进行布局,然后连接一下closeButton,使用QDialog::done退出dialog。

我们设置aboutButton初始为不可点击状态,直到有输入内容存在在改变它的状态,这一步由自动连接的enableAboutButton槽来完成;
然后是点击aboutButton时会检查isDialogCheck的值来确定弹出哪种对话框,这一步由aboutClicked槽来完成:

func (d *MyDialog) aboutClicked(_ bool) {
    text := d.edit.Text()
    
    if d.isDialogCheck.IsChecked() {
        d.ShowAbout(text)
    } else {
        d.ShowAboutQt()
    }
}

func (d *MyDialog) enableAboutButton(text string) {
    if text != "" {
        d.aboutButton.SetEnabled(true)
    } else {
        d.aboutButton.SetEnabled(false)
    }
}

然后就是主函数,将显示About对话框的信号和相应的处理函数连接,然后显示我们的组件:

func main() {
    app := widgets.NewQApplication(len(os.Args), os.Args)
    
    dialog := NewMyDialog(nil, 0)
    // 显示About Qt
    dialog.ConnectShowAboutQt( func() {
        app.AboutQtDefault()
    })
    // 显示自定义内容的About
    dialog.ConnectShowAbout( func(text string) {
        widgets.NewQMessageBox(dialog).About(dialog, "About Dialog", text)
    })
    
    dialog.Show()
    
    app.Exec()
}

显示About Qt时的效果:
【golang-GUI开发】struct tags系统(二)qt的自定义组件和构造函数 go 第4张

怎么样,是不是很简单,下一篇文章里我们将结束对qt struct tags的探索,如果有任何疑问或者建议,欢迎在评论指出!
祝玩得愉快!

扫码关注我们
微信号:SRE实战
拒绝背锅 运筹帷幄