~ubuntu-branches/ubuntu/natty/pygtk/natty-proposed

<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.ColorSelectionDialog</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtkcolorselection.html" title="gtk.ColorSelection"><link rel="next" href="class-gtkcombo.html" title="gtk.Combo"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.ColorSelectionDialog</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkcolorselection.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkcombo.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><a name="class-gtkcolorselectiondialog"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.ColorSelectionDialog</h2><p>gtk.ColorSelectionDialog — a standard dialog for selecting a color.</p></div><div class="refsect1" lang="en"><a name="id3454753"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.ColorSelectionDialog</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkdialog.html" title="gtk.Dialog">gtk.Dialog</a></span></span>):

<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkcolorselectiondialog.html#constructor-gtkcolorselectiondialog" title="Constructor">gtk.ColorSelectionDialog</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcolorselectiondialog.html#method-gtkcolorselectiondialog--get-color-selection" title="gtk.Frame.get_color_selection">get_color_selection</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3454821"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>

<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.ColorSelectionDialog</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtkcolorselection.html" title="gtk.ColorSelection"><link rel="next" href="class-gtkcombo.html" title="gtk.Combo"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.ColorSelectionDialog</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkcolorselection.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkcombo.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.ColorSelectionDialog"><a name="class-gtkcolorselectiondialog"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.ColorSelectionDialog</h2><p>gtk.ColorSelectionDialog — a standard dialog for selecting a color.</p></div><div class="refsect1" title="Synopsis"><a name="id3763921"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.ColorSelectionDialog</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkdialog.html" title="gtk.Dialog">gtk.Dialog</a></span></span>):

<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkcolorselectiondialog.html#constructor-gtkcolorselectiondialog" title="Constructor">gtk.ColorSelectionDialog</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcolorselectiondialog.html#method-gtkcolorselectiondialog--get-color-selection" title="gtk.Frame.get_color_selection">get_color_selection</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3763989"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>

+-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>

+-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>

+-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>

+-- <a class="link" href="class-gtkwindow.html" title="gtk.Window">gtk.Window</a>

+-- <a class="link" href="class-gtkdialog.html" title="gtk.Dialog">gtk.Dialog</a>

+-- <a class="link" href="class-gtkcolorselectiondialog.html" title="gtk.ColorSelectionDialog">gtk.ColorSelectionDialog</a>

</pre></div><div class="refsect1" lang="en"><a name="id3454874"></a><h2>Implemented Interfaces</h2><p>

</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id3764042"></a><h2>Implemented Interfaces</h2><p>

<a class="link" href="class-gtkcolorselectiondialog.html" title="gtk.ColorSelectionDialog"><code class="classname">gtk.ColorSelectionDialog</code></a>

implements

<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>

</p></div><div class="refsect1" lang="en"><a name="properties-gtkcolorselectiondialog"></a><h2>gtk.ColorSelectionDialog Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p><p><a class="link" href="class-gtkwindow.html#properties-gtkwindow" title="gtk.Window Properties">gtk.Window Properties</a></p><p><a class="link" href="class-gtkdialog.html#properties-gtkdialog" title="gtk.Dialog Properties">gtk.Dialog Properties</a></p></div><div class="refsect1" lang="en"><a name="style-properties-gtkcolorselectiondialog"></a><h2>gtk.ColorSelectionDialog Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p><p><a class="link" href="class-gtkdialog.html#style-properties-gtkdialog" title="gtk.Dialog Style Properties">gtk.Dialog Style Properties</a></p></div><div class="refsect1" lang="en"><a name="id3454957"></a><h2>Attributes</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><tr valign="top"><td valign="top">"colorsel"</td><td valign="top">Read</td><td valign="top">The <a class="link" href="class-gtkcolorselection.html" title="gtk.ColorSelection"><code class="classname">gtk.ColorSelection</code></a>

widget contained in the dialog.</td></tr><tr valign="top"><td valign="top">"ok_button"</td><td valign="top">Read</td><td valign="top">The "OK" button contained in the dialog.</td></tr><tr valign="top"><td valign="top">"cancel_button"</td><td valign="top">Read</td><td valign="top">The "Cancel" button contained in the dialog.</td></tr><tr valign="top"><td valign="top">"help_button"</td><td valign="top">Read</td><td valign="top">The "Help" button contained in the dialog.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="signal-prototypes-gtkcolorselectiondialog"></a><h2>gtk.ColorSelectionDialog Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><p><a class="link" href="class-gtkwindow.html#signal-prototypes-gtkwindow" title="gtk.Window Signal Prototypes">gtk.Window Signal Prototypes</a></p><p><a class="link" href="class-gtkdialog.html#signal-prototypes-gtkdialog" title="gtk.Dialog Signal Prototypes">gtk.Dialog Signal Prototypes</a></p></div><div class="refsect1" lang="en"><a name="id3455115"></a><h2>Description</h2><p>The <a class="link" href="class-gtkcolorselectiondialog.html" title="gtk.ColorSelectionDialog"><code class="classname">gtk.ColorSelectionDialog</code></a>

</p></div><div class="refsect1" title="gtk.ColorSelectionDialog Properties"><a name="properties-gtkcolorselectiondialog"></a><h2>gtk.ColorSelectionDialog Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p><p><a class="link" href="class-gtkwindow.html#properties-gtkwindow" title="gtk.Window Properties">gtk.Window Properties</a></p><p><a class="link" href="class-gtkdialog.html#properties-gtkdialog" title="gtk.Dialog Properties">gtk.Dialog Properties</a></p></div><div class="refsect1" title="gtk.ColorSelectionDialog Style Properties"><a name="style-properties-gtkcolorselectiondialog"></a><h2>gtk.ColorSelectionDialog Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p><p><a class="link" href="class-gtkdialog.html#style-properties-gtkdialog" title="gtk.Dialog Style Properties">gtk.Dialog Style Properties</a></p></div><div class="refsect1" title="Attributes"><a name="id3764125"></a><h2>Attributes</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="3.5in"></colgroup><tbody><tr valign="top"><td valign="top">"colorsel"</td><td valign="top">Read</td><td valign="top">The <a class="link" href="class-gtkcolorselection.html" title="gtk.ColorSelection"><code class="classname">gtk.ColorSelection</code></a>

widget contained in the dialog.</td></tr><tr valign="top"><td valign="top">"ok_button"</td><td valign="top">Read</td><td valign="top">The "OK" button contained in the dialog.</td></tr><tr valign="top"><td valign="top">"cancel_button"</td><td valign="top">Read</td><td valign="top">The "Cancel" button contained in the dialog.</td></tr><tr valign="top"><td valign="top">"help_button"</td><td valign="top">Read</td><td valign="top">The "Help" button contained in the dialog.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.ColorSelectionDialog Signal Prototypes"><a name="signal-prototypes-gtkcolorselectiondialog"></a><h2>gtk.ColorSelectionDialog Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><p><a class="link" href="class-gtkwindow.html#signal-prototypes-gtkwindow" title="gtk.Window Signal Prototypes">gtk.Window Signal Prototypes</a></p><p><a class="link" href="class-gtkdialog.html#signal-prototypes-gtkdialog" title="gtk.Dialog Signal Prototypes">gtk.Dialog Signal Prototypes</a></p></div><div class="refsect1" title="Description"><a name="id3764283"></a><h2>Description</h2><p>The <a class="link" href="class-gtkcolorselectiondialog.html" title="gtk.ColorSelectionDialog"><code class="classname">gtk.ColorSelectionDialog</code></a>

provides a standard dialog that allows a user to select a color. The <a class="link" href="class-gtkcolorselectiondialog.html" title="gtk.ColorSelectionDialog"><code class="classname">gtk.ColorSelectionDialog</code></a>

uses an embedded <a class="link" href="class-gtkcolorselection.html" title="gtk.ColorSelection"><code class="classname">gtk.ColorSelection</code></a>

to provide color selection capability.</p><p>Use the attributes (ok_button, cancel_button and help_button) of

the colorselection widget. Connect a handler to its "color-changed" signal

to be notified when the color is changed. The current color can be retrieved

using the <a class="link" href="class-gtkcolorselection.html#method-gtkcolorselection--get-current-color" title="gtk.ColorSelection.get_current_color"><code class="methodname">gtk.ColorSelection.get_current_color</code>()</a>

method.</p></div><div class="refsect1" lang="en"><a name="constructor-gtkcolorselectiondialog"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.ColorSelectionDialog</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>title</code></strong> :</span></p></td><td>a string to be used as the dialog

method.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtkcolorselectiondialog"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.ColorSelectionDialog</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>title</code></strong> :</span></p></td><td>a string to be used as the dialog

title.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new colorselectiondialog</td></tr></tbody></table><p>Creates a new <code class="classname">gtk.ColorSelectionDialog</code>

using the string contained in <em class="parameter"><code>title</code></em> as the text for

the dialog title.</p></div><div class="refsect1" lang="en"><a name="id3455238"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gtkcolorselectiondialog--get-color-selection"></a><h3>gtk.Frame.get_color_selection</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_color_selection</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the embedded <a class="link" href="class-gtkcolorselection.html" title="gtk.ColorSelection">

<code class="classname">gtk.ColorSelection</code></a>.</td></tr></tbody></table><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>

the dialog title.</p></div><div class="refsect1" title="Methods"><a name="id3764406"></a><h2>Methods</h2><div class="refsect2" title="gtk.Frame.get_color_selection"><a name="method-gtkcolorselectiondialog--get-color-selection"></a><h3>gtk.Frame.get_color_selection</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_color_selection</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the embedded <a class="link" href="class-gtkcolorselection.html" title="gtk.ColorSelection">

<code class="classname">gtk.ColorSelection</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>

The <code class="methodname">get_color_selection</code>() method retrieves the

<a class="link" href="class-gtkcolorselection.html" title="gtk.ColorSelection"><code class="classname">gtk.ColorSelection</code></a>

widget embedded in the dialog.

Older »