GnomeScanDialog

## 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 GnomeScanBackend::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 GnomeScanDialog:job.

See: GnomeScanJob

`dialog` : | a GnomeScanDialog

## Property Details

### The "`job`" property

      "job"                      GnomeScanJob          : Read / Write / Construct Only

The job the dialog is configuring.