transmission/gtk/hig.h

/*
 * This file Copyright (C) 2007-2009 Charles Kerr <charles@transmissionbt.com>
 *
 * This file is licensed by the GPL version 2.  Works owned by the
 * Transmission project are granted a special exemption to clause 2(b)
 * so that the bulk of its code can remain under the MIT license.
 * This exemption does not extend to derived works not owned by
 * the Transmission project.
 *
 * $Id$
 */

#ifndef __HIG_H__
#define __HIG_H__

#include <gtk/gtk.h>

/**
*** utility code for making dialog layout that follows the Gnome HIG.
*** see section 8.2.2, Visual Design > Window Layout > Dialogs.
**/

GtkWidget* hig_workarea_create( void );

void       hig_workarea_add_section_divider( GtkWidget * table,
                                             int *       row );

void       hig_workarea_add_section_title_widget( GtkWidget * t,
                                                  int *       row,
                                                  GtkWidget * w );

void       hig_workarea_add_section_title( GtkWidget *  table,
                                           int *        row,
                                           const char * section_title );

void       hig_workarea_add_wide_tall_control( GtkWidget * table,
                                               int *       row,
                                               GtkWidget * w );

void       hig_workarea_add_wide_control( GtkWidget * table,
                                          int *       row,
                                          GtkWidget * w );

GtkWidget* hig_workarea_add_wide_checkbutton( GtkWidget *  table,
                                              int *        row,
                                              const char * mnemonic_string,
                                              gboolean     is_active );

GtkWidget* hig_workarea_add_label( GtkWidget *  table,
                                   int          row,
                                   const char * mnemonic_string );

void       hig_workarea_add_label_w( GtkWidget * table,
                                     int         row,
                                     GtkWidget * label_widget );

void       hig_workarea_add_control( GtkWidget * table,
                                     int         row,
                                     GtkWidget * control );

GtkWidget* hig_workarea_add_tall_row( GtkWidget *  table,
                                      int *        row,
                                      const char * mnemonic_string,
                                      GtkWidget *  control,
                                      GtkWidget *  mnemonic_or_null_for_control );

GtkWidget* hig_workarea_add_row( GtkWidget *  table,
                                 int *        row,
                                 const char * mnemonic_string,
                                 GtkWidget *  control,
                                 GtkWidget *  mnemonic_or_null_for_control );

void       hig_workarea_add_row_w( GtkWidget * table,
                                   int *       row,
                                   GtkWidget * label,
                                   GtkWidget * control,
                                   GtkWidget * mnemonic_or_null_for_control );

void       hig_workarea_finish( GtkWidget * table,
                                int *       row );

void       hig_message_dialog_set_text( GtkMessageDialog * dialog,
                                        const char *       primary,
                                        const char *       secondary );

enum
{
    GUI_PAD_SMALL = 3,
    GUI_PAD = 6,
    GUI_PAD_BIG = 12,
    GUI_PAD_LARGE = 12
};

#endif /* __HIG_H__ */