1/* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library. If not, see <http://www.gnu.org/licenses/>.
16 */
17
18/*
19 * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
20 * file for a list of people on the GTK+ Team. See the ChangeLog
21 * files for a list of changes. These files are distributed with
22 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
23 */
24
25#ifndef __GTK_DRAWING_AREA_H__
26#define __GTK_DRAWING_AREA_H__
27
28
29#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
30#error "Only <gtk/gtk.h> can be included directly."
31#endif
32
33#include <gtk/gtkwidget.h>
34
35
36G_BEGIN_DECLS
37
38#define GTK_TYPE_DRAWING_AREA (gtk_drawing_area_get_type ())
39#define GTK_DRAWING_AREA(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_DRAWING_AREA, GtkDrawingArea))
40#define GTK_DRAWING_AREA_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_DRAWING_AREA, GtkDrawingAreaClass))
41#define GTK_IS_DRAWING_AREA(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_DRAWING_AREA))
42#define GTK_IS_DRAWING_AREA_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_DRAWING_AREA))
43#define GTK_DRAWING_AREA_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_DRAWING_AREA, GtkDrawingAreaClass))
44
45typedef struct _GtkDrawingArea GtkDrawingArea;
46typedef struct _GtkDrawingAreaClass GtkDrawingAreaClass;
47
48/**
49 * GtkDrawingAreaDrawFunc:
50 * @drawing_area: the `GtkDrawingArea` to redraw
51 * @cr: the context to draw to
52 * @width: the actual width of the contents. This value will be at least
53 * as wide as GtkDrawingArea:width.
54 * @height: the actual height of the contents. This value will be at least
55 * as wide as GtkDrawingArea:height.
56 * @user_data: (closure): user data
57 *
58 * Whenever @drawing_area needs to redraw, this function will be called.
59 *
60 * This function should exclusively redraw the contents of the drawing area
61 * and must not call any widget functions that cause changes.
62 */
63typedef void (* GtkDrawingAreaDrawFunc) (GtkDrawingArea *drawing_area,
64 cairo_t *cr,
65 int width,
66 int height,
67 gpointer user_data);
68
69struct _GtkDrawingArea
70{
71 GtkWidget widget;
72};
73
74struct _GtkDrawingAreaClass
75{
76 GtkWidgetClass parent_class;
77
78 void (* resize) (GtkDrawingArea *area,
79 int width,
80 int height);
81
82 /*< private >*/
83
84 gpointer padding[8];
85};
86
87
88GDK_AVAILABLE_IN_ALL
89GType gtk_drawing_area_get_type (void) G_GNUC_CONST;
90GDK_AVAILABLE_IN_ALL
91GtkWidget* gtk_drawing_area_new (void);
92
93GDK_AVAILABLE_IN_ALL
94void gtk_drawing_area_set_content_width (GtkDrawingArea *self,
95 int width);
96GDK_AVAILABLE_IN_ALL
97int gtk_drawing_area_get_content_width (GtkDrawingArea *self);
98GDK_AVAILABLE_IN_ALL
99void gtk_drawing_area_set_content_height (GtkDrawingArea *self,
100 int height);
101GDK_AVAILABLE_IN_ALL
102int gtk_drawing_area_get_content_height (GtkDrawingArea *self);
103GDK_AVAILABLE_IN_ALL
104void gtk_drawing_area_set_draw_func (GtkDrawingArea *self,
105 GtkDrawingAreaDrawFunc draw_func,
106 gpointer user_data,
107 GDestroyNotify destroy);
108
109G_END_DECLS
110
111#endif /* __GTK_DRAWING_AREA_H__ */
112

source code of gtk/gtk/gtkdrawingarea.h