zoukankan      html  css  js  c++  java
  • Qt显示Linux desktop natification气泡提示框

    在现代Linux桌面环境上我们时常可以看到类似的消息框:

    这些消息框常用在如下场景:

    • 即时聊天软件的新消息
    • 闹钟定时提示
    • 电池电量提示
    • 邮件消息
    • 长耗时操作的完成提示

    在freedesktop.org的规范中这种消息框被称为Desktop Notification,中文名我们形象得称其为“气泡框”。通过调用D-BUS服务org.freedesktop.Notifications提供的接口即可显示在桌面上。

    所以我们先了解一下这个D-BUS服务。

    org.freedesktop.Notifications概览

    一个气泡框消息通常会包含如下的属性:

    名称 说明
    Application Name 标示发送消息的程序,最好使用程序全名
    Replaces ID 可选的消息ID,服务器通过id控制消息框的渲染,通常不用关注
    Icon 显示在气泡框上的图标
    Summary 标题,只能显示一行,叫title应该更合适
    Body 消息体,支持部分HTML标签;<b></b><i></i><u></u><a></a><img src=... alt=...>
    Actions 显示一些按钮或者菜单(QAction),不过这一功能通常未被实现
    Hints 为消息体提供的额外数据,比如显示在屏幕的位置(x,y坐标)
    Expiration Timeout 气泡框显示的时长,单位毫秒;指定为-1时行为取决于实现;为0时气泡框将一直显示在桌面上直到用户点击

    其中Icon和Hints中的image_path必须为本地绝对路径或者file://开头的文件URL。另外使用桌面环境预定义图标的名字也是可以的。

    气泡框还有三个紧急程度可供选择:

    名称 说明
    Low 0 默认值,可以设置如何显示,应该设置一个合理的显示时间以便气泡框可以隐藏退出
    Normal 1 同low
    Critical 2 代表重要通知,不应该自动过期隐藏

    所有的气泡框消息请求都是异步的,通常构造请求并发送后用户就可以不再关心后续的信息,如果有特殊需要则可以自定义处理org.freedesktop.Notifications发送的信号。

    得益于freedesktop.org的标准规范,包括KDE,GNOME,XFCE4在内的许多桌面环境都提供了对Desktop Notification的支持,虽然外观上可能存在一些差异但是创建气泡框的方法是一样的。

    不过不用担心,我们不会直接去使用D-BUS,因为已经有简化的现成方案可供选择了。下面就让我们一起看看这些方案。

    方案一:调用外部命令

    可能你已经知道了,我要介绍的命令就是notify-send

    notify-send几乎被所有的桌面环境和发行版支持,它依赖于后面会介绍的libnotify和glib,如果你的系统上没有安装可以使用如下命令进行安装:

    debian/Ubuntu:

    sudo apt install libnotify-bin
    

    Arch Linux:

    sudo pacman -S libnotify
    

    安装后可以用如下命令显示气泡框:

    # notify-send title body [options]
    notify-send test 'This is a desktop Notification test.' -t 10000
    

    -t参数设置超时时间。效果如下:

    具体的参数可以参考这里:https://ss64.com/bash/notify-send.html

    方案二:通过编程方式实现

    在Qt代码中调用外部命令就可以显示气泡框,然而这种方式不够灵活,所以我们需要使用前面提到的libnotify在我们的代码里生成并显示气泡框。

    libnotify对各个语言都提供了binding,可以参考这里
    这里我们选择使用golang的binding:

    package main
    import ("github.com/mqu/go-notify")
    
    func main() {
    	notify.Init("Hello world")
    	hello := notify.NotificationNew("Hello World!", "This is an example notification.","dialog-information")
    	hello.SetTimeout(5000)
    	hello.Show()
    }
    

    上面的代码将会显示一个可以在桌面停留5s的气泡框:

    不过如果每次都要使用一大串代码才能显示消息的话必然是低效的,而且需要换算时间至毫秒,所以我写了一个帮助函数在notify.go:

    // ShowNotification 显示org.freedesktop.Notifications气泡消息框
    // duration == -1时使用默认delay
    // duration == 0表示不设置超时,desktop notification将会一直显示
    func ShowNotification(title, text, image string, delay time.Duration) {
    	var notifyDelay int32
    	if delay == -1 {
    		notifyDelay = duration2millisecond(defaultNotifyDelay)
    	} else {
    		notifyDelay = duration2millisecond(delay)
    		// 不合法值(包括duration不足1ms),使用默认值进行替换
    		if notifyDelay == -1 {
    			notifyDelay = duration2millisecond(defaultNotifyDelay)
    		}
    	}
    
    	libnotify.Init(applicationName)
    
    	notify := libnotify.NotificationNew(title, text, image)
    	if notify == nil {
    		fmt.Fprintf(os.Stderr, "Unable to create a new notification
    ")
    		return
    	}
    	notify.SetTimeout(notifyDelay)
    
    	notify.Show()
    }
    
    // duration2millisecond 将time.Duration转换成millisecond
    // duration不足1ms将返回-1
    func duration2millisecond(duration time.Duration) int32 {
    	res := int32(duration / time.Millisecond)
    	if res < 0 {
    		return -1
    	}
    
    	return res
    }
    

    首先将时间值转换成毫秒数,如果太小或者不合法就使用默认的停留时间。applicationName是程序的完整名称。
    因为气泡框消息是异步的,所以在调用了Show()之后函数就会返回,后续操作xwindows都会帮我们处理,所以这个函数调用之后是立刻返回的,不会阻塞Qt的gui事件循环,可以放心的使用:

    // download something success
    ShowNotification("下载", "文件下载完成", "dialog-information", 5*time.Second)
    

    这样我们也可以轻松地在我们的Qt程序中使用气泡消息框了。

    参考:

    https://developer.gnome.org/notification-spec/

  • 相关阅读:
    Attributes in C#
    asp.net C# 时间格式大全
    UVA 10518 How Many Calls?
    UVA 10303 How Many Trees?
    UVA 991 Safe Salutations
    UVA 10862 Connect the Cable Wires
    UVA 10417 Gift Exchanging
    UVA 10229 Modular Fibonacci
    UVA 10079 Pizza Cutting
    UVA 10334 Ray Through Glasses
  • 原文地址:https://www.cnblogs.com/apocelipes/p/10124381.html
Copyright © 2011-2022 走看看