GtkAppChooserButton

已弃用: 4.10 

描述 [src]

final class Gtk.AppChooserButton : Gtk.Widget
  implements Gtk.Accessible, Gtk.AppChooser, Gtk.Buildable, Gtk.ConstraintTarget {
  /* No available fields */
}

GtkAppChooserButton 允许用户选择一个应用程序。

An example GtkAppChooserButton

最初,GtkAppChooserButton 会选择其列表中的第一个应用程序,该应用程序可能是最近使用的应用程序或在 GtkAppChooserButton:show-default-itemTRUE 时为默认应用程序。

GtkAppChooserButton 中显示的应用程序列表包括给定内容类型建议的应用程序。当 GtkAppChooserButton:show-default-item 设置时,还将包含默认应用程序。为了允许用户选择其他应用程序,可以设置 GtkAppChooserButton:show-dialog-item 属性,该属性允许打开一个完整的 GtkAppChooserDialog

可以使用 gtk_app_chooser_button_append_custom_item() 将自定义项添加到列表中。用户选择这些项时,将发出 GtkAppChooserButton::custom-item-activated 信号。

如需跟踪所选应用程序中的更改,请使用 GtkAppChooserButton::changed 信号。

CSS 节点

GtkAppChooserButton 具有一个带有“appchooserbutton”名称的 CSS 节点。

自 4.10 起已弃用

应用程序选择控件应根据需要它的每个平台和/或应用程序的设计进行实现。

层级

hierarchy this GtkAppChooserButton implements_0 GtkAccessible this--implements_0 implements_1 GtkAppChooser this--implements_1 implements_2 GtkBuildable this--implements_2 implements_3 GtkConstraintTarget this--implements_3 ancestor_0 GtkWidget ancestor_0--this ancestor_1 GInitiallyUnowned ancestor_1--ancestor_0 ancestor_2 GObject ancestor_2--ancestor_1

构造函数

gtk_app_chooser_button_new

为可以处理给定类型内容的应用程序创建一个新的 GtkAppChooserButton

已弃用: 4.10 

实例方法

gtk_app_chooser_button_append_custom_item

将一个自定义项追加到在弹出窗口中显示的应用程序列表中。

已弃用: 4.10 

gtk_app_chooser_button_append_separator

向在弹出式菜单中显示的应用程序列表附加一个分隔符。

已弃用: 4.10 

gtk_app_chooser_button_get_heading

返回在对话框顶部显示的 文本。

已弃用: 4.10 

gtk_app_chooser_button_get_modal

获取该 对话框是否为模态。

已弃用: 4.10 

gtk_app_chooser_button_get_show_default_item

返回下拉菜单是否应在顶部显示默认应用程序。

已弃用: 4.10 

gtk_app_chooser_button_get_show_dialog_item

返回下拉菜单是否显示 `GtkAppChooserDialog` 的一项。

已弃用: 4.10 

gtk_app_chooser_button_set_active_custom_item

选择一项自定义项。

已弃用: 4.10 

gtk_app_chooser_button_set_heading

设置在对话框顶部显示的文本。

已弃用: 4.10 

gtk_app_chooser_button_set_modal

设置对话框是否应为模态。

已弃用: 4.10 

gtk_app_chooser_button_set_show_default_item

设置此按钮的下拉菜单是否应在顶部显示给定内容类型的默认应用程序。

已弃用: 4.10 

gtk_app_chooser_button_set_show_dialog_item

设置此按钮的下拉菜单是否应显示一项以触发 `GtkAppChooserDialog`。

已弃用: 4.10 

GtkWidget (162) 继承的方法

请参阅 GtkWidget 以获取方法的完整列表。

GObject (43) 继承的方法

请参阅 GObject 以获取方法的完整列表。

GtkAccessible (19) 继承的方法
gtk_accessible_announce

请求用户的屏幕阅读器播报给定的消息。

新增于:4.14

gtk_accessible_get_accessible_parent

检索可访问对象的辅助父对象。

新增于:4.10

gtk_accessible_get_accessible_role

检索可访问对象的辅助角色。

gtk_accessible_get_at_context

检索给定可访问对象的实现。

新增于:4.10

gtk_accessible_get_bounds

查询该可访问对象的坐标和尺寸。

新增于:4.10

gtk_accessible_get_first_accessible_child

检索可访问对象的第一个可访问子对象。

新增于:4.10

gtk_accessible_get_next_accessible_sibling

检索可访问对象的下一个可访问兄弟对象。

新增于:4.10

gtk_accessible_get_platform_state

查询平台状态(例如焦点)。

新增于:4.10

gtk_accessible_reset_property

将可访问属性重置为其默认值。

gtk_accessible_reset_relation

将可访问关系重置为其默认值。

gtk_accessible_reset_state

将可访问状态重置为其默认值。

gtk_accessible_set_accessible_parent

设置可访问对象的父对象和兄弟对象。

新增于:4.10

gtk_accessible_update_next_accessible_sibling

更新下一个可访问兄弟对象。

新增于:4.10

gtk_accessible_update_property

更新可访问属性列表。

gtk_accessible_update_property_value

更新可访问属性数组。

gtk_accessible_update_relation

更新可访问关系列表。

gtk_accessible_update_relation_value

更新可访问关系数组。

gtk_accessible_update_state

更新可访问状态列表。

gtk_accessible_update_state_value

更新可访问状态数组。

GtkAppChooser (3) 继承的方法
gtk_app_chooser_get_app_info

返回当前选中的应用程序。

已弃用: 4.10 

gtk_app_chooser_get_content_type

返回 `GtkAppChooser` 为其显示应用程序的内容类型。

已弃用: 4.10 

gtk_app_chooser_refresh

重新加载应用程序列表。

已弃用: 4.10 

GtkBuildable (1) 继承的方法
gtk_buildable_get_buildable_id

获取 `buildable` 对象的 ID。

属性

Gtk.AppChooserButton:heading

从按钮打开的对话框顶部显示的文本。

Gtk.AppChooserButton:modal

应用程序选择器对话框是否应为模态。

Gtk.AppChooserButton:show-default-item

确定下拉菜单是否在顶部显示所提供内容类型的默认应用程序。

Gtk.AppChooserButton:show-dialog-item

确定下拉菜单是否显示一项以打开 `GtkAppChooserDialog`。

GtkWidget 继承的属性 (34)
Gtk.Widget:can-focus

控件或其任何子级是否可以接受输入 焦点。

Gtk.Widget:can-target

控件是否可以接收指针 事件。

Gtk.Widget:css-classes

应用于此 控件的 css 类的列表。

Gtk.Widget:css-name

CSS 树中此控件的名称。

Gtk.Widget:cursor

widget 使用的游标。

Gtk.Widget:focus-on-click

用 鼠标单击时控件是否应该获得焦点。

Gtk.Widget:focusable

此控件本身是否将接受输入 焦点。

Gtk.Widget:halign

如果控件获得额外 空间,如何分配水平空间。

Gtk.Widget:has-default

控件是否是默认 控件。

Gtk.Widget:has-focus

控件是否具有输入 焦点。

Gtk.Widget:has-tooltip

启用或禁用 GtkWidget::query-tooltip 信号在 widget 上的发射。

Gtk.Widget:height-request

替代 控件的高度请求。

Gtk.Widget:hexpand

是否 水平扩展。

Gtk.Widget:hexpand-set

是否使用 hexpand 属性。

Gtk.Widget:layout-manager

要用来计算控件的首选大小并分配其 子级的 GtkLayoutManager 实例。

Gtk.Widget:margin-bottom

 控件底部的边距。

Gtk.Widget:margin-end

控件的末尾的边距, 水平。

Gtk.Widget:margin-start

控件开头的边距, 水平。

Gtk.Widget:margin-top

 控件顶部的边距。

Gtk.Widget:name

 控件的名称。

Gtk.Widget:opacity

 控件请求的不透明度。

Gtk.Widget:overflow

控件内容区域外部的内容如何 处理。

Gtk.Widget:parent

此 控件的父控件。

Gtk.Widget:receives-default

控件在 获得焦点时是否将接收默认操作。

Gtk.Widget:root

包含此 控件的控件树的 GtkRoot 控件。

Gtk.Widget:scale-factor

 控件的缩放因子。

Gtk.Widget:sensitive

控件是否对 输入做出反应。

Gtk.Widget:tooltip-markup

设置工具提示的文本为给定的字符串,该字符串用 Pango 标记标记。

Gtk.Widget:tooltip-text

将工具提示的文本设置为给定的 字符串。

Gtk.Widget:valign

如果控件获得额外 空间,如何分配垂直空间。

Gtk.Widget:vexpand

是否 垂直扩展。

Gtk.Widget:vexpand-set

是否使用 vexpand 属性。

Gtk.Widget:visible

控件是否 可见。

Gtk.Widget:width-request

替代 控件的宽度请求。

GtkAccessible 继承的属性 (1)
GtkAccessible:accessible-role

给定的 GtkAccessible 实现的可访问角色。

GtkAppChooser 继承的属性 (1)
GtkAppChooser:content-type

GtkAppChooser 对象的内容类型。

信号

Gtk.AppChooserButton::activate

按钮 , 被激活时发出。

since: 4.4

Gtk.AppChooserButton::changed

活动应用程序 更改时发出。

Gtk.AppChooserButton::custom-item-activated

自定义项 被激活时发出。

GtkWidget 继承的信号 (13)
GtkWidget::destroy

信号让所有控件的引用持有者释放它们持有的引用。

GtkWidget::direction-changed

控件的文本方向 发生更改时发出。

GtkWidget::hide

widget  被隐藏时发出。

GtkWidget::keynav-failed

如果键盘导航 失败,发出。

GtkWidget::map

widget 将要映射时发出。

GtkWidget::mnemonic-activate

当小部件通过助记符激活时发出。

GtkWidget::move-focus

当焦点移动时发出。

GtkWidget::query-tooltip

当小部件的工具提示将要显示时发出。

GtkWidget::realize

widgetGdkSurface 相关联时发出。

GtkWidget::show

widget 显示时发出。

GtkWidget::state-flags-changed

当小部件状态发生变化时发出。

GtkWidget::unmap

widget 将要取消映射时发出。

GtkWidget::unrealize

当与 widget 关联的 GdkSurface 被销毁时发出。

GObject 继承的信号 (1)
GObject::notify

当对象的某个属性通过 g_object_set_property()、g_object_set() 等设置其值时,会在该对象上发出 notify 信号。