added gimp_preview_get_area() for the rare case when one needs access to

2005-07-21  Sven Neumann  <sven@gimp.org>

	* libgimpwidgets/gimppreview.[ch]: added gimp_preview_get_area()
	for the rare case when one needs access to the GimpPreviewArea
	used in the preview.

	* libgimpwidgets/gimpwidgets.def: updated.

ChangeLog

+2005-07-21  Sven Neumann  <sven@gimp.org>
+
+	* libgimpwidgets/gimppreview.[ch]: added gimp_preview_get_area()
+	for the rare case when one needs access to the GimpPreviewArea
+	used in the preview.
+
+	* libgimpwidgets/gimpwidgets.def: updated.
+
 2005-07-21  Pawan Chitrakar  <pawan@nplinux.org>
 
 	* configure.in: Added ne in ALL_LINGUAS

libgimpwidgets/gimppreview.c

@@ -577,6 +577,27 @@ gimp_preview_get_position (GimpPreview *preview,
     *y = preview->yoff + preview->ymin;
 }
 
+/**
+ * gimp_preview_get_area:
+ * @preview: a #GimpPreview widget
+ *
+ * In most cases, you shouldn't need to access the #GimpPreviewArea
+ * that is being used in the @preview. Sometimes however, you need to.
+ * For example if you want to receive mouse events from the area. In
+ * such cases, use gimp_preview_get_area().
+ *
+ * Return value: a pointer to the #GimpPreviewArea used in the @preview.
+ *
+ * Since: GIMP 2.4
+ **/
+GtkWidget *
+gimp_preview_get_area (GimpPreview  *preview)
+{
+  g_return_val_if_fail (GIMP_IS_PREVIEW (preview), NULL);
+
+  return preview->area;
+}
+
 /**
  * gimp_preview_draw:
  * @preview: a #GimpPreview widget

libgimpwidgets/gimppreview.h

@@ -88,34 +88,36 @@ struct _GimpPreviewClass
 };
 
 
-GType     gimp_preview_get_type           (void) G_GNUC_CONST;
-
-void      gimp_preview_set_update         (GimpPreview  *preview,
-                                           gboolean      update);
-gboolean  gimp_preview_get_update         (GimpPreview  *preview);
-
-void      gimp_preview_set_bounds         (GimpPreview  *preview,
-                                           gint          xmin,
-                                           gint          ymin,
-                                           gint          xmax,
-                                           gint          ymax);
-
-void      gimp_preview_get_position       (GimpPreview  *preview,
-                                           gint         *x,
-                                           gint         *y);
-void      gimp_preview_get_size           (GimpPreview  *preview,
-                                           gint         *width,
-                                           gint         *height);
-
-void      gimp_preview_draw               (GimpPreview  *preview);
-void      gimp_preview_draw_buffer        (GimpPreview  *preview,
-                                           const guchar *buffer,
-                                           gint          rowstride);
-
-void      gimp_preview_invalidate         (GimpPreview  *preview);
-
-void      gimp_preview_set_default_cursor (GimpPreview *preview,
-                                           GdkCursor   *cursor);
+GType       gimp_preview_get_type           (void) G_GNUC_CONST;
+
+void        gimp_preview_set_update         (GimpPreview  *preview,
+                                             gboolean      update);
+gboolean    gimp_preview_get_update         (GimpPreview  *preview);
+
+void        gimp_preview_set_bounds         (GimpPreview  *preview,
+                                             gint          xmin,
+                                             gint          ymin,
+                                             gint          xmax,
+                                             gint          ymax);
+
+void        gimp_preview_get_position       (GimpPreview  *preview,
+                                             gint         *x,
+                                             gint         *y);
+void        gimp_preview_get_size           (GimpPreview  *preview,
+                                             gint         *width,
+                                             gint         *height);
+
+GtkWidget * gimp_preview_get_area           (GimpPreview  *preview);
+
+void        gimp_preview_draw               (GimpPreview  *preview);
+void        gimp_preview_draw_buffer        (GimpPreview  *preview,
+                                             const guchar *buffer,
+                                             gint          rowstride);
+
+void        gimp_preview_invalidate         (GimpPreview  *preview);
+
+void        gimp_preview_set_default_cursor (GimpPreview *preview,
+                                             GdkCursor   *cursor);
 
 
 G_END_DECLS

libgimpwidgets/gimpwidgets.def

@@ -209,6 +209,7 @@ EXPORTS
 	gimp_preview_area_set_offsets
 	gimp_preview_draw
 	gimp_preview_draw_buffer
+	gimp_preview_get_area
 	gimp_preview_get_position
 	gimp_preview_get_size
 	gimp_preview_get_type