方法

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字符串。

返回值

类型: guint

一个非零cookie,用于唯一标识此操作,或0表示平台不支持阻止或请求失败。