EpcProgressWindow

EpcProgressWindow — provide feedback during lengthly operations

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <libepc-ui/progress-window.h>

struct              EpcProgressWindowClass;
                    EpcProgressWindowPrivate;
struct              EpcProgressWindow;
GtkWidget *         epc_progress_window_new             (const gchar *title,
                                                         GtkWindow *parent,
                                                         const gchar *message);
void                epc_progress_window_update          (EpcProgressWindow *window,
                                                         gdouble progress,
                                                         const gchar *message);
void                epc_progress_window_install         (GtkWindow *parent);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkWindow
                                       +----EpcProgressWindow

Implemented Interfaces

EpcProgressWindow implements AtkImplementorIface and GtkBuildable.

Properties

  "message"                  gchar*                : Read / Write / Construct
  "progress"                 gdouble               : Read / Write / Construct
  "title"                    gchar*                : Read / Write / Construct

Description

The EpcProgressWindow can be used to provide some feedback during lengthly operations, like generating server keys.

See also: epc_tls_private_key_new()

Details

struct EpcProgressWindowClass

struct EpcProgressWindowClass {
};

Virtual methods of the EpcProgressWindow class.


EpcProgressWindowPrivate

typedef struct _EpcProgressWindowPrivate EpcProgressWindowPrivate;

Private fields of the EpcProgressWindow class.


struct EpcProgressWindow

struct EpcProgressWindow;

Public fields of the EpcProgressWindow class.


epc_progress_window_new ()

GtkWidget *         epc_progress_window_new             (const gchar *title,
                                                         GtkWindow *parent,
                                                         const gchar *message);

Creates a new EpcProgressWindow instance.

title :

the title of the window

parent :

the transient parent of the window, or NULL

message :

the message to show, or NULL

Returns :

The newly created EpcProgressWindow.

epc_progress_window_update ()

void                epc_progress_window_update          (EpcProgressWindow *window,
                                                         gdouble progress,
                                                         const gchar *message);

Updates the EpcProgressWindow with new progress information. The progress is expressed as percentage in the range [0..1], or -1 if the progress cannot be estimated.

See also: "message", "progress"

window :

a EpcProgressWindow

progress :

the current progress, or -1

message :

a description of the current progress

epc_progress_window_install ()

void                epc_progress_window_install         (GtkWindow *parent);

Configures the hooks provided by libepc to use EpcProgressWindow when for performing long standing tasks like for instance generating private keys.

See also: epc_tls_set_private_key_hooks()

parent :

the transient parent of the window, or NULL

Property Details

The "message" property

  "message"                  gchar*                : Read / Write / Construct

The progress message to show.

Default value: NULL


The "progress" property

  "progress"                 gdouble               : Read / Write / Construct

Current progress, or -1.

Allowed values: [-1,1]

Default value: -1


The "title" property

  "title"                    gchar*                : Read / Write / Construct

The title to show.

Default value: NULL