方法
自:2.40
声明 [源代码]
void
g_application_send_notification (
GApplication* application,
const gchar* id,
GNotification* notification
)
描述 [源代码]
以应用程序的身份向桌面外壳发送通知。无法保证通知立即显示,甚至根本不可能显示。
通知可能在应用程序退出后持续存在。当通知或其操作被激活时,它将通过DBus激活。
在这种调用之后修改notification
没有任何效果。但是,该对象可以用于稍后对该函数的后续调用。
id
可以是任何唯一标识应用程序事件的字符串。它不需要任何特殊的格式。例如,“new-message”可能适合关于新消息的通知。
如果之前已使用相同的id
发送了通知,则将用notification
替换它并重新显示,就像它是一个新通知一样。即使是从应用程序的先前执行中发送的通知,只要id
是相同的字符串,这也适用。
id
可以是NULL
,但如果没有id,则无法替换或撤回通知。
如果notification
不再相关,可以用g_application_withdraw_notification()
撤回它。
如果应用程序没有应用程序ID,调用此函数是错误的。
自可用:2.40
参数
id
-
类型:
const gchar*
通知的ID,或者
NULL
。参数可以是 NULL
。数据由方法调用者拥有。 值是一个以空字符终止的UTF-8字符串。 notification
-
类型:
GNotification
待发送的
GNotification
。数据由方法调用者拥有。