<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Graphics.UI.Gtk.ModelView.CellRendererCombo</title><link href="ocean.css" rel="stylesheet" type="text/css" title="Ocean" /><script src="haddock-util.js" type="text/javascript"></script><script type="text/javascript">//<![CDATA[ window.onload = function () {pageLoad();setSynopsis("mini_Graphics-UI-Gtk-ModelView-CellRendererCombo.html");}; //]]> </script></head><body><div id="package-header"><ul class="links" id="page-menu"><li><a href="src/Graphics-UI-Gtk-ModelView-CellRendererCombo.html">Source</a></li><li><a href="index.html">Contents</a></li><li><a href="doc-index.html">Index</a></li></ul><p class="caption">gtk-0.12.0: Binding to the Gtk+ graphical user interface library.</p></div><div id="content"><div id="module-header"><table class="info"><tr><th>Portability</th><td>portable (depends on GHC)</td></tr><tr><th>Stability</th><td>provisional</td></tr><tr><th>Maintainer</th><td>gtk2hs-users@lists.sourceforge.net</td></tr></table><p class="caption">Graphics.UI.Gtk.ModelView.CellRendererCombo</p></div><div id="table-of-contents"><p class="caption">Contents</p><ul><li><a href="#g:1">Detail </a></li><li><a href="#g:2">Class Hierarchy </a></li><li><a href="#g:3">Types </a></li><li><a href="#g:4">Constructors </a></li><li><a href="#g:5">Attributes </a></li></ul></div><div id="description"><p class="caption">Description</p><div class="doc"><p>Renders a combo box in a cell </p><ul><li> Module available since Gtk+ version 2.6 </li></ul></div></div><div id="synopsis"><p id="control.syn" class="caption expander" onclick="toggleSection('syn')">Synopsis</p><ul id="section.syn" class="hide" onclick="toggleSection('syn')"><li class="src short"><span class="keyword">data</span> <a href="#t:CellRendererCombo">CellRendererCombo</a> </li><li class="src short"><span class="keyword">class</span> <a href="Graphics-UI-Gtk-ModelView-CellRendererText.html#t:CellRendererTextClass">CellRendererTextClass</a> o => <a href="#t:CellRendererComboClass">CellRendererComboClass</a> o </li><li class="src short"><a href="#v:castToCellRendererCombo">castToCellRendererCombo</a> :: <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> obj => obj -> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></li><li class="src short"><a href="#v:gTypeCellRendererCombo">gTypeCellRendererCombo</a> :: <a href="Graphics-UI-Gtk-Abstract-Widget.html#t:GType">GType</a></li><li class="src short"><a href="#v:toCellRendererCombo">toCellRendererCombo</a> :: <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererComboClass">CellRendererComboClass</a> o => o -> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></li><li class="src short"><a href="#v:cellRendererComboNew">cellRendererComboNew</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></li><li class="src short"><a href="#v:cellComboHasEntry">cellComboHasEntry</a> :: <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererComboClass">CellRendererComboClass</a> self => <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-Attributes.html#t:Attr">Attr</a> self <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Bool.html#t:Bool">Bool</a></li><li class="src short"><a href="#v:cellComboTextModel">cellComboTextModel</a> :: (<a href="Graphics-UI-Gtk-ModelView-TreeModel.html#t:TreeModelClass">TreeModelClass</a> (model row), <a href="Graphics-UI-Gtk-ModelView-TreeModel.html#t:TypedTreeModelClass">TypedTreeModelClass</a> model, <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererComboClass">CellRendererComboClass</a> self) => <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-Attributes.html#t:WriteAttr">WriteAttr</a> self (model row, <a href="Graphics-UI-Gtk-ModelView-TreeModel.html#t:ColumnId">ColumnId</a> row <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a>)</li></ul></div><div id="interface"><h1 id="g:1">Detail </h1><div class="doc"><p><code><a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></code> renders text in a cell like <code>Graphics.UI.Gtk.ModelView.CellRendererText</code> from which it is derived. But while <code>Graphics.UI.Gtk.ModelView.CellRendererText</code> offers a simple entry to edit the text, <code><a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></code> offers a <code>Graphics.UI.Gtk.ModelView.ComboBox</code> or <code>Graphics.UI.Gtk.ModelView.ComboBoxEntry</code> widget to edit the text. The values to display in the combo box are taken from the tree model specified in the model property. </p><p>The combo cell renderer takes care of adding a text cell renderer to the combo box and sets it to display the column specified by its <code>cellTextModel</code> property. Further cell renderers can be added in a handler for the <code>Graphics.UI.Gtk.ModelView.CellRenderer.editingStarted</code> signal. </p></div><h1 id="g:2">Class Hierarchy </h1><div class="doc"><pre> | <code><a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObject">GObject</a></code> | +----<code><a href="Graphics-UI-Gtk-Abstract-Object.html#t:Object">Object</a></code> | +----<code><a href="Graphics-UI-Gtk-ModelView-CellRenderer.html#t:CellRenderer">CellRenderer</a></code> | +----<code><a href="Graphics-UI-Gtk-ModelView-CellRendererText.html#t:CellRendererText">CellRendererText</a></code> | +----CellRendererCombo </pre></div><h1 id="g:3">Types </h1><div class="top"><p class="src"><span class="keyword">data</span> <a name="t:CellRendererCombo" class="def">CellRendererCombo</a> <a href="src/Graphics-UI-Gtk-Types.html#CellRendererCombo" class="link">Source</a></p><div class="subs instances"><p id="control.i:CellRendererCombo" class="caption collapser" onclick="toggleSection('i:CellRendererCombo')">Instances</p><div id="section.i:CellRendererCombo" class="show"><table><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Eq.html#t:Eq">Eq</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Ord.html#t:Ord">Ord</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererComboClass">CellRendererComboClass</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-ModelView-CellRendererText.html#t:CellRendererTextClass">CellRendererTextClass</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-ModelView-CellRenderer.html#t:CellRendererClass">CellRendererClass</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></td><td class="doc empty"> </td></tr><tr><td class="src"><a href="Graphics-UI-Gtk-Abstract-Object.html#t:ObjectClass">ObjectClass</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><span class="keyword">class</span> <a href="Graphics-UI-Gtk-ModelView-CellRendererText.html#t:CellRendererTextClass">CellRendererTextClass</a> o => <a name="t:CellRendererComboClass" class="def">CellRendererComboClass</a> o <a href="src/Graphics-UI-Gtk-Types.html#CellRendererComboClass" class="link">Source</a></p><div class="subs instances"><p id="control.i:CellRendererComboClass" class="caption collapser" onclick="toggleSection('i:CellRendererComboClass')">Instances</p><div id="section.i:CellRendererComboClass" class="show"><table><tr><td class="src"><a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererComboClass">CellRendererComboClass</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></td><td class="doc empty"> </td></tr></table></div></div></div><div class="top"><p class="src"><a name="v:castToCellRendererCombo" class="def">castToCellRendererCombo</a> :: <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-GObject.html#t:GObjectClass">GObjectClass</a> obj => obj -> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a><a href="src/Graphics-UI-Gtk-Types.html#castToCellRendererCombo" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:gTypeCellRendererCombo" class="def">gTypeCellRendererCombo</a> :: <a href="Graphics-UI-Gtk-Abstract-Widget.html#t:GType">GType</a><a href="src/Graphics-UI-Gtk-Types.html#gTypeCellRendererCombo" class="link">Source</a></p></div><div class="top"><p class="src"><a name="v:toCellRendererCombo" class="def">toCellRendererCombo</a> :: <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererComboClass">CellRendererComboClass</a> o => o -> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a><a href="src/Graphics-UI-Gtk-Types.html#toCellRendererCombo" class="link">Source</a></p></div><h1 id="g:4">Constructors </h1><div class="top"><p class="src"><a name="v:cellRendererComboNew" class="def">cellRendererComboNew</a> :: <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/System-IO.html#t:IO">IO</a> <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a><a href="src/Graphics-UI-Gtk-ModelView-CellRendererCombo.html#cellRendererComboNew" class="link">Source</a></p><div class="doc"><p>Creates a new <code><a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></code>. This <code>Renderer</code> allows for displaying a fixed set of options the user can choose from. </p></div></div><h1 id="g:5">Attributes </h1><div class="top"><p class="src"><a name="v:cellComboHasEntry" class="def">cellComboHasEntry</a> :: <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererComboClass">CellRendererComboClass</a> self => <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-Attributes.html#t:Attr">Attr</a> self <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Bool.html#t:Bool">Bool</a><a href="src/Graphics-UI-Gtk-ModelView-CellRendererCombo.html#cellComboHasEntry" class="link">Source</a></p><div class="doc"><p>If <code>True</code>, the cell renderer will allow the user to enter values other than the ones in the popup list. </p><p>Default value: <code>True</code> </p></div></div><div class="top"><p class="src"><a name="v:cellComboTextModel" class="def">cellComboTextModel</a> :: (<a href="Graphics-UI-Gtk-ModelView-TreeModel.html#t:TreeModelClass">TreeModelClass</a> (model row), <a href="Graphics-UI-Gtk-ModelView-TreeModel.html#t:TypedTreeModelClass">TypedTreeModelClass</a> model, <a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererComboClass">CellRendererComboClass</a> self) => <a href="/usr/share/doc/ghc/html/libraries/glib-0.12.0/System-Glib-Attributes.html#t:WriteAttr">WriteAttr</a> self (model row, <a href="Graphics-UI-Gtk-ModelView-TreeModel.html#t:ColumnId">ColumnId</a> row <a href="/usr/share/doc/ghc/html/libraries/base-4.3.1.0/Data-Char.html#t:String">String</a>)<a href="src/Graphics-UI-Gtk-ModelView-CellRendererCombo.html#cellComboTextModel" class="link">Source</a></p><div class="doc"><p>The tuple containing a model and a column in this model that determine the possible strings that can be shown in the combo box. Note that this tree model can be a datum in the tree model that is used to populate the view in which the <code><a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></code> is part of. In other words, it is possible that every <code><a href="Graphics-UI-Gtk-ModelView-CellRendererCombo.html#t:CellRendererCombo">CellRendererCombo</a></code> can show a different set of options on each row. </p></div></div></div></div><div id="footer"><p>Produced by <a href="http://www.haskell.org/haddock/">Haddock</a> version 2.9.2</p></div></body></html>