gtk.ComboBoxText

gtk.ComboBoxText — A simple, text-only combo box (new in PyGTK 2.24)

Synopsis

class gtk.ComboBoxText(gtk.ComboBox):
    gtk.ComboBoxText()

def append_text(text)

def insert_text(position, text)

def prepend_text(text)

def remove(position)

def get_active_text()

      Functions

          def gtk.combo_box_text_new_with_entry()
    

Ancestry

+-- gobject.GObject
  +-- gtk.Object
    +-- gtk.Widget
      +-- gtk.Container
        +-- gtk.Bin
          +-- gtk.ComboBox
            +-- gtk.ComboBoxText

Description

Note

This widget is available in GTK+ 2.24 and PyGTK 2.24 and above.

A gtk.ComboBoxText is a simple variant of gtk.ComboBox that hides the model-view complexity for simple text-only use cases.

Constructor

    gtk.ComboBox()

Returns :

A new gtk.ComboBoxText.

Note

This constructor is available in PyGTK 2.24 and above.

Creates a new gtk.ComboBoxText, which is a gtk.ComboBox just displaying strings.

Methods

gtk.ComboBoxText.append_text

    def append_text(text)

text :

A string.

Note

This method is available in PyGTK 2.24 and above.

The append_text() method appends the string specified by text to the list of strings stored in the combo box gtk.ListStore.

gtk.ComboBoxText.insert_text

    def insert_text(position, text)

position :

A model index where the text should be inserted.

text :

A string.

Note

This method is available in PyGTK 2.24 and above.

The insert_text() method inserts the string specified by text in the combo box gtk.ListStore at the index specified by position.

gtk.ComboBoxText.prepend_text

    def prepend_text(text)

text :

A string.

Note

This method is available in PyGTK 2.24 and above.

The prepend_text() method prepends the string specified by text to the list of strings stored in the gtk.ListStore associated with the combo_box.

gtk.ComboBoxText.remove

    def remove(position)

position :

Index of the item to remove.

Note

This method is available in PyGTK 2.24 and above.

The remove_text() method removes the string at the index specified by position in the associated gtk.ListStore.

gtk.ComboBoxText.get_active_text

    def get_active_text()

Returns :

The currently active text.

Note

This method is available in PyGTK 2.24 and above.

The get_active_text() method returns the currently active string or None if no entry is selected.

Functions

gtk.combo_box_text_new_with_entry

    def gtk.combo_box_text_new_with_entry()

Returns :

A new gtk.ComboBoxText.

Note

This function is available in PyGTK 2.24 and above.

The gtk.combo_box_new_text() function creates a new gtk.ComboBoxText, which is a gtk.ComboBox just displaying strings. The combo box created by this function has an entry.