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

#include <gtk/gtk.h>


            gtkdrawingarea;
gtkwidget*  gtk_drawing_area_new            (void);
void        gtk_drawing_area_size           (gtkdrawingarea *darea,
                                             gint width,
                                             gint height);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkdrawingarea
                           +----gtkcurve

реализуемые интерфейсы

gtkdrawingarea реализует atkimplementoriface.

описание

gtkdrawingarea используется для создания настраиваемых элементов пользовательского интерфейса. это по существу пустой виджет; вы можете отобразить widget->window. после создания области для рисования, приложение может подключать:

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

• сигнал "realize" для любых необходимых действий, когда виджет проиллюстрирован на определённом экране. (создаются ресурсы gdk в ответ на этот сигнал.)

• сигнал "configure_event" для получения конкретных действий когда виджет изменяет размер.

• сигнал "expose_event" для обработки перерисовки содержимого виджета.

следующая часть кода демонстрирует использование области рисования для отображения круга в обычном цвете символов виджета. помните, gdk автоматически очищает просматриваемую область до цвета фона перед ответом на событие экспонирования, а рисунок не явно прикреплён к области просмотра.

пример 1. простое использование gtkdrawingarea.

gboolean
expose_event_callback (gtkwidget *widget, gdkeventexpose *event, gpointer data)
{
  gdk_draw_arc (widget->window,
                widget->style->fg_gc[gtk_widget_state (widget)],
                true,
                0, 0, widget->allocation.width, widget->allocation.height,
                0, 64 * 360);
 
  return true;
}
[...]
  gtkwidget *drawing_area = gtk_drawing_area_new ();
  gtk_widget_set_size_request (drawing_area, 100, 100);
  g_signal_connect (g_object (drawing_area), "expose_event",  
                    g_callback (expose_event_callback), null);

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

доступные подпрограммы для рисования доступны на страницах gdk drawing primitives. смотрите также gdk_pixbuf_render_to_drawable() для рисования gdkpixbuf.

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

детали

gtkdrawingarea

typedef struct _gtkdrawingarea gtkdrawingarea;

структура gtkdrawingarea содержит только закрытые данные, доступ к которым разрешён только функциям описанным ниже.

gtk_drawing_area_new ()

gtkwidget*  gtk_drawing_area_new            (void);

создаёт новую область рисования.

gtk_drawing_area_size ()

void        gtk_drawing_area_size           (gtkdrawingarea *darea,
                                             gint width,
                                             gint height);

внимание

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

(вместо неё используйте gtk_widget_set_size_request().) устанавливает размер области рисования в ответ на сигнал "size_request". область рисования в действительности может занимать больший размер чем распределено, это зависит от того как она упакована в контейнер.

смотрите также

иногда gtkimage полезен как альтернатива области рисования. вы можете поместить gdkpixmap в gtkimage и рисовать в gdkpixmap, вызывая gtk_widget_queue_draw() для gtkimage когда вам нужно обновить экран.