<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gtkvbuttonbox">
  <refnamediv>
    <refname>gtk.VButtonBox</refname>
    <refpurpose>a container for arranging buttons vertically.</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <classsynopsis language="python">
      <ooclass><classname>gtk.VButtonBox</classname></ooclass>
      <ooclass><classname><link
linkend="class-gtkbuttonbox">gtk.ButtonBox</link></classname></ooclass>
      <constructorsynopsis language="python">
	<methodname><link
linkend="constructor-gtkvbuttonbox">gtk.VButtonBox</link></methodname>
	<methodparam></methodparam>  </constructorsynopsis>
    </classsynopsis>

  </refsect1>

  <refsect1>
    <title>Ancestry</title>

<synopsis>+-- <link linkend="class-gobject">gobject.GObject</link>
  +-- <link linkend="class-gtkobject">gtk.Object</link>
    +-- <link linkend="class-gtkwidget">gtk.Widget</link>
      +-- <link linkend="class-gtkcontainer">gtk.Container</link>
        +-- <link linkend="class-gtkbox">gtk.Box</link>
          +-- <link linkend="class-gtkbuttonbox">gtk.ButtonBox</link>
            +-- <link linkend="class-gtkvbuttonbox">gtk.VButtonBox</link>
</synopsis>

  </refsect1>
  
  <refsect1>
		<title>Implemented Interfaces</title>
		<para>
			<link linkend="class-gtkvbuttonbox"><classname>gtk.VButtonBox</classname></link>
			implements 
			<link linkend="class-gtkbuildable"><classname>gtk.Buildable</classname></link>
		</para>
	</refsect1>

  <refsect1 id="properties-gtkvbuttonbox">
    <title>gtk.VButtonBox Properties</title>

    <para><link linkend="properties-gtkobject">gtk.Object Properties</link></para>
    <para><link linkend="properties-gtkwidget">gtk.Widget Properties</link></para>
    <para><link linkend="properties-gtkcontainer">gtk.Container Properties</link></para>
    <para><link linkend="properties-gtkbox">gtk.Box Properties</link></para>
    <para><link linkend="properties-gtkbuttonbox">gtk.ButtonBox Properties</link></para>

  </refsect1>

  <refsect1 id="style-properties-gtkvbuttonbox">
    <title>gtk.VButtonBox Style Properties</title>

    <para><link linkend="style-properties-gtkwidget">gtk.Widget Style Properties</link></para>
    <para><link linkend="style-properties-gtkbuttonbox">gtk.ButtonBox Style Properties</link></para>

  </refsect1>

  <refsect1 id="child-properties-gtkvbuttonbox">
    <title>gtk.VButtonBox Child Properties</title>

    <para><link linkend="child-properties-gtkbox">gtk.Box Child Properties</link></para>
    <para><link linkend="child-properties-gtkbuttonbox">gtk.ButtonBox Child Properties</link></para>

  </refsect1>

  <refsect1 id="signal-prototypes-gtkvbuttonbox">
    <title>gtk.VButtonBox Signal Prototypes</title>

    <para><link linkend="signal-prototypes-gobject">gobject.GObject Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkobject">gtk.Object Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkwidget">gtk.Widget Signal Prototypes</link></para>
    <para><link linkend="signal-prototypes-gtkcontainer">gtk.Container Signal Prototypes</link></para>
  </refsect1>

  <refsect1>
    <title>Description</title>

    <para>A <link
linkend="class-gtkvbuttonbox"><classname>gtk.VButtonBox</classname></link>
is a container subclassed from <link
linkend="class-gtkbuttonbox"><classname>gtk.ButtonBox</classname></link>
that is optimized for the vertical layout of buttons. The <link
linkend="class-gtkvbuttonbox"><classname>gtk.VButtonBox</classname></link>
helps provide a consistent layout of buttons in an application by supplying
default values of spacing, padding and layout style (see the <link
linkend="class-gtkbuttonbox"><classname>gtk.ButtonBox</classname></link>
reference for more detail). Buttons are packed into a <link
linkend="class-gtkvbuttonbox"><classname>gtk.VButtonBox</classname></link>
using the <link
linkend="method-gtkcontainer--add"><methodname>gtk.Container.add</methodname>()</link>)
method. The <link
linkend="method-gtkbox--pack-start"><methodname>pack_start</methodname>()</link>
and <link
linkend="method-gtkbox--pack-end"><methodname>pack_end</methodname>()</link>
methods can also be used but they work just like the <link
linkend="method-gtkcontainer--add"><methodname>gtk.Container.add</methodname>()</link>)
method i.e. they pack the button in a way that depends on the current layout
style and on whether the button has had the <link
linkend="method-gtkbuttonbox--set-child-secondary"><methodname>gtk.ButtonBox.set_child_secondary</methodname>()</link>
method called on it. The spacing between buttons can be set with the <link
linkend="method-gtkbox--set-spacing"><methodname>gtk.Box.set_spacing</methodname>()</link>
method. The arrangement and layout of the buttons can be changed with the
<link
linkend="method-gtkbuttonbox--set-layout"><methodname>gtk.ButtonBox.set_layout</methodname>()</link>
method.</para>

  </refsect1>

  <refsect1 id="constructor-gtkvbuttonbox">
    <title>Constructor</title>

    <programlisting><constructorsynopsis language="python">
	<methodname>gtk.VButtonBox</methodname>
	<methodparam></methodparam>  </constructorsynopsis></programlisting>
    <variablelist>
      <varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
	<listitem><simpara>a new <link
linkend="class-gtkvbuttonbox"><classname>gtk.VButtonBox</classname></link>
widget</simpara></listitem>
      </varlistentry>
    </variablelist>

    <para>Creates a new <link
linkend="class-gtkvbuttonbox"><classname>gtk.VButtonBox</classname></link>
widget</para>

  </refsect1>

</refentry>
