Creating and editing accounts in the GUI

Files
file	dialog-account.h
	This file contains the functions to present a gui to the user for creating a new account or editing an existing account.

Functions
void	gnc_account_renumber_create_dialog (GtkWidget *window, Account *account)
void	gnc_account_cascade_properties_dialog (GtkWidget *window, Account *account)

Non-Modal
void	gnc_ui_edit_account_window (GtkWindow *parent, Account *account)
	Display a window for editing the attributes of an existing account.
void	gnc_ui_new_account_with_types_and_commodity (GtkWindow *parent, QofBook *book, GList *valid_types, gnc_commodity *)
	Display a window for creating a new account.
void	gnc_ui_new_account_window (GtkWindow *parent, QofBook *book, Account *parent_acct)
	Display a window for creating a new account.
void	gnc_ui_new_account_with_types (GtkWindow *parent, QofBook *book, GList *valid_types)
	Display a window for creating a new account.

Modal
Account *	gnc_ui_new_accounts_from_name_window (GtkWindow *parent, const char *name)
	Display a modal window for creating a new account.
Account *	gnc_ui_new_accounts_from_name_with_defaults (GtkWindow *parent, const char *name, GList *valid_types, const gnc_commodity *default_commodity, Account *parent_acct)
	Display a modal window for creating a new account.
void	gnc_ui_register_account_destroy_callback (void(*cb)(Account *))

Detailed Description

Function Documentation

gnc_account_cascade_properties_dialog()

void gnc_account_cascade_properties_dialog	(	GtkWidget *	window,
		Account *	account
	)

Definition at line 2423 of file dialog-account.c.

{
    GtkWidget *dialog;
    GtkBuilder *builder;
    GtkWidget *label;
    GtkWidget *color_button, *over_write, *color_button_default;
    GtkWidget *enable_color, *enable_placeholder, *enable_hidden;
    GtkWidget *color_box, *placeholder_box, *hidden_box;
    GtkWidget *placeholder_button, *hidden_button;
 
    gchar *string, *fullname;
    const char *color_string;
    gchar *old_color_string = NULL;
    GdkRGBA color;
    gint response;
 
    // check if we actually do have sub accounts
    g_return_if_fail (gnc_account_n_children (account) > 0);
 
    builder = gtk_builder_new ();
    gnc_builder_add_from_file (builder, "dialog-account.glade", "account_cascade_dialog");
    dialog = GTK_WIDGET(gtk_builder_get_object (builder, "account_cascade_dialog"));
    gtk_window_set_transient_for (GTK_WINDOW(dialog), GTK_WINDOW(window));
 
    // Color section
    enable_color = GTK_WIDGET(gtk_builder_get_object (builder, "enable_cascade_color"));
    color_box = GTK_WIDGET(gtk_builder_get_object (builder, "color_box"));
 
    label = GTK_WIDGET(gtk_builder_get_object (builder, "color_label"));
    over_write = GTK_WIDGET(gtk_builder_get_object (builder, "replace_check"));
    color_button = GTK_WIDGET(gtk_builder_get_object (builder, "color_button"));
    color_button_default = GTK_WIDGET(gtk_builder_get_object (builder, "color_button_default"));
 
    gtk_color_chooser_set_use_alpha (GTK_COLOR_CHOOSER(color_button), FALSE);
 
    g_signal_connect (G_OBJECT(enable_color), "toggled",
                      G_CALLBACK(enable_box_cb), (gpointer)color_box);
 
    g_signal_connect (G_OBJECT(color_button_default), "clicked",
                      G_CALLBACK(default_color_button_cb), (gpointer)color_button);
 
    fullname = gnc_account_get_full_name (account);
    string = g_strdup_printf (_( "Set the account color for account '%s' "
                                 "including all sub-accounts to the selected color"),
                              fullname);
    gtk_label_set_text (GTK_LABEL(label), string);
    g_free (string);
 
    color_string = xaccAccountGetColor (account); // get existing account color
 
    if (!color_string)
        color_string = DEFAULT_COLOR;
    else
       old_color_string = g_strdup (color_string); // save the old color string
 
    if (!gdk_rgba_parse (&color, color_string))
        gdk_rgba_parse (&color, DEFAULT_COLOR);
 
    // set the color chooser to account color
    gtk_color_chooser_set_rgba (GTK_COLOR_CHOOSER(color_button), &color);
 
    // Placeholder section
    enable_placeholder = GTK_WIDGET(gtk_builder_get_object (builder, "enable_cascade_placeholder"));
    placeholder_box = GTK_WIDGET(gtk_builder_get_object (builder, "placeholder_box"));
    label = GTK_WIDGET(gtk_builder_get_object (builder, "placeholder_label"));
    placeholder_button = GTK_WIDGET(gtk_builder_get_object (builder, "placeholder_check_button"));
    g_signal_connect (G_OBJECT(enable_placeholder), "toggled",
                      G_CALLBACK(enable_box_cb), (gpointer)placeholder_box);
 
    string = g_strdup_printf (_( "Set the account placeholder value for account '%s' "
                                 "including all sub-accounts"),
                              fullname);
    gtk_label_set_text (GTK_LABEL(label), string);
    g_free (string);
 
    // Hidden section
    enable_hidden = GTK_WIDGET(gtk_builder_get_object (builder, "enable_cascade_hidden"));
    hidden_box = GTK_WIDGET(gtk_builder_get_object (builder, "hidden_box"));
    label = GTK_WIDGET(gtk_builder_get_object (builder, "hidden_label"));
    hidden_button = GTK_WIDGET(gtk_builder_get_object (builder, "hidden_check_button"));
    g_signal_connect (G_OBJECT(enable_hidden), "toggled",
                      G_CALLBACK(enable_box_cb), (gpointer)hidden_box);
 
    string = g_strdup_printf (_( "Set the account hidden value for account '%s' "
                                 "including all sub-accounts"),
                              fullname);
    gtk_label_set_text (GTK_LABEL(label), string);
    g_free (string);
    g_free (fullname);
 
    /* default to cancel */
    gtk_dialog_set_default_response (GTK_DIALOG(dialog), GTK_RESPONSE_CANCEL);
 
    gtk_builder_connect_signals (builder, dialog);
    g_object_unref (G_OBJECT(builder));
 
    gtk_widget_show_all (dialog);
 
    response = gtk_dialog_run (GTK_DIALOG(dialog));
 
    if (response == GTK_RESPONSE_OK)
    {
        GList *accounts = gnc_account_get_descendants (account);
        GdkRGBA new_color;
        gchar *new_color_string = NULL;
        gboolean color_active = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON(enable_color));
        gboolean placeholder_active = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON(enable_placeholder));
        gboolean hidden_active = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON(enable_hidden));
        gboolean replace = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON(over_write));
        gboolean placeholder = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON(placeholder_button));
        gboolean hidden = gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON(hidden_button));
 
        // Update Account Colors
        if (color_active)
        {
            gtk_color_chooser_get_rgba (GTK_COLOR_CHOOSER(color_button), &new_color);
            new_color_string = gdk_rgba_to_string (&new_color);
 
            if (g_strcmp0 (new_color_string, DEFAULT_COLOR) == 0)
            {
                g_free (new_color_string);
                new_color_string = NULL;
            }
 
            // check/update selected account
            update_account_color (account, old_color_string, new_color_string, replace);
        }
 
        // Update Account Placeholder value
        if (placeholder_active)
            xaccAccountSetPlaceholder (account, placeholder);
 
        // Update Account Hidden value
        if (hidden_active)
            xaccAccountSetHidden (account, hidden);
 
        // Update SubAccounts
        if (accounts)
        {
            for (GList *acct = accounts; acct; acct = g_list_next(acct))
            {
                // Update SubAccount Colors
                if (color_active)
                {
                    const char *string = xaccAccountGetColor (acct->data);
                    update_account_color (acct->data, string, new_color_string, replace);
                }
                // Update SubAccount PlaceHolder
                if (placeholder_active)
                    xaccAccountSetPlaceholder (acct->data, placeholder);
                // Update SubAccount Hidden
                if (hidden_active)
                    xaccAccountSetHidden (acct->data, hidden);
            }
        }
        g_list_free (accounts);
        g_free (new_color_string);
    }
    if (old_color_string)
        g_free (old_color_string);
 
    gtk_widget_destroy (dialog);
}

gnc_account_renumber_create_dialog()

void gnc_account_renumber_create_dialog	(	GtkWidget *	window,
		Account *	account
	)

Definition at line 2331 of file dialog-account.c.

{
    RenumberDialog *data;
    GtkBuilder *builder;
    GtkWidget *widget;
    gchar *string, *fullname;
 
    /* This is a safety check; the menu item calling this dialog
     * should be disabled if the account has no children.
     */
    g_return_if_fail (gnc_account_n_children (account) > 0);
 
    data = g_new (RenumberDialog, 1);
    data->parent = account;
    data->num_children = gnc_account_n_children (account);
 
    builder = gtk_builder_new ();
    gnc_builder_add_from_file (builder, "dialog-account.glade", "interval_adjustment");
    gnc_builder_add_from_file (builder, "dialog-account.glade", "digit_spin_adjustment");
    gnc_builder_add_from_file (builder, "dialog-account.glade", "account_renumber_dialog");
    data->dialog = GTK_WIDGET(gtk_builder_get_object (builder, "account_renumber_dialog"));
    gtk_window_set_transient_for (GTK_WINDOW(data->dialog), GTK_WINDOW(window));
 
    g_object_set_data_full (G_OBJECT(data->dialog), "builder", builder,
                            g_object_unref);
 
    widget = GTK_WIDGET(gtk_builder_get_object (builder, "header_label"));
    fullname = gnc_account_get_full_name (account);
    string = g_strdup_printf (_("Renumber the immediate sub-accounts of '%s'?"),
                              fullname);
    gtk_label_set_text (GTK_LABEL(widget), string);
    g_free (string);
    g_free (fullname);
 
    data->prefix = GTK_WIDGET(gtk_builder_get_object (builder, "prefix_entry"));
    data->interval = GTK_WIDGET(gtk_builder_get_object (builder, "interval_spin"));
    data->digits = GTK_WIDGET(gtk_builder_get_object (builder, "digit_spin"));
    data->example1 = GTK_WIDGET(gtk_builder_get_object (builder, "example1_label"));
    data->example2 = GTK_WIDGET(gtk_builder_get_object (builder, "example2_label"));
 
    gtk_entry_set_text (GTK_ENTRY(data->prefix), xaccAccountGetCode (account));
    gnc_account_renumber_update_examples (data);
 
    gtk_builder_connect_signals (builder, data);
 
    gtk_widget_show_all (data->dialog);
}

gnc_ui_edit_account_window()

void gnc_ui_edit_account_window	(	GtkWindow *	parent,
		Account *	account
	)

Display a window for editing the attributes of an existing account.

Parameters

parent	The widget on which to parent the dialog.
account	This parameter specifies the account whose data will be edited.

Definition at line 2102 of file dialog-account.c.

{
    AccountWindow * aw;
    Account *parent_acct;
 
    if (account == NULL)
        return;
 
    aw = gnc_find_first_gui_component (DIALOG_EDIT_ACCOUNT_CM_CLASS,
                                       find_by_account, account);
    if (aw)
    {
        gtk_window_present (GTK_WINDOW(aw->dialog));
        return;
    }
 
    aw = g_new0 (AccountWindow, 1);
 
    aw->book = gnc_account_get_book (account);
    aw->modal = FALSE;
    aw->dialog_type = EDIT_ACCOUNT;
    aw->account = *xaccAccountGetGUID (account);
    aw->subaccount_names = NULL;
    aw->type = xaccAccountGetType (account);
 
    gnc_suspend_gui_refresh ();
 
    gnc_account_window_create (parent, aw);
    gnc_account_to_ui (aw);
 
    gnc_resume_gui_refresh ();
 
    gtk_widget_show_all (aw->dialog);
    if (xaccAccountGetSplitsSize (account) != 0)
        gtk_widget_hide (aw->opening_balance_page);
 
    parent_acct = gnc_account_get_parent (account);
    if (parent_acct == NULL)
        parent_acct = account; // must be at the root
 
    gtk_tree_view_collapse_all (aw->parent_tree);
    gnc_tree_view_account_set_selected_account (GNC_TREE_VIEW_ACCOUNT(
                                                aw->parent_tree),
                                                parent_acct);
 
    gnc_account_window_set_name (aw);
 
    gnc_window_adjust_for_screen (GTK_WINDOW(aw->dialog));
 
    aw->component_id = gnc_register_gui_component (DIALOG_EDIT_ACCOUNT_CM_CLASS,
                                                   refresh_handler,
                                                   close_handler, aw);
 
    gnc_gui_component_set_session (aw->component_id, gnc_get_current_session ());
    gnc_gui_component_watch_entity_type (aw->component_id,
                                         GNC_ID_ACCOUNT,
                                         QOF_EVENT_MODIFY | QOF_EVENT_DESTROY);
 
    gtk_window_present (GTK_WINDOW(aw->dialog));
}

gnc_ui_new_account_window()

void gnc_ui_new_account_window	(	GtkWindow *	parent,
		QofBook *	book,
		Account *	parent_acct
	)

Display a window for creating a new account.

This function will also initially set the parent account of the new account to what the caller specified. The user is free, however, to choose any parent account they wish.

Parameters

parent	The widget on which to parent the dialog.
book	The book in which the new account should be created. This is a required argument.
parent_acct	The initially selected parent account. This argument is optional, but if supplied must be an account contained in the specified book.

Definition at line 2178 of file dialog-account.c.

{
    g_return_if_fail(book != NULL);
    if (parent_acct && book)
        g_return_if_fail(gnc_account_get_book (parent_acct) == book);
 
    gnc_ui_new_account_window_internal (parent, book, parent_acct, NULL, NULL,
                                        NULL, FALSE);
}

gnc_ui_new_account_with_types()

void gnc_ui_new_account_with_types	(	GtkWindow *	parent,
		QofBook *	book,
		GList *	valid_types
	)

Display a window for creating a new account.

This function will restrict the available account type values to the list specified by the caller.

Parameters

parent	The widget on which to parent the dialog.
book	The book in which the new account should be created. This is a required argument.
valid_types	A GList of GNCAccountType gints [as pointers] which are allowed to be created. The calling function is responsible for freeing this list.

gnc_ui_new_account_with_types_and_commodity()

void gnc_ui_new_account_with_types_and_commodity	(	GtkWindow *	parent,
		QofBook *	book,
		GList *	valid_types,
		gnc_commodity *	default_commodity
	)

Display a window for creating a new account.

This function will restrict the available account type values to the list specified by the caller.

Parameters

parent	The widget on which to parent the dialog.
book	The book in which the new account should be created. This is a required argument.
valid_types	A GList of GNCAccountType gints [as pointers] which are allowed to be created. The calling function is responsible for freeing this list.
default_commodity	A gnc_commodity* to specify the default commodity to create. May be NULL.

Definition at line 2164 of file dialog-account.c.

{
    gnc_ui_new_account_window_internal (parent, book, NULL, NULL,
                                        valid_types, default_commodity, FALSE);
}

gnc_ui_new_accounts_from_name_window()

Account * gnc_ui_new_accounts_from_name_window	(	GtkWindow *	parent,
		const char *	name
	)

Display a modal window for creating a new account.

Parameters

parent	The widget on which to parent the dialog.
name	The account name/path to be created. This parameter is not used for determining the initially selected parent account.

Definition at line 2008 of file dialog-account.c.

{
    return  gnc_ui_new_accounts_from_name_with_defaults (parent, name, NULL,
                                                         NULL, NULL);
}

gnc_ui_new_accounts_from_name_with_defaults()

Account * gnc_ui_new_accounts_from_name_with_defaults	(	GtkWindow *	parent,
		const char *	name,
		GList *	valid_types,
		const gnc_commodity *	default_commodity,
		Account *	parent_acct
	)

Display a modal window for creating a new account.

This function will restrict the available account type values to the list specified by the caller.

Parameters

parent	The widget on which to parent the dialog.
name	The account name/path to be created. This parameter is not used for determining the initially selected parent account.
valid_types	A GList of GNCAccountType gints [as pointers] which are allowed to be created. The calling function is responsible for freeing this list.
default_commodity	The commodity to initially select when the dialog is presented.
parent_acct	The initially selected parent account.

Returns

A pointer to the newly created account.

Definition at line 2015 of file dialog-account.c.

{
    QofBook *book;
    AccountWindow *aw;
    Account *base_account = NULL;
    Account *created_account = NULL;
    gchar ** subaccount_names;
    gint response;
    gboolean done = FALSE;
 
    ENTER("name %s, valid %p, commodity %p, account %p",
          name, valid_types, default_commodity, parent_acct);
    book = gnc_get_current_book ();
    if (!name || *name == '\0')
    {
        subaccount_names = NULL;
        base_account = NULL;
    }
    else
        subaccount_names = gnc_split_account_name (book, name, &base_account);
 
    if (parent_acct != NULL)
    {
        base_account = parent_acct;
    }
    aw = gnc_ui_new_account_window_internal (parent, book, base_account,
                                             subaccount_names,
                                             valid_types,
                                             default_commodity,
                                             TRUE);
 
    while (!done)
    {
        response = gtk_dialog_run (GTK_DIALOG(aw->dialog));
 
        /* This can destroy the dialog */
        gnc_account_window_response_cb (GTK_DIALOG(aw->dialog), response, (gpointer)aw);
 
        switch (response)
        {
        case GTK_RESPONSE_OK:
            created_account = aw->created_account;
            done = (created_account != NULL);
            break;
 
        case GTK_RESPONSE_HELP:
            done = FALSE;
            break;
 
        default:
            done = TRUE;
            break;
        }
    }
 
    close_handler (aw);
    LEAVE("created %s (%p)", xaccAccountGetName (created_account), created_account);
    return created_account;
}

gnc_ui_register_account_destroy_callback()

void gnc_ui_register_account_destroy_callback

(

void(*)(Account *)

cb

)

Definition at line 2200 of file dialog-account.c.

{
    if (!cb)
        return;
 
    if (g_list_index (ac_destroy_cb_list, cb) == -1)
        ac_destroy_cb_list = g_list_append (ac_destroy_cb_list, cb);
 
    return;
}