类

GtkComboBoxText

已弃用：4.10

说明 [src]

final class Gtk.ComboBoxText : Gtk.ComboBox
  implements Gtk.Accessible, Gtk.Buildable, Gtk.CellEditable, Gtk.CellLayout, Gtk.ConstraintTarget {
  /* No available fields */
}

GtkComboBoxText 是 GtkComboBox 的一个简单变体，仅用于文本用例。

An example GtkComboBoxText

GtkComboBoxText 隐藏了 GtkComboBox 的模型视图复杂性。

要创建 GtkComboBoxText，请使用 gtk_combo_box_text_new() 或 gtk_combo_box_text_new_with_entry()。

您可以使用 gtk_combo_box_text_append_text()、gtk_combo_box_text_insert_text() 或 gtk_combo_box_text_prepend_text() 将项目添加到 GtkComboBoxText，并使用 gtk_combo_box_text_remove() 移除选项。

如果 GtkComboBoxText 包含一个条目（通过 GtkComboBox:has-entry 属性），可以使用 gtk_combo_box_text_get_active_text() 检索其内容。

您不应调用 gtk_combo_box_set_model() 或尝试通过其 GtkCellLayout 接口向此组合框中填充更多单元格。

GtkComboBoxText as GtkBuildable

GtkComboBoxText 实现的 GtkBuildable 接口支持使用 <items> 元素直接添加项目并为每个项目指定 <item> 元素。每个 <item> 元素可以指定对应于附加文本的“id”，并且还支持常规翻译属性“translatable”、“context”和 “comments”。

这里有一个指定 GtkComboBoxText 项目的 UI 定义片段

<object class="GtkComboBoxText">
  <items>
    <item translatable="yes" id="factory">Factory</item>
    <item translatable="yes" id="home">Home</item>
    <item translatable="yes" id="subway">Subway</item>
  </items>
</object>

CSS 节点

combobox
╰── box.linked
    ├── entry.combo
    ├── button.combo
    ╰── window.popup

GtkComboBoxText 具有一个名为 combobox 的单个 CSS 节点。它将样式类 .combo 添加到其条目和按钮子组件的主 CSS 节点，以及 .linked 类添加到其内部 box 节点。

已弃用，自版本：4.10

请改用 GtkDropDown 和 GtkStringList 。

层级

祖先

实现

构造函数

gtk_combo_box_text_new

创建一个新的 GtkComboBoxText。

已弃用：4.10

gtk_combo_box_text_new_with_entry

创建一个新的 GtkComboBoxText 和一个条目。

已弃用：4.10

实例方法

gtk_combo_box_text_append

将 text 追加到存储在 combo_box 中的字符串列表。

已弃用：4.10

gtk_combo_box_text_append_text

将 text 追加到存储在 combo_box 中的字符串列表。

已弃用：4.10

gtk_combo_box_text_get_active_text

返回 combo_box 中当前处于活动状态的字符串。

已弃用：4.10

gtk_combo_box_text_insert

在存储在 combo_box 中的字符串列表中，插入 text 于第 position 个位置。

已弃用：4.10

gtk_combo_box_text_insert_text

在存储在 combo_box 中的字符串列表中，插入 text 于第 position 个位置。

已弃用：4.10

gtk_combo_box_text_prepend

将 text 添加到 combo_box 中存储的字符串列表的开头。

已弃用：4.10

gtk_combo_box_text_prepend_text

将 text 添加到 combo_box 中存储的字符串列表的开头。

已弃用：4.10

gtk_combo_box_text_remove

从 combo_box 中移除 position 中的字符串。

已弃用：4.10

gtk_combo_box_text_remove_all

从组合框中移除所有文本项。

已弃用：4.10

从 GtkComboBox（24 继承而来的方法）

请参阅 GtkComboBox，以获得完整的方法列表。

从 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

更新辅助功能状态的数组。

从 GtkBuildable（1 继承而来的方法）

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

从 GtkCellEditable（3 继承而来的方法）

gtk_cell_editable_editing_done

发出 GtkCellEditable::editing-done 信号。

已弃用：4.10

gtk_cell_editable_remove_widget

发出 GtkCellEditable::remove-widget 信号。

已弃用：4.10

gtk_cell_editable_start_editing

在 cell_editable 上开始编辑。

从 GtkCellLayout（10 继承而来的方法）

gtk_cell_layout_add_attribute

将一个属性映射添加到 cell_layout 中的列表中。

已弃用：4.10

gtk_cell_layout_clear

清除 cell_layout 上所有渲染器上的所有映射，并从 cell_layout 中移除所有渲染器。

已弃用：4.10

gtk_cell_layout_clear_attributes

清除先前已通过 gtk_cell_layout_set_attributes() 设置的所有现有属性。

已弃用：4.10

gtk_cell_layout_get_area

返回底层的 GtkCellArea，如果在 GtkCellArea 上调用，则它可能是 cell_layout；如果 cell_layout 不使用 GtkCellArea，则它可能是 NULL。

已弃用：4.10

gtk_cell_layout_get_cells

返回已添加到 cell_layout 的单元格呈现器。

已弃用：4.10

gtk_cell_layout_pack_end

将 cell 添加到 cell_layout 的末尾。如果 expand 为 FALSE，则 cell 分配的空间不超过其所需。所有未使用的空间平均分配给 expand 为 TRUE 的单元格。

已弃用：4.10

gtk_cell_layout_pack_start

将 cell 压缩到 cell_layout 的开头。如果 expand 为 FALSE，则 cell 分配的空间不超过其所需。所有未使用的空间平均分配给 expand 为 TRUE 的单元格。

已弃用：4.10

gtk_cell_layout_reorder

在 position 处重新插入 cell。

已弃用：4.10

gtk_cell_layout_set_attributes

将参数列表中的属性设置为 cell_layout 的属性。

已弃用：4.10

gtk_cell_layout_set_cell_data_func

设置适用于 cell_layout 的 GtkCellLayoutDataFunc。

已弃用：4.10

属性

从 GtkAccessible 继承的属性（1）

GtkAccessible:accessible-role

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

从 GtkCellEditable 继承的属性（1）

GtkCellEditable:editing-canceled

指示是否已取消单元格上的编辑。

信号

从 GObject 继承的信号（1）

GObject::notify

当对象的某个属性的值通过 g_object_set_property(), g_object_set() 等等被设置时，会发出 notify 信号。

从 GtkCellEditable 继承的信号（2）

GtkCellEditable::editing-done

该信号标记单元格呈现器从cell_editable更新其值。

GtkCellEditable::remove-widget

此信号旨在表示该单元格已完成编辑，并正在移除cell_editable小组件，并且随后可以将其销毁。

说明 [src]

GtkComboBoxText as GtkBuildable

CSS 节点

层级

祖先

实现

构造函数

实例方法

从 GtkComboBox（24 继承而来的方法）

从 GtkWidget（162 继承而来的方法）

从 GObject（43 继承而来的方法）

从 GtkAccessible（19 继承而来的方法）

从 GtkBuildable（1 继承而来的方法）

从 GtkCellEditable（3 继承而来的方法）

从 GtkCellLayout（10 继承而来的方法）

属性

从 GtkComboBox（11）继承的属性

从 GtkWidget（34）继承的属性

从 GtkAccessible 继承的属性（1）

从 GtkCellEditable 继承的属性（1）

信号

从 GtkComboBox 继承的信号（6）

从 GtkWidget 继承的信号（13）

从 GObject 继承的信号（1）

从 GtkCellEditable 继承的信号（2）