Spec-Zone.ru › GTK 3.20

GtkCellView

GtkCellView — Виджет, отображающий один ряд GtkTreeModel

Функции

GtkWidget * gtk_cell_view_new ()
GtkWidget * gtk_cell_view_new_with_context ()
GtkWidget * gtk_cell_view_new_with_text ()
GtkWidget * gtk_cell_view_new_with_markup ()
GtkWidget * gtk_cell_view_new_with_pixbuf ()
void gtk_cell_view_set_model ()
GtkTreeModel * gtk_cell_view_get_model ()
void gtk_cell_view_set_displayed_row ()
GtkTreePath * gtk_cell_view_get_displayed_row ()
gboolean gtk_cell_view_get_size_of_row ()
void gtk_cell_view_set_background_color ()
void gtk_cell_view_set_background_rgba ()
void gtk_cell_view_set_draw_sensitive ()
gboolean gtk_cell_view_get_draw_sensitive ()
void gtk_cell_view_set_fit_model ()
gboolean gtk_cell_view_get_fit_model ()

Свойства

gchar * background Запись
GdkColor * background-gdk Чтение / Запись
GdkRGBA * background-rgba Чтение / Запись
gboolean background-set Чтение / Запись
GtkCellArea * cell-area Чтение / Запись / Только для создания
GtkCellAreaContext * cell-area-context Чтение / Запись / Только для создания
gboolean draw-sensitive Чтение / Запись
gboolean fit-model Чтение / Запись
GtkTreeModel * model Чтение / Запись

Типы и значения

struct GtkCellView
struct GtkCellViewClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkCellView

Реализованные интерфейсы

GtkCellView реализует AtkImplementorIface, GtkBuildable, GtkCellLayout и GtkOrientable.

Включаемые файлы

#include <gtk/gtk.h>

Описание

A GtkCellView отображает одну строку GtkTreeModel с использованием GtkCellArea и GtkCellAreaContext. GtkCellAreaContext можно предоставить GtkCellView во время создания, чтобы удерживать GtkCellView в контексте группы представлений ячеек. Это гарантирует, что отображаемые рендереры будут правильно выровнены друг с другом (например, выровненные ячейки в меню GtkComboBox).

GtkCellView является GtkOrientable, чтобы определить, в какой ориентации следует размещать базовый GtkCellAreaContext. Например, в меню GtkComboBox представления ячеек должны быть ориентированы горизонтально, если меню перечислены сверху вниз, и все они имеют одинаковую ширину, но могут иметь разные высоты (горизонтальные меню слева направо должны быть размещены вертикально, так как у них одинаковая высота, но разные ширины).

CSS-узлы

GtkCellView имеет один CSS-узел с именем cellview.

Функции

gtk_cell_view_new ()

GtkWidget *
gtk_cell_view_new (void);

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

Возвращаемое значение

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

С: 2.6

gtk_cell_view_new_with_context ()

GtkWidget *
gtk_cell_view_new_with_context (GtkCellArea *area,
                                GtkCellAreaContext *context);

Создаёт новый виджет GtkCellView со специфическим GtkCellArea для выравнивания ячеек и специфическим GtkCellAreaContext.

Указание одного и того же контекста для нескольких ячеек позволяет базовой области синхронизировать геометрию этих ячеек, таким образом становятся возможными выравнивания с cellview для других строк.

Параметры

area

GtkCellArea для выравнивания ячеек

context

GtkCellAreaContext для расчёта геометрии ячейки

Возвращаемое значение

Новый созданный виджет 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.

Параметры

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.

[allow-none]

С: 2.6

gtk_cell_view_get_model ()

GtkTreeModel *
gtk_cell_view_get_model (GtkCellView *cell_view);

Возвращает модель для cell_view . Если модель не используется, возвращается NULL.

Параметры

cell_view

виджет GtkCellView

Возвращаемое значение

модель GtkTreeModel или NULL.

[nullable][transfer none]

С: 2.16

gtk_cell_view_set_displayed_row ()

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

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

Параметры

cell_view

виджет GtkCellView

path

GtkTreePath или NULL для сброса.

[allow-none]

С: 2.6

gtk_cell_view_get_displayed_row ()

GtkTreePath *
gtk_cell_view_get_displayed_row (GtkCellView *cell_view);

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

Параметры

cell_view

виджет GtkCellView

Возвращаемое значение

текущую отображаемую строку или NULL.

[nullable][transfer full]

С: 2.6

gtk_cell_view_get_size_of_row ()

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

gtk_cell_view_get_size_of_row устарел с версии 3.0 и не должен использоваться в новом коде.

Комбо-бокс ранее использовал это для расчёта размеров для cellview, теперь вы можете этого добиться, либо используя свойство “fit-model”, либо установив отображаемую строку GtkCellView и используя gtk_widget_get_preferred_size().

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

Параметры

cell_view

a GtkCellView

path

a GtkTreePath

requisition

место для возвращаемого размера.

[out]

Возвращаемое значение

TRUE

С версии: 2.6

gtk_cell_view_set_background_color ()

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

gtk_cell_view_set_background_color устарел с версии 3.4 и не должен использоваться в новом коде.

Используйте gtk_cell_view_set_background_rgba() вместо этого.

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

Параметры

cell_view

a GtkCellView

color

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

С версии: 2.6

gtk_cell_view_set_background_rgba ()

void
gtk_cell_view_set_background_rgba (GtkCellView *cell_view,
                                   const GdkRGBA *rgba);

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

Параметры

cell_view

a GtkCellView

rgba

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

С версии: 3.0

gtk_cell_view_set_draw_sensitive ()

void
gtk_cell_view_set_draw_sensitive (GtkCellView *cell_view,
                                  gboolean draw_sensitive);

Устанавливает, должен ли cell_view рисовать все свои ячейки в активном состоянии. Это используется меню GtkComboBox для обеспечения того, что строки с неактивными ячейками, содержащие дочерние элементы, выглядят активными в родительском пункте меню.

Параметры

cell_view

a GtkCellView

draw_sensitive

должны ли все ячейки отображаться в активном состоянии.

С версии: 3.0

gtk_cell_view_get_draw_sensitive ()

gboolean
gtk_cell_view_get_draw_sensitive (GtkCellView *cell_view);

Получает, настроен ли cell_view для отображения всех своих ячеек в активном состоянии.

Параметры

cell_view

a GtkCellView

Возвращаемое значение

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

С версии: 3.0

gtk_cell_view_set_fit_model ()

void
gtk_cell_view_set_fit_model (GtkCellView *cell_view,
                             gboolean fit_model);

Устанавливает, должен ли cell_view запрашивать место для соответствия всему GtkTreeModel.

Это используется GtkComboBox для обеспечения того, что отображаемый cell view на кнопке combo box всегда получает достаточно места и не изменяет размер при изменении выбора.

Параметры

cell_view

a GtkCellView

fit_model

должен ли cell_view запрашивать место для всей модели.

С версии: 3.0

gtk_cell_view_get_fit_model ()

gboolean
gtk_cell_view_get_fit_model (GtkCellView *cell_view);

Получает, настроен ли cell_view для запроса места для соответствия всему GtkTreeModel.

Параметры

cell_view

a GtkCellView

Возвращаемое значение

запрашивает ли cell_view место для соответствия всей GtkTreeModel.

С версии: 3.0

Типы и значения

struct GtkCellView

struct GtkCellView;

struct GtkCellViewClass

struct GtkCellViewClass {
  GtkWidgetClass parent_class;
};

Члены

Подробности свойств

Свойство “background”

  “background”               gchar *

Цвет фона в виде строки.

Флаги: Запись

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

Свойство “background-gdk”

  “background-gdk”           GdkColor *

Цвет фона в виде GdkColor.

GtkCellView:background-gdk устарело с версии 3.4 и не должно использоваться в новых кодах.

Используйте «background-rgba» вместо этого.

Флаги: Чтение / Запись

Свойство “background-rgba”

  “background-rgba”          GdkRGBA *

Цвет фона в виде GdkRGBA.

Флаги: Чтение / Запись

С версии: 3.0

Свойство “background-set”

  “background-set”           gboolean

Определяет, влияет ли этот тег на цвет фона.

Флаги: Чтение / Запись

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

Свойство “cell-area”

  “cell-area”                GtkCellArea *

Объект GtkCellArea, отображающий ячейки.

Если при создании представления ячеек с помощью gtk_cell_view_new_with_context() область не задана, будет использоваться горизонтально ориентированная GtkCellAreaBox.

с версии 3.0

Флаги: Чтение / Запись / Только для создания

Свойство “cell-area-context”

  “cell-area-context”        GtkCellAreaContext *

Объект GtkCellAreaContext, используемый для вычисления геометрии представления ячеек.

Группа представлений ячеек может быть назначена одному контексту, чтобы гарантировать соответствие размеров и выравнивания ячеек во всех представлениях с этим контекстом.

Меню GtkComboBox использует это для назначения одного контекста всем представлениям ячеек в элементах меню для одного меню (каждое подменю создает свой контекст, так как размер каждого подменю не зависит от родительских или соседних меню).

с версии 3.0

Флаги: Чтение / Запись / Только для создания

Свойство “draw-sensitive”

  “draw-sensitive”           gboolean

Определяет, должны ли все ячейки отображаться как активные для этого представления независимо от фактических свойств ячеек (используется для создания меню с подменю, которые отображаются как активные, когда элементы в подменю могут быть неактивными).

с версии 3.0

Флаги: Чтение / Запись

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

Свойство “fit-model”

  “fit-model”                gboolean

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

с версии 3.0

Флаги: Чтение / Запись

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

Свойство “model”

  “model”                    GtkTreeModel *

Модель для представления ячеек

с версии 2.10

Флаги: Чтение / Запись

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.20/GtkCellView.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API