类

GtkExpander

描述 [源代码]

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

GtkExpander 允许用户通过点击展开三角来显示其子项。

An example GtkExpander

这与 GtkTreeView 中使用的三角类似。

通常，您使用扩展器的方式与使用框架的方式类似；您创建子窗口小部件，并使用 gtk_expander_set_child() 将其添加到扩展器。当切换展开器时，它将自动显示和隐藏子项。

特殊用法

在某些情况下，您可能希望自己显示和隐藏展开的小部件，例如当您想在展开时实际创建小部件时。在这种情况下，创建一个 GtkExpander，但不要向其中添加子项。展开小部件有一个 GtkExpander:expanded 属性，可用于监控其展开状态。您应该使用信号连接来监视此属性，如下所示

static void
expander_callback (GObject    *object,
                   GParamSpec *param_spec,
                   gpointer    user_data)
{
  GtkExpander *expander;

  expander = GTK_EXPANDER (object);

  if (gtk_expander_get_expanded (expander))
    {
      // Show or create widgets
    }
  else
    {
      // Hide or destroy widgets
    }
}

static void
create_expander (void)
{
  GtkWidget *expander = gtk_expander_new_with_mnemonic ("_More Options");
  g_signal_connect (expander, "notify::expanded",
                    G_CALLBACK (expander_callback), NULL);

  // ...
}

GtkExpander 作为 GtkBuildable

GtkExpander 实现的 GtkBuildable 接口支持通过将 child 指定为 <child> 元素的 type 属性，将子元素放在标签位置。可以不指定 <child> type 属性指定常规内容子元素。

带有 GtkExpander 的用户界面定义片段示例

<object class="GtkExpander">
  <child type="label">
    <object class="GtkLabel" id="expander-label"/>
  </child>
  <child>
    <object class="GtkEntry" id="expander-content"/>
  </child>
</object>

CSS 节点

expander-widget
╰── box
    ├── title
    │   ├── expander
    │   ╰── <label widget>
    ╰── <child>

GtkExpander 有一个主节点 expander-widget，以及包含标题和子小部件的子节点 box。box 子节点 title 包含节点 expander，即展开/折叠箭头；然后是标签小部件（如果存在）。显示其子项的展开器的箭头具有对其设置 :checked 伪类的功能。

辅助功能

GtkExpander 使用 GTK_ACCESSIBLE_ROLE_BUTTON 角色。

层次结构

父代

实现

构造函数

gtk_expander_new

使用 label 作为标签文本创建一个新的展开器。

gtk_expander_new_with_mnemonic

使用 label 作为标签文本创建一个新的展开器。

从 GtkWidget (162) 继承的方法

有关方法的完整列表，请参阅 GtkWidget。

从 GObject (43) 继承的方法

有关方法的完整列表，请参阅 GObject。

从 GtkBuildable (1) 继承的方法

gtk_buildable_get_buildable_id

获取 buildable 对象的 ID。

继承自 GtkAccessible（1）的属性

GtkAccessible:accessible-role

给定的 GtkAccessible 实现的辅助角色。

信号

Gtk.Expander::activate

激活 GtkExpander。

从GObject继承的信号 (1)

GObject::notify

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