GtkCellArea

struct GtkCellAreaClass {
  void (* add) (
    GtkCellArea* area,
    GtkCellRenderer* renderer
  );
  void (* remove) (
    GtkCellArea* area,
    GtkCellRenderer* renderer
  );
  void (* foreach) (
    GtkCellArea* area,
    GtkCellCallback callback,
    gpointer callback_data
  );
  void (* foreach_alloc) (
    GtkCellArea* area,
    GtkCellAreaContext* context,
    GtkWidget* widget,
    const GdkRectangle* cell_area,
    const GdkRectangle* background_area,
    GtkCellAllocCallback callback,
    gpointer callback_data
  );
  int (* event) (
    GtkCellArea* area,
    GtkCellAreaContext* context,
    GtkWidget* widget,
    GdkEvent* event,
    const GdkRectangle* cell_area,
    GtkCellRendererState flags
  );
  void (* snapshot) (
    GtkCellArea* area,
    GtkCellAreaContext* context,
    GtkWidget* widget,
    GtkSnapshot* snapshot,
    const GdkRectangle* background_area,
    const GdkRectangle* cell_area,
    GtkCellRendererState flags,
    gboolean paint_focus
  );
  void (* apply_attributes) (
    GtkCellArea* area,
    GtkTreeModel* tree_model,
    GtkTreeIter* iter,
    gboolean is_expander,
    gboolean is_expanded
  );
  GtkCellAreaContext* (* create_context) (
    GtkCellArea* area
  );
  GtkCellAreaContext* (* copy_context) (
    GtkCellArea* area,
    GtkCellAreaContext* context
  );
  GtkSizeRequestMode (* get_request_mode) (
    GtkCellArea* area
  );
  void (* get_preferred_width) (
    GtkCellArea* area,
    GtkCellAreaContext* context,
    GtkWidget* widget,
    int* minimum_width,
    int* natural_width
  );
  void (* get_preferred_height_for_width) (
    GtkCellArea* area,
    GtkCellAreaContext* context,
    GtkWidget* widget,
    int width,
    int* minimum_height,
    int* natural_height
  );
  void (* get_preferred_height) (
    GtkCellArea* area,
    GtkCellAreaContext* context,
    GtkWidget* widget,
    int* minimum_height,
    int* natural_height
  );
  void (* get_preferred_width_for_height) (
    GtkCellArea* area,
    GtkCellAreaContext* context,
    GtkWidget* widget,
    int height,
    int* minimum_width,
    int* natural_width
  );
  void (* set_cell_property) (
    GtkCellArea* area,
    GtkCellRenderer* renderer,
    guint property_id,
    const GValue* value,
    GParamSpec* pspec
  );
  void (* get_cell_property) (
    GtkCellArea* area,
    GtkCellRenderer* renderer,
    guint property_id,
    GValue* value,
    GParamSpec* pspec
  );
  gboolean (* focus) (
    GtkCellArea* area,
    GtkDirectionType direction
  );
  gboolean (* is_activatable) (
    GtkCellArea* area
  );
  gboolean (* activate) (
    GtkCellArea* area,
    GtkCellAreaContext* context,
    GtkWidget* widget,
    const GdkRectangle* cell_area,
    GtkCellRendererState flags,
    gboolean edit_only
  );
  
}

无可用描述。

类成员

add: void (* add) ( GtkCellArea* area, GtkCellRenderer* renderer )

向 area 添加一个 `GtkCellRenderer`。

remove: void (* remove) ( GtkCellArea* area, GtkCellRenderer* renderer )

从 area 中移除一个 `GtkCellRenderer`。

foreach: void (* foreach) ( GtkCellArea* area, GtkCellCallback callback, gpointer callback_data )

使用提供的用户数据对区域中的每个 `GtkCellRenderer` 调用 `GtkCellCallback` 函数，直到回调返回 `TRUE`。

foreach_alloc: 无效 (* foreach_alloc) ( GtkCellArea* 区域, GtkCellAreaContext* 上下文, GtkWidget* 小组件, const GdkRectangle* 单元格区域, const GdkRectangle* 背景区域, GtkCellAllocCallback 回调, gpointer 回调数据 )

使用分配的单元格区域和提供用户数据，对区域中的每个 GtkCellRenderer 调用 GtkCellAllocCallback 函数，直到回调返回 TRUE。

事件: int (* 事件) ( GtkCellArea* 区域, GtkCellAreaContext* 上下文, GtkWidget* 小组件, GdkEvent* 事件, const GdkRectangle* 单元格区域, GtkCellRendererState 标志 )

在区域中处理事件，这通常用于激活按钮事件的事件位置的单元格，但也可用于将事件通常传递给绘制到该区域的 GtkWidget。

快照: 无效 (* 快照) ( GtkCellArea* 区域, GtkCellAreaContext* 上下文, GtkWidget* 小组件, GtkSnapshot* 快照, const GdkRectangle* 背景区域, const GdkRectangle* 单元格区域, GtkCellRendererState 标志, gboolean 图像焦点 )

事实上将区域的单元格快照到指定矩形中，background_area 应正确分配到单元格对应的背景区域。

应用属性: 无效 (* 应用属性) ( GtkCellArea* 区域, GtkTreeModel* 树模型, GtkTreeIter* 迭代器, gboolean 是否是扩展器, gboolean 是否已扩展 )

将单元格属性应用到单元格中。这是作为信号实现的，通常 GtkCellArea 子类不必实现该属性，因为它由基本类处理。

创建上下文: GtkCellAreaContext* (* 创建上下文) ( GtkCellArea* 区域 )

创建一个类特定的 GtkCellAreaContext 并返回，以存储单元格对齐和分配详细信息，用于所述 GtkCellArea 类。

复制上下文: GtkCellAreaContext* (* 复制上下文) ( GtkCellArea* 区域, GtkCellAreaContext* 上下文 )

以与传递的 上下文 相同的状态创建一个新 GtkCellAreaContext，其中所有单元格对齐数据和分配都保持不变。

获取请求模式: GtkSizeRequestMode (* 获取请求模式) ( GtkCellArea* 区域 )

这可让区域告知布局小组件，它更喜欢以 GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH 或 GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT 模式进行分配。

获取首选宽度: 无效 (* 获取首选宽度) ( GtkCellArea* 区域, GtkCellAreaContext* 上下文, GtkWidget* 小组件, int* 最小宽度, int* 常规宽度 )

计算区域单元格的最小宽度和常规宽度，同时应用当前属性并考虑所述 GtkCellArea 的特定布局详细信息。虽然针对一系列行执行请求，但最小大小和常规大小的对应 GtkCellAreaContext 中应存储对齐方式和总体数据。

获取宽度首选高度: 无效 (* 获取宽度首选高度) ( GtkCellArea* 区域, GtkCellAreaContext* 上下文, GtkWidget* 小组件, int 宽度, int* 最小高度, int* 常规高度 )

计算区域的最小高度和常规高度，前提是传递的 上下文 将分配给定宽度。在实现此虚拟方法时，可以安全地假设 上下文 已针对 上下文 将被分配的每个 GtkTreeModel 行存储对齐的单元格宽度，因为此信息存储在 GtkCellAreaClass.get_preferred_width() 时间。此虚拟方法还应存储单元格高度的任何必要对齐方式，以防上下文被分配高度。

获取首选高度: 无效 (* 获取首选高度) ( GtkCellArea* 区域, GtkCellAreaContext* 上下文, GtkWidget* 小组件, int* 最小高度, int* 常规高度 )

计算应用当前属性的区域单元格的最小高度和自然高度。从本质上讲，这与 `GtkCellAreaClass.get_preferred_width()` 完全相同，但仅适用于作为 `GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT` 请求的区域。

get_preferred_width_for_height: void (* get_preferred_width_for_height) ( GtkCellArea* area, GtkCellAreaContext* context, GtkWidget* widget, int height, int* minimum_width, int* natural_width )

如果传递的 `context` 会分配给特定高度，则计算该区域的最小宽度和自然宽度。与 `GtkCellAreaClass.get_preferred_height_for_width()` 相同，但仅用于处理 `GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT` 模式中的请求。

set_cell_property: void (* set_cell_property) ( GtkCellArea* area, GtkCellRenderer* renderer, guint property_id, const GValue* value, GParamSpec* pspec )

应实现此功能来处理特定 `GtkCellRenderer` 的子单元格属性更改，该属性先前通过 gtk_cell_area_class_install_cell_property() 安装在 `GtkCellAreaClass` 上。

get_cell_property: void (* get_cell_property) ( GtkCellArea* area, GtkCellRenderer* renderer, guint property_id, GValue* value, GParamSpec* pspec )

应实现此功能来报告特定子级 `GtkCellRenderer` 的子单元格属性值。

focus: gboolean (* focus) ( GtkCellArea* area, GtkDirectionType direction )

应实现此虚拟方法，以便从 `GtkCellArea` 内部的单元格导航到单元格。`GtkCellArea` 应从该区域内部的单元格移动到单元格，并在焦点从该区域逻辑退出时返回 `FALSE`，但有以下例外情况：当该区域不包含任何可激活单元格时，则整个区域接收焦点。不应将焦点授予实际上是其他同级单元格的“焦点同级”的单元格（请参阅 gtk_cell_area_get_focus_from_sibling()）。通过调用 gtk_cell_area_set_focus_cell() 设置焦点。

is_activatable: gboolean (* is_activatable) ( GtkCellArea* area )

返回 `GtkCellArea` 是否可以响应 `GtkCellAreaClass.activate()`，通常无需实现，因为基类会负责此功能，但如果 `GtkCellArea` 子类可以通过除激活其 `GtkCellRenderers` 以外的其他方式处理激活，则可以增强它。

activate: gboolean (* activate) ( GtkCellArea* area, GtkCellAreaContext* context, GtkWidget* widget, const GdkRectangle* cell_area, GtkCellRendererState flags, gboolean edit_only )

当呈现 `GtkCellArea` 的布局小部件激活焦点单元格时（参见 gtk_cell_area_get_focus_cell()），即调用此功能。