GnomeScanDialog

GnomeScanDialog — Scan configuration dialog

Synopsis


#include <gnome-scan.h>

                    GnomeScanDialog;
GtkWidget*          gnome_scan_dialog_new               (GtkWindow *parent,
                                                         GnomeScanJob *job);
void                gnome_scan_dialog_run               (GnomeScanDialog *dialog);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----GtkDialog
                                             +----GnomeScanDialog

Implemented Interfaces

GnomeScanDialog implements AtkImplementorIface and GtkBuildable.

Properties

  "job"                      GnomeScanJob*         : Read / Write / Construct Only

Description

The goal of the GnomeScanDialog is to allow the user to configure a GnomeScanJob, and trigger the execution of this job by running a GnomeScanAcquisitionDialog on it.

Details

GnomeScanDialog

typedef struct _GnomeScanDialog GnomeScanDialog;

The GnomeScanDialog is an autofilled GtkDialog that present a graphical interface consistent with GtkPrintUnixDialog available Gtk+ since 2.10, but intirely adapted to scanning. You should not touch GtkDialog vbox, however, if you want to add a About button or similar, use GtkDialog action_area.


gnome_scan_dialog_new ()

GtkWidget*          gnome_scan_dialog_new               (GtkWindow *parent,
                                                         GnomeScanJob *job);

Instanciate the new dialog and populate it considering job scanner, processor and sink.

parent :

The parent GtkWindow

job :

the job to configure

Returns :

a new GnomeScanDialog

gnome_scan_dialog_run ()

void                gnome_scan_dialog_run               (GnomeScanDialog *dialog);

Run the dialog. If no backends are loaded, a popup is shown, and the function returns. If no scanners has been detected, the dialog wait for scanner plug through "scanner-added" signal, and present a warning popup to user asking him to ensure device is plugged, etc.

Once the dialog has been applied, a GnomeScanAquisitionDialog is run on the "job".

See: GnomeScanJob

dialog :

a GnomeScanDialog

Property Details

The "job" property

  "job"                      GnomeScanJob*         : Read / Write / Construct Only

The job the dialog is configuring.