comboboxentrytext.h

Go to the documentation of this file.

// -*- c++ -*-
#ifndef _GTKMM_COMBOBOXENTRYTEXT_H
#define _GTKMM_COMBOBOXENTRYTEXT_H
 
/* comboboxentrytext.h
 * 
 * Copyright (C) 2003 The gtkmm Development Team
 *
 * 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.1 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., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
#ifndef GTKMM_DISABLE_DEPRECATED
 
#include <gtkmm/comboboxentry.h>
 
namespace Gtk
{
 
//This is a C++ convenience class that is equivalent to the gtk_combo_box_entry_new_text() C convenience function.
//This is copy/paste/search/replaced from ComboBoxText, but the only alternative I see is to use multiple inheritance.
//murrayc.
//In gtkmm-3.0 we simply wrap GtkComboBoxText, which is also in GTK+ 2.24.
//But this C++ class was created before GtkComboBoxText existed and we want to avoid changing the ABI. 
 
class ComboBoxEntryText
: public ComboBoxEntry
{
#ifndef DOXYGEN_SHOULD_SKIP_THIS
private:
  // noncopyable
  ComboBoxEntryText(const ComboBoxEntryText&);
  ComboBoxEntryText& operator=(const ComboBoxEntryText&);
 
protected:
  explicit ComboBoxEntryText(const Glib::ConstructParams& construct_params);
  explicit ComboBoxEntryText(GtkComboBoxEntry* castitem);
 
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
 
public:
  ComboBoxEntryText();
 
  void append(const Glib::ustring& text);
 
  void insert(int position, const Glib::ustring& text);
 
  void prepend(const Glib::ustring& text);
 
#ifndef GTKMM_DISABLE_DEPRECATED
  void append_text(const Glib::ustring& text);
 
  void insert_text(int position, const Glib::ustring& text);
 
  void prepend_text(const Glib::ustring& text);
#endif //GTKMM_DISABLE_DEPRECATED
 
  //@deprecated Use get_entry()->get_text() to get the actual entered text.
  Glib::ustring get_active_text() const;
 
  //@deprecated Use get_entry()->set_text() to set the actual entered text.
  void set_active_text(const Glib::ustring& text);
 
  //There is a clear() method in the CellLayout base class, so this would cause confusion.
  //TODO: Remove this when we can break API.
  void clear();
 
  void clear_items();
 
  void remove_text(const Glib::ustring& text);
 
protected:
 
  //Tree model columns:
  //These columns are used by the model that is created by the default constructor
  class TextModelColumns : public Gtk::TreeModel::ColumnRecord
  {
  public:
    TextModelColumns()
    { add(m_column); }
 
    Gtk::TreeModelColumn<Glib::ustring> m_column;
  };
 
  TextModelColumns m_text_columns;
};
 
 
} // namespace Gtk
 
#endif //GTKMM_DISABLE_DEPRECATED
 
#endif /* _GTKMM_COMBOBOXENTRYTEXT_H */