gtk2/gtk/gtkvscrollbar.c

82 lines
2.6 KiB
C

/* GTK - The GIMP Toolkit
* Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
* Copyright (C) 2001 Red Hat, Inc.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
/*
* Modified by the GTK+ Team and others 1997-2000. See the AUTHORS
* file for a list of people on the GTK+ Team. See the ChangeLog
* files for a list of changes. These files are distributed with
* GTK+ at ftp://ftp.gtk.org/pub/gtk/.
*/
#include "config.h"
#include "gtkorientable.h"
#include "gtkvscrollbar.h"
#include "gtkintl.h"
/**
* SECTION:gtkvscrollbar
* @Short_description: A vertical scrollbar
* @Title: GtkVScrollbar
* @See_also:#GtkScrollbar, #GtkScrolledWindow
*
* The #GtkVScrollbar widget is a widget arranged vertically creating a
* scrollbar. See #GtkScrollbar for details on
* scrollbars. #GtkAdjustment pointers may be added to handle the
* adjustment of the scrollbar or it may be left %NULL in which case one
* will be created for you. See #GtkScrollbar for a description of what the
* fields in an adjustment represent for a scrollbar.
*/
G_DEFINE_TYPE (GtkVScrollbar, gtk_vscrollbar, GTK_TYPE_SCROLLBAR)
static void
gtk_vscrollbar_class_init (GtkVScrollbarClass *class)
{
GTK_RANGE_CLASS (class)->stepper_detail = "vscrollbar";
}
static void
gtk_vscrollbar_init (GtkVScrollbar *vscrollbar)
{
gtk_orientable_set_orientation (GTK_ORIENTABLE (vscrollbar),
GTK_ORIENTATION_VERTICAL);
}
/**
* gtk_vscrollbar_new:
* @adjustment: (allow-none): the #GtkAdjustment to use, or %NULL to create a new adjustment
*
* Creates a new vertical scrollbar.
*
* Returns: the new #GtkVScrollbar
*/
GtkWidget *
gtk_vscrollbar_new (GtkAdjustment *adjustment)
{
g_return_val_if_fail (adjustment == NULL || GTK_IS_ADJUSTMENT (adjustment),
NULL);
return g_object_new (GTK_TYPE_VSCROLLBAR,
"adjustment", adjustment,
NULL);
}