方法
GtkApplicationinhibit
声明 [src]
guint
gtk_application_inhibit (
GtkApplication* application,
GtkWindow* window,
GtkApplicationInhibitFlags flags,
const char* reason
)
描述 [src]
通知会话管理器某些类型的动作应被阻止。
这不一定在所有平台上对所有类型的动作都有效。
应用程序应在开始不应中断的操作时调用此方法,例如创建CD或DVD。可能被阻止的动作类型由flags
参数指定。当应用程序完成操作后,应调用gtk_application_uninhibit()
以移除阻止器。请注意,应用程序可以有多个阻止器,并且必须单独移除所有阻止器。应用程序退出时,也将清除阻止器。
应用程序不应期望始终能够阻止动作。在大多数情况下,用户将获得强制执行动作的选项。
reason
消息应简短明确。
如果提供了窗口,会话管理器可能会将用户指向此窗口以了解更多关于为什么动作被阻止的原因。
此函数返回的cookie应用作gtk_application_uninhibit()
的参数以移除请求。
参数
window
-
类型:
GtkWindow
一个窗口。
该参数可以是 NULL
。数据由方法调用者拥有。 flags
-
类型:
GtkApplicationInhibitFlags
应阻止哪些类型的动作。
reason
-
类型:
const char*
一个简短的人类可读字符串,解释为什么这些操作被阻止。
该参数可以是 NULL
。数据由方法调用者拥有。 该值是一个以null终止的UTF-8字符串。