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 | |
36 | G_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 | |
45 | typedef struct _GtkDrawingArea GtkDrawingArea; |
46 | typedef 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 | */ |
63 | typedef void (* GtkDrawingAreaDrawFunc) (GtkDrawingArea *drawing_area, |
64 | cairo_t *cr, |
65 | int width, |
66 | int height, |
67 | gpointer user_data); |
68 | |
69 | struct _GtkDrawingArea |
70 | { |
71 | GtkWidget widget; |
72 | }; |
73 | |
74 | struct _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 | |
88 | GDK_AVAILABLE_IN_ALL |
89 | GType gtk_drawing_area_get_type (void) G_GNUC_CONST; |
90 | GDK_AVAILABLE_IN_ALL |
91 | GtkWidget* gtk_drawing_area_new (void); |
92 | |
93 | GDK_AVAILABLE_IN_ALL |
94 | void gtk_drawing_area_set_content_width (GtkDrawingArea *self, |
95 | int width); |
96 | GDK_AVAILABLE_IN_ALL |
97 | int gtk_drawing_area_get_content_width (GtkDrawingArea *self); |
98 | GDK_AVAILABLE_IN_ALL |
99 | void gtk_drawing_area_set_content_height (GtkDrawingArea *self, |
100 | int height); |
101 | GDK_AVAILABLE_IN_ALL |
102 | int gtk_drawing_area_get_content_height (GtkDrawingArea *self); |
103 | GDK_AVAILABLE_IN_ALL |
104 | void gtk_drawing_area_set_draw_func (GtkDrawingArea *self, |
105 | GtkDrawingAreaDrawFunc draw_func, |
106 | gpointer user_data, |
107 | GDestroyNotify destroy); |
108 | |
109 | G_END_DECLS |
110 | |
111 | #endif /* __GTK_DRAWING_AREA_H__ */ |
112 | |