Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties

GtkCellView

GtkCellView Виджет отображающий единственную строку GtkTreeModel

Краткое описание

#include <gtk/gtk.h> GtkCellView; GtkWidget* gtk_cell_view_new (void); GtkWidget* gtk_cell_view_new_with_text (const gchar *text); GtkWidget* gtk_cell_view_new_with_markup (const gchar *markup); GtkWidget* gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf); void gtk_cell_view_set_model (GtkCellView *cell_view, GtkTreeModel *model); void gtk_cell_view_set_displayed_row (GtkCellView *cell_view, GtkTreePath *path); GtkTreePath* gtk_cell_view_get_displayed_row (GtkCellView *cell_view); gboolean gtk_cell_view_get_size_of_row (GtkCellView *cell_view, GtkTreePath *path, GtkRequisition *requisition); void gtk_cell_view_set_background_color (GtkCellView *cell_view, const GdkColor *color); GList* gtk_cell_view_get_cell_renderers (GtkCellView *cell_view);

Иерархия объектов

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkCellView

Осуществляемые интерфейсы

GtkCellView осуществляет AtkImplementorIface и GtkCellLayout.

Свойства

"background" gchararray : Write "background-gdk" GdkColor : Read / Write "background-set" gboolean : Read / Write "model" GtkTreeModel : Read / Write

Описание

GtkCellView отображает единственную строку GtkTreeModel, используя отображение ячейки просто как GtkTreeView. GtkCellView не поддерживает некоторые более сложные особенности GtkTreeView, такие как редактирование ячейки и drag and drop.

Детали

GtkCellView

typedef struct _GtkCellView GtkCellView;

gtk_cell_view_new ()

GtkWidget*  gtk_cell_view_new               (void);

Создаёт новый виджет GtkCellView.

Возвращает :

Вновь созданный виджет GtkCellView.

Начиная с версии 2.6


gtk_cell_view_new_with_text ()

GtkWidget*  gtk_cell_view_new_with_text     (const gchar *text);

Создаёт новый виджет GtkCellView, добавляет GtkCellRendererText к нему и заставляет его показывать text.

text :

Текст для отображения в ячейки просмотра

Возвращает :

Вновь созданный виджет GtkCellView.

Начиная с версии 2.6


gtk_cell_view_new_with_markup ()

GtkWidget*  gtk_cell_view_new_with_markup   (const gchar *markup);

Создаёт новый виджет GtkCellView, добавляет к нему GtkCellRendererText, и заставляет отображать markup. Текст может быть размечен с помощью Pango text markup language.

markup :

Текст для отображения в ячейке просмотра

Возвращает :

Вновь созданный виджет GtkCellView.

Начиная с версии 2.6


gtk_cell_view_new_with_pixbuf ()

GtkWidget*  gtk_cell_view_new_with_pixbuf   (GdkPixbuf *pixbuf);

Создаёт новый виджет GtkCellView, добавляет GtkCellRendererPixbuf в него и заставляет отображать pixbuf.

pixbuf :

Изображение отображаемое в ячейке просмотра

Возвращает :

Вновь созданный виджет GtkCellView.

Начиная с версии 2.6


gtk_cell_view_set_model ()

void gtk_cell_view_set_model (GtkCellView *cell_view, GtkTreeModel *model);

Устанавливает модель для cell_view. Если cell_view уже имеет установленную модель, то она удаляется перед установкой новой модели. Если model равна NULL, то просто удаляется предустановленная модель.

cell_view :

GtkCellView

model :

GtkTreeModel

Начиная с версии 2.6


gtk_cell_view_set_displayed_row ()

void gtk_cell_view_set_displayed_row (GtkCellView *cell_view, GtkTreePath *path);

Устанавливает строку модели которая в текущий момент отображается в GtkCellView. Если путь не установлен, то содержимое ячейки просмотра "прикрепляется" в последнее значение; это обычно не желательный результат, но может быть необходим промежуточным состояниям, например если модель для GtkCellView стала временно пустой.

cell_view :

GtkCellView

path :

GtkTreePath или NULL для удаления предустановленной модели.

Начиная с версии 2.6


gtk_cell_view_get_displayed_row ()

GtkTreePath* gtk_cell_view_get_displayed_row (GtkCellView *cell_view);

Возвращает GtkTreePath относящийся к текущемй отображаемой строке. Если нет текущемй отображаемой строки, возвращается NULL.

cell_view :

GtkCellView

Возвращает :

Текущая отображаемая строка или NULL

Начиная с версии 2.6


gtk_cell_view_get_size_of_row ()

gboolean gtk_cell_view_get_size_of_row (GtkCellView *cell_view, GtkTreePath *path, GtkRequisition *requisition);

Устанавливает requisition для необходимого размера cell_view отображающего строку модели указанную path.

cell_view :

GtkCellView

path :

GtkTreePath

requisition :

Место для хранения возвращаемого размера

Возвращает :

TRUE

Начиная с версии 2.6


gtk_cell_view_set_background_color ()

void gtk_cell_view_set_background_color (GtkCellView *cell_view, const GdkColor *color);

Устанавливает цвет фона view.

cell_view :

GtkCellView

color :

Новый цвет фона

Начиная с версии 2.6


gtk_cell_view_get_cell_renderers ()

GList* gtk_cell_view_get_cell_renderers (GtkCellView *cell_view);

Возвращает ячейку отображения которая добавлена в cell_view.

cell_view :

GtkCellView

Возвращает :

Список ячеек отображения. Список, но не недавно распределенные отображения, должен быть освобожден с помощью g_list_free() когда больше не будет нужен.

Начиная с версии 2.6

Детали свойств

Свойство "background"

  "background"           gchararray            : Write

Строка указывающая цвет фона.

Значение по умолчанию : NULL


Свойство "background-gdk"

  "background-gdk"       GdkColor              : Read / Write

Цвет фона как GdkColor.


Свойство "background-set"

  "background-set"       gboolean              : Read / Write

Влияет ли этот тег на цвет фона.

Значение по умолчанию : FALSE


Свойство "model"

  "model"                GtkTreeModel          : Read / Write

Модель для ячейки просмотра

Начиная с версии 2.10