/*
 * This file Copyright (C) 2007-2008 Charles Kerr <charles@rebelbase.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/gtkwidget.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( GtkWidget   * table,
                                     int         * row,
                                     const char  * section_title );

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_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__ */