信号

GtkCellRenderer::编辑开始

声明

void
editing_started (
  GtkCellRenderer* self,
  GtkCellEditable* editable,
  gchar* path,
  gpointer user_data
)

描述 [源]

当单元格开始被编辑时，会发射此信号。此信号预期的用途是在 editable 上进行特殊设置，例如添加 GtkEntryCompletion 或在 GtkComboBox 中设置额外的列。

有关 editable 的生命周期和不受 renderer 影响的设置方式，请参见 gtk_cell_editable_start_editing()。

请注意，GTK 不保证未来版本中单元格渲染器将继续使用相同的编辑小部件，因此在进行任何特定设置之前应检查 editable 的类型，如下例所示

static void
text_editing_started (GtkCellRenderer *cell,
                      GtkCellEditable *editable,
                      const char      *path,
                      gpointer         data)
{
  if (GTK_IS_ENTRY (editable))
    {
      GtkEntry *entry = GTK_ENTRY (editable);

      // ... create a GtkEntryCompletion

      gtk_entry_set_completion (entry, completion);
    }
}

默认处理器

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

参数

editable

类型： GtkCellEditable

GtkCellEditable。

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

path

类型： gchar*

标识所编辑单元格的路径。

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

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