NAME

Gtk2::Ex::ComboBoxBits -- misc Gtk2::ComboBox helpers

SYNOPSIS

 use Gtk2::Ex::ComboBoxBits;

FUNCTIONS

Gtk2::Ex::ComboBoxBits::set_active_path ($combobox, $path)

Set the active item in $combobox to the given Gtk2::TreePath position. If $path is empty or undef or there's no such row in the model then $combobox is set to nothing active.

If there's no model in $combobox then a toplevel path is remembered ready for a model set later, the same as the native set_active. But sub-rows don't enjoy the same remembering.

$str = Gtk2::Ex::ComboBoxBits::set_active_text ($combobox, $str)

$combobox must be a simplified "text" type ComboBox. Set the entry $str active.

(As of Gtk 2.20 ComboBox has a get_active_text, but no set_active_text nor a corresponding property.)

$iter = Gtk2::Ex::ComboBoxBits::find_text_iter ($combobox, $str)

Return a Gtk2::TreeIter which is the row for $str in a text style combobox. If $str is not in $combobox then return undef.

EXPORTS

Nothing is exported by default, but the functions can be requested in usual Exporter style,

    use Gtk2::Ex::ComboBoxBits 'set_active_text';

This can be handy if using set_active_text many times. Gtk2::Ex::ComboBox::Text imports it to use as an object method.

There's no :all tag since this module is meant as a grab-bag of functions and to import as-yet unknown things would be asking for name clashes.

HOME PAGE

http://user42.tuxfamily.org/gtk2-ex-comboboxbits/index.html

LICENSE

Copyright 2010, 2011 Kevin Ryde

Gtk2-Ex-ComboBoxBits 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 3, or (at your option) any later version.

Gtk2-Ex-ComboBoxBits 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 Gtk2-Ex-ComboBoxBits. If not, see http://www.gnu.org/licenses/.