GtkListBoxset_header_func

设置标题函数。

在 box 上设置标题函数可以在取决于行的内容和其列表中的位置的动态方式下在行前添加标题。

例如，可以将其用于在按类别排序的列表中添加标题，以第一个新的类别项为例。

update_header 可以通过使用 gtk_list_box_row_get_header() 来查看当前的头控件，并根据需要更新控件的状态，或使用 gtk_list_box_row_set_header() 设置一个新的控件。如果不需要标题，则将标题设置为 NULL。

请注意，当例如更改不影响标题的内容时，您可能会接到针对特定行的许多 update_header 调用。在这种情况下，为了避免性能问题，不应盲目用相同的标题替换现有的标题。

update_header函数将在每次调用后对每一行进行调用，并且每次行发生变化（通过gtk_list_box_row_changed()）以及前一行的变化（通过前一行的gtk_list_box_row_changed()或前一行的上下游变换）都会继续被调用。同时，在调用gtk_list_box_invalidate_headers()时，也会对所有的行进行调用。