contentLister/src/gtkDistListWnd.c File Reference

#include <gtk/gtk.h>
#include <liberdm/display.h>
#include <libergtk/ergtk.h>
#include <libermanifest/ermanifest.h>
#include "contentListerLog.h"
#include "displayUpdate.h"
#include "erbusy.h"
#include "erConnect.h"
#include "system.h"
#include "gtkPincodeScreen.h"
#include "control.h"
#include "erMdsContent.h"
#include "gtkDistListWnd.h"
#include "pagebar.h"
#include "languages.h"

Go to the source code of this file.

Functions
static void	dist_list_wnd_create_notebook (void)
static void	dist_list_wnd_notebook_append_page (void)
static void	dist_list_wnd_update_pagebar (void)
static void	on_switch_page (GtkNotebook *notebook, GtkNotebookPage *new_page, guint page_num, gpointer data)
static void	on_selection_update (erGtkSelectionGroup *item, gpointer user_data)
void	create_dist_list_wnd (GtkWidget *parent)
void	dist_list_wnd_clear (void)
erGtkSelectionGroup *	dist_list_wnd_add_list (const gchar *display_as, const gchar *title, const gchar *instruction, const gchar **item_tbl)
void	dist_list_wnd_page_forward (guint offset)
void	dist_list_wnd_page_back (guint offset)
gboolean	dist_list_wnd_is_visible (void)
void	dist_list_wnd_goto_page (gint new_page)
Variables
static GtkWidget *	g_parent_widget = NULL
static GtkWidget *	g_notebook = NULL
static GtkWidget *	g_lastpage_vbox = NULL
static guint	g_lastpage_height = 0

---

Function Documentation

void create_dist_list_wnd

(

GtkWidget *

parent

)

Create an empty distribution list window

Parameters:

parent

- gtk event box on which to append the distribution list window

Returns:

--

Definition at line 69 of file gtkDistListWnd.c.

{
    CL_LOGPRINTF("entry");

    g_parent_widget = parent;
    dist_list_wnd_create_notebook();
}

Here is the call graph for this function:

erGtkSelectionGroup* dist_list_wnd_add_list	(	const gchar *	display_as,
		const gchar *	title,
		const gchar *	instruction,
		const gchar **	item_tbl
	)

Append a selection list to the distribution list window

Parameters:

	display_as	- specifies how to display the item list
	title	- text to appear in title bar
	instruction	- text to appear above list of items
	item_tbl	- array of items to be displayed

Returns:

erGtkSelectionGroup object for this list

Definition at line 88 of file gtkDistListWnd.c.

{
    CL_LOGPRINTF("entry: title [%s]", title);

    GtkWidget*    list          = NULL;
    GtkWidget*    master_list   = NULL;
    GtkWidget*    lastpage_vbox = g_lastpage_vbox;
    guint         list_height   = 0;
    guint         list_items    = 0;
    guint         next_item     = 0;
    guint         available_height;

    // determine display_as for selection list
    erGtkSelectionList_displayAs_e list_display_as;
    if (strcmp(display_as, "radiobutton") == 0)
    {
        list_display_as = esl_RadioButton;
    }
    else if (strcmp(display_as, "textbutton") == 0)
    {
        list_display_as = esl_TextButton;
    }
    else
    {
        list_display_as = esl_Checklist;
    }

    // calculate space available for selection list
    if (lastpage_vbox == NULL)
    {
        available_height = DIST_LIST_WND_HEIGHT_SMALL;
    }
    else
    {
        if (gtk_notebook_get_n_pages(GTK_NOTEBOOK(g_notebook)) <= 1)
        {
            available_height = DIST_LIST_WND_HEIGHT_SMALL;
        }
        else
        {
            available_height = DIST_LIST_WND_HEIGHT_BIG;
        }
        available_height = available_height - g_lastpage_height - DIST_LIST_WND_V_SPACING;
    }

    // create selection list
    list = ergtk_selection_list_new( list_display_as,
                                     title,
                                     instruction,
                                     item_tbl,
                                     available_height,
                                     &list_items,
                                     &list_height );
    if (list == NULL)
    {
        // list cannot start on current page
        lastpage_vbox    = NULL;
        available_height = DIST_LIST_WND_HEIGHT_BIG;
        list = ergtk_selection_list_new( list_display_as,
                                         title,
                                         instruction,
                                         item_tbl,
                                         available_height,
                                         &list_items,
                                         &list_height );
    }

    // add list to notebook, continue on next pages when needed
    master_list = list;
    while (list)
    {
        g_signal_connect(G_OBJECT(list), "selection-update", G_CALLBACK(on_selection_update), NULL);
        
        // add selection list to notebook
        if (lastpage_vbox == NULL)
        {
            dist_list_wnd_notebook_append_page();
            lastpage_vbox = g_lastpage_vbox;

            g_lastpage_height += list_height;
        }
        else
        {
            g_lastpage_height += DIST_LIST_WND_V_SPACING + list_height;
        }
        gtk_box_pack_start(GTK_BOX(lastpage_vbox), list, FALSE, FALSE, 0);
        next_item += list_items;

        // create additional selection list, if needed
        if (item_tbl[next_item] == NULL)
        {
            // all items done, no continuation list needed
            list = NULL;
        }
        else
        {
            // item(s) left, start continuation list on new page
            lastpage_vbox    = NULL;
            available_height = DIST_LIST_WND_HEIGHT_BIG;
            
            list = ergtk_selection_list_new_from_master( ERGTK_SELECTION_LIST(master_list),
                                                         next_item,
                                                         available_height,
                                                         &list_items,
                                                         &list_height );
        }
    }

    return ERGTK_SELECTION_GROUP(master_list);
}

Here is the call graph for this function:

void dist_list_wnd_clear

(

void

)

Clear the distribution window, i.e. remove all selection lists from it

Parameters:

--

Returns:

--

Definition at line 77 of file gtkDistListWnd.c.

{
    CL_LOGPRINTF("entry: g_notebook [%p]", g_notebook);

    if (g_notebook)
    {
        gtk_widget_destroy(g_notebook);
        dist_list_wnd_create_notebook();
    }
}

Here is the call graph for this function:

static void dist_list_wnd_create_notebook

(

void

)

[static]

Definition at line 267 of file gtkDistListWnd.c.

{
    GtkWidget *widget;

    if (g_parent_widget)
    {
        // g_parent_widget
        //   |-- g_notebook (GtkNotebook)
        //         |
        widget = gtk_notebook_new();
        gtk_widget_set_size_request(widget, DIST_LIST_WND_WIDTH, -1);
        gtk_notebook_set_show_tabs(GTK_NOTEBOOK(widget), FALSE);
        gtk_notebook_set_show_border(GTK_NOTEBOOK(widget), FALSE);
        g_signal_connect_after(widget, "switch-page",   G_CALLBACK(on_switch_page), NULL);
        g_signal_connect_after(widget, "destroy-event", G_CALLBACK(gtk_widget_destroyed), &g_notebook);
        gtk_container_add(GTK_CONTAINER(g_parent_widget), widget);
        gtk_widget_show(widget);
        g_notebook = widget;

        // no selection lists yet
        g_lastpage_vbox   = NULL;
        g_lastpage_height = 0;
    }
}

Here is the call graph for this function:

void dist_list_wnd_goto_page

(

gint

page

)

Show specified page of distribution list window

Parameters:

page

- pagenumber (1 ..) to display

Returns:

--

Definition at line 308 of file gtkDistListWnd.c.

{
    gint old_page;

    if (g_notebook)
    {
        old_page = gtk_notebook_get_current_page(GTK_NOTEBOOK(g_notebook));
        new_page--;  // notebook counts 0 ..

        if (new_page != old_page)
        {
            gtk_notebook_set_current_page(GTK_NOTEBOOK(g_notebook), new_page);
        }
        else
        {
            dist_list_wnd_update_pagebar();
        }
    }
}

Here is the call graph for this function:

gboolean dist_list_wnd_is_visible

(

void

)

Tell whether distribution list window is visible

Parameters:

--

Returns:

TRUE/FALSE - window visible / not visible

Definition at line 253 of file gtkDistListWnd.c.

{
    if (g_parent_widget  &&  GTK_WIDGET_VISIBLE(g_parent_widget))
    {
        return TRUE;
    }
    else
    {
        return FALSE;
    }
}

static void dist_list_wnd_notebook_append_page

(

void

)

[static]

Definition at line 292 of file gtkDistListWnd.c.

{
    GtkWidget *widget;

    // g_notebook (GtkNotebook)
    //   |-- g_lastpage_vbox (one for each page)
    //         |-- ...
    widget = gtk_vbox_new(FALSE, DIST_LIST_WND_V_SPACING);
    gtk_widget_show(widget);  // Note: MUST show widget before appending to notebook
    gtk_notebook_append_page(GTK_NOTEBOOK(g_notebook), widget, NULL);
    g_lastpage_vbox = widget;

    // no selection lists yet
    g_lastpage_height = 0;
}

void dist_list_wnd_page_back

(

guint

offset

)

Definition at line 228 of file gtkDistListWnd.c.

{
    gint first_page = 0;
    gint old_page;
    gint new_page;

    if (g_notebook)
    {
        old_page = gtk_notebook_get_current_page(GTK_NOTEBOOK(g_notebook));
        if (old_page > first_page)
        {
            new_page = old_page - offset;
            if (new_page < first_page)
            {
                new_page = first_page;
            }
            gtk_notebook_set_current_page(GTK_NOTEBOOK(g_notebook), new_page);
        }
        else
        {
            erbusy_off();
        }
    }
}

Here is the call graph for this function:

void dist_list_wnd_page_forward

(

guint

offset

)

Goto next page / previous page

Parameters:

--

Returns:

--

Definition at line 202 of file gtkDistListWnd.c.

{
    gint last_page;
    gint old_page;
    gint new_page;

    if (g_notebook)
    {
        last_page = gtk_notebook_get_n_pages(GTK_NOTEBOOK(g_notebook)) - 1;
        old_page  = gtk_notebook_get_current_page(GTK_NOTEBOOK(g_notebook));
        if (old_page < last_page)
        {
            new_page = old_page + offset;
            if (new_page > last_page)
            {
                new_page = last_page;
            }
            gtk_notebook_set_current_page(GTK_NOTEBOOK(g_notebook), new_page);
        }
        else
        {
            erbusy_off();
        }
    }
}

Here is the call graph for this function:

static void dist_list_wnd_update_pagebar

(

void

)

[static]

Definition at line 328 of file gtkDistListWnd.c.

{
    const gint current_page = gtk_notebook_get_current_page(GTK_NOTEBOOK(g_notebook));
    const gint num_pages    = gtk_notebook_get_n_pages(GTK_NOTEBOOK(g_notebook));

    CL_LOGPRINTF("entry: page [%d] num_pages [%d]", current_page, num_pages);

    pagebar_reset();   // send pageBar events to us
    pagebar_set_pagecount(num_pages);
    pagebar_goto_page(current_page + 1);  // pagebar counts from 1
    pagebar_redraw();
}

Here is the call graph for this function:

static void on_selection_update	(	erGtkSelectionGroup *	item,
		gpointer	user_data
	)			[static]

Definition at line 361 of file gtkDistListWnd.c.

{
    CL_LOGPRINTF("entry");

    display_update_request_screen_refresh(TEXTENTRY_CHANGED_LEVEL);
}

Here is the call graph for this function:

static void on_switch_page	(	GtkNotebook *	notebook,
		GtkNotebookPage *	new_page,
		guint	page_num,
		gpointer	data
	)			[static]

Definition at line 343 of file gtkDistListWnd.c.

{
    CL_LOGPRINTF("entry: new_page [%d]", (int)page_num);

    dist_list_wnd_update_pagebar();

    if (page_num == 0)
    {
        ctrl_show_lister_area();
    }
    else
    {
        ctrl_hide_lister_area();
    }

    display_update_request_screen_refresh(LISTER_EXPOSE_LEVEL);
}

Here is the call graph for this function:

---

Variable Documentation

guint g_lastpage_height = 0 [static]

Definition at line 56 of file gtkDistListWnd.c.

GtkWidget* g_lastpage_vbox = NULL [static]

Definition at line 55 of file gtkDistListWnd.c.

GtkWidget* g_notebook = NULL [static]

Definition at line 54 of file gtkDistListWnd.c.

GtkWidget* g_parent_widget = NULL [static]

Definition at line 53 of file gtkDistListWnd.c.