信号

GtkComboBox::format-entry-text

声明

gchar*
format_entry_text (
  GtkComboBox* self,
  gchar* path,
  gpointer user_data
)

描述 [src]

用于允许更改组合框条目中文本显示方式的信号。

参见 GtkComboBox:has-entry。

连接信号处理器以返回表示 path 的已分配字符串。该字符串将被用来设置组合框条目中的文本。默认信号处理器使用 GtkComboBox:entry-text-column 模型列中的文本。

以下是一个示例信号处理器，它从模型获取数据并在条目中显示。

static char *
format_entry_text_callback (GtkComboBox *combo,
                            const char *path,
                            gpointer     user_data)
{
  GtkTreeIter iter;
  GtkTreeModel model;
  double       value;

  model = gtk_combo_box_get_model (combo);

  gtk_tree_model_get_iter_from_string (model, &iter, path);
  gtk_tree_model_get (model, &iter,
                      THE_DOUBLE_VALUE_COLUMN, &value,
                      -1);

  return g_strdup_printf ("%g", value);
}

默认处理器

默认处理器在通过 g_signal_connect() 添加的处理程序之后被调用。

参数

path

类型： gchar*

为要格式化文本的组合框当前模型提供的 GtkTreePath 字符串。

数据由函数的调用者拥有。

该值是一个以 NUL 结尾的 UTF-8 字符串。

返回值

类型： gchar*

一个表示当前 GtkComboBox 模型的 path 的新分配字符串。

函数的调用者将拥有数据，并负责释放它。

该值是一个以 NUL 结尾的 UTF-8 字符串。