qubes-installer-qubes-os/anaconda/widgets/src/HubWindow.c
2013-01-24 01:45:53 +01:00

150 lines
5.5 KiB
C

/*
* Copyright (C) 2011 Red Hat, Inc.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* Author: Chris Lumens <clumens@redhat.com>
*/
#include "BaseWindow.h"
#include "HubWindow.h"
#include "intl.h"
/**
* SECTION: HubWindow
* @title: AnacondaHubWindow
* @short_description: Window for displaying a Hub
*
* A #AnacondaHubWindow is a top-level window that displays a hub on the
* entire screen. A Hub allows selection of multiple configuration spokes
* from a single interface, as well as a place to display current configuration
* selections.
*
* The window consists of three areas:
*
* - A navigation area in the top of the screen, inherited from #AnacondaBaseWindow.
*
* - A selection area in the middle of the screen, taking up a majority of the space.
* This is where spokes will be displayed and the user can decide what to do.
*
* - An action area on the bottom of the screen. This area is different for
* different kinds of hubs. It may have buttons, or it may have progress
* information.
*
* <refsect2 id="AnacondaHubWindow-BUILDER-UI"><title>AnacondaHubWindow as GtkBuildable</title>
* <para>
* The AnacondaHubWindow implementation of the #GtkBuildable interface exposes
* the @action_area and @scrolled_window as internal children with the names
* "action_area" and "scrolled_window". action_area, in this case, is largely
* there to give a box to contain both the scrolled_window and a #GtkButtonBox.
* </para>
* <example>
* <title>A <structname>AnacondaHubWindow</structname> UI definition fragment.</title>
* <programlisting><![CDATA[
* <object class="AnacondaHubWindow" id="hub1">
* <child internal-child="action_area">
* <object class="GtkVBox" id="vbox1">
* <child internal-child="scrolled_window">
* <object class="GtkScrolledWindow" id="window1">
* <child>...</child>
* </object>
* </child>
* <child>
* <object class="GtkHButtonBox" id="buttonbox1">
* <child>...</child>
* </object>
* </child>
* </object>
* </child>
* </object>
* ]]></programlisting>
* </example>
* </refsect2>
*/
struct _AnacondaHubWindowPrivate {
GtkWidget *scrolled_window;
};
static void anaconda_hub_window_buildable_init(GtkBuildableIface *iface);
G_DEFINE_TYPE_WITH_CODE(AnacondaHubWindow, anaconda_hub_window, ANACONDA_TYPE_BASE_WINDOW,
G_IMPLEMENT_INTERFACE(GTK_TYPE_BUILDABLE, anaconda_hub_window_buildable_init))
static void anaconda_hub_window_class_init(AnacondaHubWindowClass *klass) {
GObjectClass *object_class = G_OBJECT_CLASS(klass);
g_type_class_add_private(object_class, sizeof(AnacondaHubWindowPrivate));
}
/**
* anaconda_hub_window_new:
*
* Creates a new #AnacondaHubWindow, which is a window designed for displaying
* multiple spokes in one location.
*
* Returns: A new #AnacondaHubWindow.
*/
GtkWidget *anaconda_hub_window_new() {
return g_object_new(ANACONDA_TYPE_HUB_WINDOW, NULL);
}
static void anaconda_hub_window_init(AnacondaHubWindow *win) {
GtkWidget *action_area = anaconda_base_window_get_action_area(ANACONDA_BASE_WINDOW(win));
win->priv = G_TYPE_INSTANCE_GET_PRIVATE(win,
ANACONDA_TYPE_HUB_WINDOW,
AnacondaHubWindowPrivate);
win->priv->scrolled_window = gtk_scrolled_window_new(NULL, NULL);
gtk_scrolled_window_set_policy(GTK_SCROLLED_WINDOW(win->priv->scrolled_window),
GTK_POLICY_NEVER, GTK_POLICY_AUTOMATIC);
gtk_box_pack_start(GTK_BOX(action_area), win->priv->scrolled_window, TRUE, TRUE, 0);
/* The hub has different alignment requirements than a spoke. */
gtk_alignment_set(GTK_ALIGNMENT(anaconda_base_window_get_alignment(ANACONDA_BASE_WINDOW(win))),
0.5, 0.0, 0.5, 1.0);
}
/**
* anaconda_hub_window_get_spoke_area:
* @win: a #AnacondaHubWindow
*
* Returns the scrolled window of @win where spokes may be displayed
*
* Returns: (transfer none): The spoke area
*
* Since: 1.0
*/
GtkWidget *anaconda_hub_window_get_spoke_area(AnacondaHubWindow *win) {
return win->priv->scrolled_window;
}
static GtkBuildableIface *parent_buildable_iface;
static GObject *
anaconda_hub_window_buildable_get_internal_child (GtkBuildable *buildable,
GtkBuilder *builder,
const gchar *childname) {
if (strcmp (childname, "scrolled_window") == 0)
return G_OBJECT(anaconda_hub_window_get_spoke_area(ANACONDA_HUB_WINDOW(buildable)));
return parent_buildable_iface->get_internal_child (buildable, builder, childname);
}
static void anaconda_hub_window_buildable_init (GtkBuildableIface *iface) {
parent_buildable_iface = g_type_interface_peek_parent (iface);
iface->get_internal_child = anaconda_hub_window_buildable_get_internal_child;
}