Class

GtkCellRendererCombo

Description [src]

final class Gtk.CellRendererCombo : Gtk.CellRendererText {
  /* No available fields */
}

Renders a combobox in a cell

GtkCellRendererCombo renders text in a cell like GtkCellRendererText from which it is derived. But while GtkCellRendererText offers a simple entry to edit the text, GtkCellRendererCombo offers a GtkComboBox widget to edit the text. The values to display in the combo box are taken from the tree model specified in the GtkCellRendererCombo:model property.

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 GtkCellRendererCombo:text-column property. Further properties of the combo box can be set in a handler for the GtkCellRenderer::editing-started signal.

Hierarchy

hierarchy this GtkCellRendererCombo ancestor_0 GtkCellRendererText ancestor_0--this ancestor_1 GtkCellRenderer ancestor_1--ancestor_0 ancestor_2 GInitiallyUnowned ancestor_2--ancestor_1 ancestor_3 GObject ancestor_3--ancestor_2

Ancestors

Constructors

gtk_cell_renderer_combo_new

Creates a new GtkCellRendererCombo. Adjust how text is drawn using object properties. Object properties can be set globally (with g_object_set()). Also, with GtkTreeViewColumn, you can bind a property to a value in a GtkTreeModel. For example, you can bind the “text” property on the cell renderer to a string value in the model, thus rendering a different string in each row of the GtkTreeView.

Properties

Gtk.CellRendererCombo:has-entry

If TRUE, the cell renderer will include an entry and allow to enter values other than the ones in the popup list.

Gtk.CellRendererCombo:model

Holds a tree model containing the possible values for the combo box. Use the text_column property to specify the column holding the values.

Gtk.CellRendererCombo:text-column

Specifies the model column which holds the possible values for the combo box.

Properties inherited from GtkCellRendererText (46)
Gtk.CellRendererText:align-set
No description available.
Gtk.CellRendererText:alignment

Specifies how to align the lines of text with respect to each other.

Gtk.CellRendererText:attributes
No description available.
Gtk.CellRendererText:background
No description available.
Gtk.CellRendererText:background-rgba

Background color as a GdkRGBA

Gtk.CellRendererText:background-set
No description available.
Gtk.CellRendererText:editable
No description available.
Gtk.CellRendererText:editable-set
No description available.
Gtk.CellRendererText:ellipsize

Specifies the preferred place to ellipsize the string, if the cell renderer does not have enough room to display the entire string. Setting it to PANGO_ELLIPSIZE_NONE turns off ellipsizing. See the wrap-width property for another way of making the text fit into a given width.

Gtk.CellRendererText:ellipsize-set
No description available.
Gtk.CellRendererText:family
No description available.
Gtk.CellRendererText:family-set
No description available.
Gtk.CellRendererText:font
No description available.
Gtk.CellRendererText:font-desc
No description available.
Gtk.CellRendererText:foreground
No description available.
Gtk.CellRendererText:foreground-rgba

Foreground color as a GdkRGBA

Gtk.CellRendererText:foreground-set
No description available.
Gtk.CellRendererText:language
No description available.
Gtk.CellRendererText:language-set
No description available.
Gtk.CellRendererText:markup
No description available.
Gtk.CellRendererText:max-width-chars

The desired maximum width of the cell, in characters. If this property is set to -1, the width will be calculated automatically.

Gtk.CellRendererText:placeholder-text

The text that will be displayed in the GtkCellRenderer if GtkCellRendererText:editable is TRUE and the cell is empty.

Gtk.CellRendererText:rise
No description available.
Gtk.CellRendererText:rise-set
No description available.
Gtk.CellRendererText:scale
No description available.
Gtk.CellRendererText:scale-set
No description available.
Gtk.CellRendererText:single-paragraph-mode
No description available.
Gtk.CellRendererText:size
No description available.
Gtk.CellRendererText:size-points
No description available.
Gtk.CellRendererText:size-set
No description available.
Gtk.CellRendererText:stretch
No description available.
Gtk.CellRendererText:stretch-set
No description available.
Gtk.CellRendererText:strikethrough
No description available.
Gtk.CellRendererText:strikethrough-set
No description available.
Gtk.CellRendererText:style
No description available.
Gtk.CellRendererText:style-set
No description available.
Gtk.CellRendererText:text
No description available.
Gtk.CellRendererText:underline
No description available.
Gtk.CellRendererText:underline-set
No description available.
Gtk.CellRendererText:variant
No description available.
Gtk.CellRendererText:variant-set
No description available.
Gtk.CellRendererText:weight
No description available.
Gtk.CellRendererText:weight-set
No description available.
Gtk.CellRendererText:width-chars

The desired width of the cell, in characters. If this property is set to -1, the width will be calculated automatically, otherwise the cell will request either 3 characters or the property value, whichever is greater.

Gtk.CellRendererText:wrap-mode

Specifies how to break the string into multiple lines, if the cell renderer does not have enough room to display the entire string. This property has no effect unless the wrap-width property is set.

Gtk.CellRendererText:wrap-width

Specifies the minimum width at which the text is wrapped. The wrap-mode property can be used to influence at what character positions the line breaks can be placed. Setting wrap-width to -1 turns wrapping off.

Properties inherited from GtkCellRenderer (15)
Gtk.CellRenderer:cell-background
No description available.
Gtk.CellRenderer:cell-background-rgba

Cell background as a GdkRGBA

Gtk.CellRenderer:cell-background-set
No description available.
Gtk.CellRenderer:editing
No description available.
Gtk.CellRenderer:height
No description available.
Gtk.CellRenderer:is-expanded
No description available.
Gtk.CellRenderer:is-expander
No description available.
Gtk.CellRenderer:mode
No description available.
Gtk.CellRenderer:sensitive
No description available.
Gtk.CellRenderer:visible
No description available.
Gtk.CellRenderer:width
No description available.
Gtk.CellRenderer:xalign
No description available.
Gtk.CellRenderer:xpad
No description available.
Gtk.CellRenderer:yalign
No description available.
Gtk.CellRenderer:ypad
No description available.

Signals

Gtk.CellRendererCombo::changed

This signal is emitted each time after the user selected an item in the combo box, either by using the mouse or the arrow keys. Contrary to GtkComboBox, GtkCellRendererCombo::changed is not emitted for changes made to a selected item in the entry. The argument new_iter corresponds to the newly selected item in the combo box and it is relative to the GtkTreeModel set via the model property on GtkCellRendererCombo.

Signals inherited from GtkCellRendererText (1)
Gtk.CellRendererText::edited

This signal is emitted after renderer has been edited.

Signals inherited from GtkCellRenderer (2)
Gtk.CellRenderer::editing-canceled

This signal gets emitted when the user cancels the process of editing a cell. For example, an editable cell renderer could be written to cancel editing when the user presses Escape.

Gtk.CellRenderer::editing-started

This signal gets emitted when a cell starts to be edited. The intended use of this signal is to do special setup on editable, e.g. adding a GtkEntryCompletion or setting up additional columns in a GtkComboBox.