Known subclasses: kiwi.ui.objectlist.ColoredColumn, kiwi.ui.objectlist.SequentialColumn

Specifies a column for an L{ObjectList}, see the ObjectList documentation
for a simple example.

Properties
==========
  - B{title}: string I{mandatory}
    - the title of the column, defaulting to the capitalized form of
      the attribute
  - B{data-type}: object I{str}
    - the type of the attribute that will be inserted into the column.
      Supported data types: bool, int, float, str, unicode,
      decimal.Decimal, datetime.date, datetime.time, datetime.datetime,
      gtk.gdk.Pixbuf, L{kiwi.currency.currency}, L{kiwi.python.enum}.
  - B{visible}: bool I{True}
    - specifying if it is initially hidden or shown.
  - B{justify}: gtk.Justification I{None}
    - one of gtk.JUSTIFY_LEFT, gtk.JUSTIFY_RIGHT or gtk.JUSTIFY_CENTER
      or None. If None, the justification will be determined by the type
      of the attribute value of the first instance to be inserted in the
      ObjectList (for instance numbers will be right-aligned).
  - B{format}: string I{""}
    - a format string to be applied to the attribute value upon insertion
      in the list.
  - B{width}: integer I{65535}
    - the width in pixels of the column, if not set, uses the default to
      ObjectList. If no Column specifies a width, columns_autosize() will
      be called on the ObjectList upon append() or the first add_list().
  - B{sorted}: bool I{False}
    - whether or not the ObjectList is to be sorted by this column.
      If no Columns are sorted, the ObjectList will be created unsorted.
  - B{order}: GtkSortType I{-1}
    - one of gtk.SORT_ASCENDING, gtk.SORT_DESCENDING or -1
      The value -1 is mean that the column is not sorted.
  - B{expand}: bool I{False}
    - if set column will expand. Note: this space is shared equally amongst
      all columns that have the expand set to True.
  - B{tooltip}: string I{""}
    - a string which will be used as a tooltip for the column header
  - B{format_func}: object I{None}
    -  a callable which will be used to format the output of a column.
       The function will take one argument which is the value to convert
       and is expected to return a string.
       I{Note}: that you cannot use format and format_func at the same time,
       if you provide a format function you'll be responsible for
       converting the value to a string.
  - B{editable}: bool I{False}
    - if true the field is editable and when you modify the contents of
      the cell the model will be updated.
  - B{searchable}: bool I{False}
    - if true the attribute values of the column can be searched using
      type ahead search. Only string attributes are currently supported.
  - B{radio}: bool I{False}
    -  If true render the column as a radio instead of toggle.
       Only applicable for columns with boolean data types.
  - B{spin_adjustment}: gtk.Adjustment I{None}
    -  A gtk.Adjustment instance. If set, render the column cell as
       a spinbutton.
  - B{use_stock}: bool I{False}
    - If true, this will be rendered as pixbuf from the value which
      should be a stock id.
  - B{icon_size}: gtk.IconSize I{gtk.ICON_SIZE_MENU}
  - B{editable_attribute}: string I{""}
    - a string which is the attribute which should decide if the
      cell is editable or not.
  - B{use_markup}: bool I{False}
    - If true, the text will be rendered with markup
  - B{expander}: bool I{False}
    - If True, this column will be used as the tree expander column
  - B{ellipsize}: pango.EllipsizeMode I{pango.ELLIPSIZE_NONE}
    - One of pango.ELLIPSIZE_{NONE, START, MIDDLE_END}, it describes
      where characters should be removed in case ellipsization
      (where to put the ...) is needed.
  - B{font-desc}: str I{""}
    - A string passed to pango.FontDescription, for instance "Sans" or
  - B{column}: str None
    - A string referencing to another column. If this is set a new column
      will not be created and the column will be packed into the other.
Method __init__ Creates a new Column, which describes how a column in a ObjectList should be rendered.
Method __repr__ Undocumented
Method prop_set_data_type Undocumented
Method attach Undocumented
Method as_string Undocumented
Method set_spinbutton_precision_digits Set the number of precision digits to be shown in the spinbutton.
Method _guess_renderer_for_type Gusses which CellRenderer we should use for a given type. It also set the property of the renderer that depends on the model, in the renderer.
Method _cell_data_text_func To render the data of a cell renderer text
Method _cell_data_pixbuf_func To render the data of a cell renderer pixbuf
Method _cell_data_combo_func Undocumented
Method _cell_data_spin_func To render the data of a cell renderer spin
Method _on_renderer__toggled Undocumented
Method _on_renderer_toggle_check__toggled Undocumented
Method _on_renderer_toggle_radio__toggled Undocumented
Method _on_renderer_text__edited Undocumented
Method _on_renderer_spin__edited Undocumented
Method _on_renderer_combo__edited Undocumented
Method _on_renderer__edited Undocumented

Inherited from PropertyObject:

Class Method __class_init__ Undocumented
Method __post_init__ No summary
Method get_attribute_names Undocumented
Method is_default_value Undocumented
Method do_set_property Undocumented
Method do_get_property Undocumented
Method _set Undocumented
Method _get Undocumented
def __init__(self, attribute='', title=None, data_type=None, **kwargs):
Creates a new Column, which describes how a column in a
ObjectList should be rendered.

@param attribute: a string with the name of the instance attribute the
    column represents.
@param title: the title of the column, defaulting to the capitalized
    form of the attribute.
@param data_type: the type of the attribute that will be inserted
    into the column.

@note: title_pixmap: (TODO) if set to a filename a pixmap will be
    used *instead* of the title set. The title string will still be
    used to identify the column in the column selection and in a
    tooltip, if a tooltip is not set.
def __repr__(self):
Undocumented
def prop_set_data_type(self, data):
Undocumented
def attach(self, objectlist):
Undocumented
def _guess_renderer_for_type(self, model):
Gusses which CellRenderer we should use for a given type.
It also set the property of the renderer that depends on the model,
in the renderer.
def _cell_data_text_func(self, tree_column, renderer, model, treeiter, (column, renderer_prop)):
To render the data of a cell renderer text
def _cell_data_pixbuf_func(self, tree_column, renderer, model, treeiter, (column, renderer_prop)):
To render the data of a cell renderer pixbuf
def _cell_data_combo_func(self, tree_column, renderer, model, treeiter, (column, renderer_prop)):
Undocumented
def _cell_data_spin_func(self, tree_column, renderer, model, treeiter, (column, renderer_prop)):
To render the data of a cell renderer spin
def _on_renderer__toggled(self, renderer, path, column):
Undocumented
def _on_renderer_toggle_check__toggled(self, renderer, path, model, attr):
Undocumented
def _on_renderer_toggle_radio__toggled(self, renderer, path, model, attr):
Undocumented
def _on_renderer_text__edited(self, renderer, path, text, model, attr, column, from_string):
Undocumented
def _on_renderer_spin__edited(self, renderer, path, value, model, attr, column, from_string):
Undocumented
def _on_renderer_combo__edited(self, renderer, path, text, model, attr, column):
Undocumented
def _on_renderer__edited(self, renderer, path, value, column):
Undocumented
def as_string(self, data):
Undocumented
def set_spinbutton_precision_digits(self, digits):
Set the number of precision digits to be shown in the
spinbutton.

@param digits: the number of precision digits to be set in
spinbutton
@type digits: int
API Documentation for Kiwi, generated by pydoctor at 2019-08-08 02:24:42.