GnomeScanPreviewArea

GnomeScanPreviewArea — A scan area selector

Synopsis




                    GnomeScanPreviewArea;
GtkWidget*          gnome_scan_preview_area_new         (GnomeScanContext *context);
void                gnome_scan_preview_area_refresh     (GnomeScanPreviewArea *area);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkScrolledWindow
                                       +----GnomeScanPreviewArea

Implemented Interfaces

GnomeScanPreviewArea implements AtkImplementorIface.

Properties


  "context"                  GnomeScanContext      : Read / Write

Description

This widget is primarily intended to be reused by GnomeScanPreview and GnomeScanAdvancedPreview. GnomeScanPreviewArea shows a GtkScrolledWindow containing a scan preview. The preview image has a selectable rectangle the user can move an resize. When the user resize the area, the widget sent to the connected context the selected area. GnomeScanPreviewArea is connected to the GnomeScanContext::"preview-received" signal in order to update the preview. However, GnomeScanPreviewArea does not ask for a preview, so application should use GnomeScanPreview and GnomeScanAdvancedPreview which have a "Refresh" button, unless the application implements its own preview widget.

Details

GnomeScanPreviewArea

typedef struct {
  GnomeScanContext	*context;
  GtkWidget		*drawing_area;
  /* Current preview resolution */
  gdouble		resolution;
} GnomeScanPreviewArea;


gnome_scan_preview_area_new ()

GtkWidget*          gnome_scan_preview_area_new         (GnomeScanContext *context);

Create a new GnomeScanPreviewArea and connect it to context.

context : a GnomeScanContext
Returns : a new GnomeScanPreviewArea

gnome_scan_preview_area_refresh ()

void                gnome_scan_preview_area_refresh     (GnomeScanPreviewArea *area);

Warning

gnome_scan_preview_area_refresh is deprecated and should not be used in newly-written code. application must directly ask the GnomeScanContext for a preview.

Query the GnomeScanContext to acquire a fresh scan review.

Property Details

The "context" property

  "context"                  GnomeScanContext      : Read / Write

The GnomeScanContext the widget is connected to.