Package ch.bailu.gtk.gtk

Klasse TreeViewColumn

java.lang.Object
ch.bailu.gtk.type.Type
ch.bailu.gtk.type.Pointer
ch.bailu.gtk.gobject.Object
ch.bailu.gtk.type.PropertyHolder
ch.bailu.gtk.gobject.InitiallyUnowned
ch.bailu.gtk.gtk.TreeViewColumn
Alle implementierten Schnittstellen:
PointerInterface
public class TreeViewColumn extends InitiallyUnowned
A visible column in a [class@Gtk.TreeView] widget

The `GtkTreeViewColumn` object represents a visible column in a `GtkTreeView` widget.
It allows to set properties of the column header, and functions as a holding pen
for the cell renderers which determine how the data in the column is displayed.

Please refer to the [tree widget conceptual overview](section-tree-widget.html)
for an overview of all the objects and data types related to the tree widget and
how they work together, and to the [class@Gtk.TreeView] documentation for specifics
about the CSS node structure for treeviews and their headers.

https://docs.gtk.org/gtk4/class.TreeViewColumn.html

  • Felddetails

  • Konstruktordetails

    • TreeViewColumn

      public TreeViewColumn(PointerContainer pointer)

    • TreeViewColumn

      @Deprecated public TreeViewColumn()
      Veraltet.
      Creates a new `GtkTreeViewColumn`.

  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()

    • newWithAreaTreeViewColumn

      @Deprecated public static TreeViewColumn newWithAreaTreeViewColumn(@Nonnull CellArea area)
      Veraltet.
      Creates a new `GtkTreeViewColumn` using @area to render its cells.
      Parameter:
      area - the `GtkCellArea` that the newly created column should use to layout cells.
      Gibt zurück:
      A newly created `GtkTreeViewColumn`.

    • newWithAttributesTreeViewColumn

      @Deprecated public static TreeViewColumn newWithAttributesTreeViewColumn(@Nonnull Str title, @Nonnull CellRenderer cell, Object... _ellipsis)
      Veraltet.
      Creates a new `GtkTreeViewColumn` with a number of default values.
      This is equivalent to calling gtk_tree_view_column_set_title(),
      gtk_tree_view_column_pack_start(), and
      gtk_tree_view_column_set_attributes() on the newly created `GtkTreeViewColumn`.

      Here’s a simple example: 
      <!-- language="C" -->
  enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS };
  // ...
  {
    GtkTreeViewColumn *column;
    GtkCellRenderer   *renderer = gtk_cell_renderer_text_new ();
 
    column = gtk_tree_view_column_new_with_attributes ("Title",
                                                       renderer,
                                                       "text", TEXT_COLUMN,
                                                       "foreground", COLOR_COLUMN,
                                                       NULL);
  }
      Parameter:
      title - The title to set the header to
      cell - The `GtkCellRenderer`
      _ellipsis - A %NULL-terminated list of attributes
      Gibt zurück:
      A newly created `GtkTreeViewColumn`.

    • newWithAttributesTreeViewColumn

      @Deprecated public static TreeViewColumn newWithAttributesTreeViewColumn(String title, @Nonnull CellRenderer cell, Object... _ellipsis)
      Veraltet.
      Creates a new `GtkTreeViewColumn` with a number of default values.
      This is equivalent to calling gtk_tree_view_column_set_title(),
      gtk_tree_view_column_pack_start(), and
      gtk_tree_view_column_set_attributes() on the newly created `GtkTreeViewColumn`.

      Here’s a simple example: 
      <!-- language="C" -->
  enum { TEXT_COLUMN, COLOR_COLUMN, N_COLUMNS };
  // ...
  {
    GtkTreeViewColumn *column;
    GtkCellRenderer   *renderer = gtk_cell_renderer_text_new ();
 
    column = gtk_tree_view_column_new_with_attributes ("Title",
                                                       renderer,
                                                       "text", TEXT_COLUMN,
                                                       "foreground", COLOR_COLUMN,
                                                       NULL);
  }
      Parameter:
      title - The title to set the header to
      cell - The `GtkCellRenderer`
      _ellipsis - A %NULL-terminated list of attributes
      Gibt zurück:
      A newly created `GtkTreeViewColumn`.

    • addAttribute

      @Deprecated public void addAttribute(@Nonnull CellRenderer cell_renderer, @Nonnull Str attribute, int column)
      Veraltet.
      Adds an attribute mapping to the list in @tree_column.

      The @column is the
      column of the model to get a value from, and the @attribute is the
      parameter on @cell_renderer to be set from the value. So for example
      if column 2 of the model contains strings, you could have the
      “text” attribute of a `GtkCellRendererText` get its values from
      column 2.
      Parameter:
      cell_renderer - the `GtkCellRenderer` to set attributes on
      attribute - An attribute on the renderer
      column - The column position on the model to get the attribute from.

    • addAttribute

      @Deprecated public void addAttribute(@Nonnull CellRenderer cell_renderer, String attribute, int column)
      Veraltet.
      Adds an attribute mapping to the list in @tree_column.

      The @column is the
      column of the model to get a value from, and the @attribute is the
      parameter on @cell_renderer to be set from the value. So for example
      if column 2 of the model contains strings, you could have the
      “text” attribute of a `GtkCellRendererText` get its values from
      column 2.
      Parameter:
      cell_renderer - the `GtkCellRenderer` to set attributes on
      attribute - An attribute on the renderer
      column - The column position on the model to get the attribute from.

    • cellGetPosition

      @Deprecated public boolean cellGetPosition(@Nonnull CellRenderer cell_renderer, @Nullable Int x_offset, @Nullable Int width)
      Veraltet.
      Obtains the horizontal position and size of a cell in a column.

      If the cell is not found in the column, @start_pos and @width
      are not changed and %FALSE is returned.
      Parameter:
      cell_renderer - a `GtkCellRenderer`
      x_offset - return location for the horizontal position of @cell within @tree_column
      width - return location for the width of @cell
      Gibt zurück:
      %TRUE if @cell belongs to @tree_column

    • cellGetSize

      @Deprecated public void cellGetSize(@Nullable Int x_offset, @Nullable Int y_offset, @Nullable Int width, @Nullable Int height)
      Veraltet.
      Obtains the width and height needed to render the column. This is used
      primarily by the `GtkTreeView`.
      Parameter:
      x_offset - location to return x offset of a cell relative to @cell_area
      y_offset - location to return y offset of a cell relative to @cell_area
      width - location to return width needed to render a cell
      height - location to return height needed to render a cell

    • cellIsVisible

      @Deprecated public boolean cellIsVisible()
      Veraltet.
      Returns %TRUE if any of the cells packed into the @tree_column are visible.
      For this to be meaningful, you must first initialize the cells with
      gtk_tree_view_column_cell_set_cell_data()
      Gibt zurück:
      %TRUE, if any of the cells packed into the @tree_column are currently visible

    • cellSetCellData

      @Deprecated public void cellSetCellData(@Nonnull TreeModel tree_model, @Nonnull TreeIter iter, boolean is_expander, boolean is_expanded)
      Veraltet.
      Sets the cell renderer based on the @tree_model and @iter. That is, for
      every attribute mapping in @tree_column, it will get a value from the set
      column on the @iter, and use that value to set the attribute on the cell
      renderer. This is used primarily by the `GtkTreeView`.
      Parameter:
      tree_model - The `GtkTreeModel` to get the cell renderers attributes from.
      iter - The `GtkTreeIter` to get the cell renderer’s attributes from.
      is_expander - %TRUE, if the row has children
      is_expanded - %TRUE, if the row has visible children

    • clear

      @Deprecated public void clear()
      Veraltet.
      Unsets all the mappings on all renderers on the @tree_column.

    • clearAttributes

      @Deprecated public void clearAttributes(@Nonnull CellRenderer cell_renderer)
      Veraltet.
      Clears all existing attributes previously set with
      gtk_tree_view_column_set_attributes().
      Parameter:
      cell_renderer - a `GtkCellRenderer` to clear the attribute mapping on.

    • clicked

      @Deprecated public void clicked()
      Veraltet.
      Emits the “clicked” signal on the column. This function will only work if
      @tree_column is clickable.

    • focusCell

      @Deprecated public void focusCell(@Nonnull CellRenderer cell)
      Veraltet.
      Sets the current keyboard focus to be at @cell, if the column contains
      2 or more editable and activatable cells.
      Parameter:
      cell - A `GtkCellRenderer`

    • getAlignment

      @Deprecated public float getAlignment()
      Veraltet.
      Returns the current x alignment of @tree_column. This value can range
      between 0.0 and 1.0.
      Gibt zurück:
      The current alignent of @tree_column.

    • getButton

      @Deprecated public Widget getButton()
      Veraltet.
      Returns the button used in the treeview column header
      Gibt zurück:
      The button for the column header.

    • getClickable

      @Deprecated public boolean getClickable()
      Veraltet.
      Returns %TRUE if the user can click on the header for the column.
      Gibt zurück:
      %TRUE if user can click the column header.

    • getExpand

      @Deprecated public boolean getExpand()
      Veraltet.
      Returns %TRUE if the column expands to fill available space.
      Gibt zurück:
      %TRUE if the column expands to fill available space.

    • getFixedWidth

      @Deprecated public int getFixedWidth()
      Veraltet.
      Gets the fixed width of the column. This may not be the actual displayed
      width of the column; for that, use gtk_tree_view_column_get_width().
      Gibt zurück:
      The fixed width of the column.

    • getMaxWidth

      @Deprecated public int getMaxWidth()
      Veraltet.
      Returns the maximum width in pixels of the @tree_column, or -1 if no maximum
      width is set.
      Gibt zurück:
      The maximum width of the @tree_column.

    • getMinWidth

      @Deprecated public int getMinWidth()
      Veraltet.
      Returns the minimum width in pixels of the @tree_column, or -1 if no minimum
      width is set.
      Gibt zurück:
      The minimum width of the @tree_column.

    • getReorderable

      @Deprecated public boolean getReorderable()
      Veraltet.
      Returns %TRUE if the @tree_column can be reordered by the user.
      Gibt zurück:
      %TRUE if the @tree_column can be reordered by the user.

    • getResizable

      @Deprecated public boolean getResizable()
      Veraltet.
      Returns %TRUE if the @tree_column can be resized by the end user.
      Gibt zurück:
      %TRUE, if the @tree_column can be resized.

    • getSizing

      @Deprecated public int getSizing()
      Veraltet.
      Returns the current type of @tree_column.
      Gibt zurück:
      The type of @tree_column.

    • getSortColumnId

      @Deprecated public int getSortColumnId()
      Veraltet.
      Gets the logical @sort_column_id that the model sorts on
      when this column is selected for sorting.

      See [method@Gtk.TreeViewColumn.set_sort_column_id].
      Gibt zurück:
      the current @sort_column_id for this column, or -1 if this column can’t be used for sorting

    • getSortIndicator

      @Deprecated public boolean getSortIndicator()
      Veraltet.
      Gets the value set by gtk_tree_view_column_set_sort_indicator().
      Gibt zurück:
      whether the sort indicator arrow is displayed

    • getSortOrder

      @Deprecated public int getSortOrder()
      Veraltet.
      Gets the value set by gtk_tree_view_column_set_sort_order().
      Gibt zurück:
      the sort order the sort indicator is indicating

    • getSpacing

      @Deprecated public int getSpacing()
      Veraltet.
      Returns the spacing of @tree_column.
      Gibt zurück:
      the spacing of @tree_column.

    • getTitle

      @Deprecated public Str getTitle()
      Veraltet.
      Returns the title of the widget.
      Gibt zurück:
      the title of the column. This string should not be modified or freed.

    • getTreeView

      @Deprecated public Widget getTreeView()
      Veraltet.
      Returns the `GtkTreeView` wherein @tree_column has been inserted.
      If @column is currently not inserted in any tree view, %NULL is
      returned.
      Gibt zurück:
      The tree view wherein @column has been inserted

    • getVisible

      @Deprecated public boolean getVisible()
      Veraltet.
      Returns %TRUE if @tree_column is visible.
      Gibt zurück:
      whether the column is visible or not. If it is visible, then the tree will show the column.

    • getWidget

      @Deprecated public Widget getWidget()
      Veraltet.
      Returns the `GtkWidget` in the button on the column header.

      If a custom widget has not been set then %NULL is returned.
      Gibt zurück:
      The `GtkWidget` in the column header

    • getWidth

      @Deprecated public int getWidth()
      Veraltet.
      Returns the current size of @tree_column in pixels.
      Gibt zurück:
      The current width of @tree_column.

    • getXOffset

      @Deprecated public int getXOffset()
      Veraltet.
      Returns the current X offset of @tree_column in pixels.
      Gibt zurück:
      The current X offset of @tree_column.

    • packEnd

      @Deprecated public void packEnd(@Nonnull CellRenderer cell, boolean expand)
      Veraltet.
      Adds the @cell to end of the column. If @expand is %FALSE, then the @cell
      is allocated no more space than it needs. Any unused space is divided
      evenly between cells for which @expand is %TRUE.
      Parameter:
      cell - The `GtkCellRenderer`
      expand - %TRUE if @cell is to be given extra space allocated to @tree_column.

    • packStart

      @Deprecated public void packStart(@Nonnull CellRenderer cell, boolean expand)
      Veraltet.
      Packs the @cell into the beginning of the column. If @expand is %FALSE, then
      the @cell is allocated no more space than it needs. Any unused space is divided
      evenly between cells for which @expand is %TRUE.
      Parameter:
      cell - The `GtkCellRenderer`
      expand - %TRUE if @cell is to be given extra space allocated to @tree_column.

    • queueResize

      @Deprecated public void queueResize()
      Veraltet.
      Flags the column, and the cell renderers added to this column, to have
      their sizes renegotiated.

    • setAlignment

      @Deprecated public void setAlignment(float xalign)
      Veraltet.
      Sets the alignment of the title or custom widget inside the column header.
      The alignment determines its location inside the button -- 0.0 for left, 0.5
      for center, 1.0 for right.
      Parameter:
      xalign - The alignment, which is between [0.0 and 1.0] inclusive.

    • setAttributes

      @Deprecated public void setAttributes(@Nonnull CellRenderer cell_renderer, Object... _ellipsis)
      Veraltet.
      Sets the attributes in the list as the attributes of @tree_column.

      The attributes should be in attribute/column order, as in
      gtk_tree_view_column_add_attribute(). All existing attributes
      are removed, and replaced with the new attributes.
      Parameter:
      cell_renderer - the `GtkCellRenderer` we’re setting the attributes of
      _ellipsis - A %NULL-terminated list of attributes

    • setCellDataFunc

      @Deprecated public void setCellDataFunc(@Nonnull CellRenderer cell_renderer, TreeViewColumn.OnTreeCellDataFunc func, @Nullable Pointer func_data, TreeViewColumn.OnDestroyNotify destroy)
      Veraltet.
      Sets the `GtkTreeCellDataFunc` to use for the column.

      This
      function is used instead of the standard attributes mapping for
      setting the column value, and should set the value of @tree_column's
      cell renderer as appropriate. @func may be %NULL to remove an
      older one.
      Parameter:
      cell_renderer - A `GtkCellRenderer`
      func - The `GtkTreeCellDataFunc` to use.
      func_data - The user data for @func.
      destroy - The destroy notification for @func_data

    • setClickable

      @Deprecated public void setClickable(boolean clickable)
      Veraltet.
      Sets the header to be active if @clickable is %TRUE. When the header is
      active, then it can take keyboard focus, and can be clicked.
      Parameter:
      clickable - %TRUE if the header is active.

    • setExpand

      @Deprecated public void setExpand(boolean expand)
      Veraltet.
      Sets the column to take available extra space. This space is shared equally
      amongst all columns that have the expand set to %TRUE. If no column has this
      option set, then the last column gets all extra space. By default, every
      column is created with this %FALSE.

      Along with “fixed-width”, the “expand” property changes when the column is
      resized by the user.
      Parameter:
      expand - %TRUE if the column should expand to fill available space.

    • setFixedWidth

      @Deprecated public void setFixedWidth(int fixed_width)
      Veraltet.
      If @fixed_width is not -1, sets the fixed width of @tree_column; otherwise
      unsets it. The effective value of @fixed_width is clamped between the
      minimum and maximum width of the column; however, the value stored in the
      “fixed-width” property is not clamped. If the column sizing is
      %GTK_TREE_VIEW_COLUMN_GROW_ONLY or %GTK_TREE_VIEW_COLUMN_AUTOSIZE, setting
      a fixed width overrides the automatically calculated width. Note that
      @fixed_width is only a hint to GTK; the width actually allocated to the
      column may be greater or less than requested.

      Along with “expand”, the “fixed-width” property changes when the column is
      resized by the user.
      Parameter:
      fixed_width - The new fixed width, in pixels, or -1.

    • setMaxWidth

      @Deprecated public void setMaxWidth(int max_width)
      Veraltet.
      Sets the maximum width of the @tree_column. If @max_width is -1, then the
      maximum width is unset. Note, the column can actually be wider than max
      width if it’s the last column in a view. In this case, the column expands to
      fill any extra space.
      Parameter:
      max_width - The maximum width of the column in pixels, or -1.

    • setMinWidth

      @Deprecated public void setMinWidth(int min_width)
      Veraltet.
      Sets the minimum width of the @tree_column. If @min_width is -1, then the
      minimum width is unset.
      Parameter:
      min_width - The minimum width of the column in pixels, or -1.

    • setReorderable

      @Deprecated public void setReorderable(boolean reorderable)
      Veraltet.
      If @reorderable is %TRUE, then the column can be reordered by the end user
      dragging the header.
      Parameter:
      reorderable - %TRUE, if the column can be reordered.

    • setResizable

      @Deprecated public void setResizable(boolean resizable)
      Veraltet.
      If @resizable is %TRUE, then the user can explicitly resize the column by
      grabbing the outer edge of the column button.

      If resizable is %TRUE and
      sizing mode of the column is %GTK_TREE_VIEW_COLUMN_AUTOSIZE, then the sizing
      mode is changed to %GTK_TREE_VIEW_COLUMN_GROW_ONLY.
      Parameter:
      resizable - %TRUE, if the column can be resized

    • setSizing

      @Deprecated public void setSizing(int type)
      Veraltet.
      Sets the growth behavior of @tree_column to @type.
      Parameter:
      type - The `GtkTreeViewColumn`Sizing.

    • setSortColumnId

      @Deprecated public void setSortColumnId(int sort_column_id)
      Veraltet.
      Sets the logical @sort_column_id that this column sorts on when this column
      is selected for sorting. Doing so makes the column header clickable.
      Parameter:
      sort_column_id - The @sort_column_id of the model to sort on.

    • setSortIndicator

      @Deprecated public void setSortIndicator(boolean setting)
      Veraltet.
      Call this function with a @setting of %TRUE to display an arrow in
      the header button indicating the column is sorted. Call
      gtk_tree_view_column_set_sort_order() to change the direction of
      the arrow.
      Parameter:
      setting - %TRUE to display an indicator that the column is sorted

    • setSortOrder

      @Deprecated public void setSortOrder(int order)
      Veraltet.
      Changes the appearance of the sort indicator.

      This does not actually sort the model. Use
      gtk_tree_view_column_set_sort_column_id() if you want automatic sorting
      support. This function is primarily for custom sorting behavior, and should
      be used in conjunction with gtk_tree_sortable_set_sort_column_id() to do
      that. For custom models, the mechanism will vary.

      The sort indicator changes direction to indicate normal sort or reverse sort.
      Note that you must have the sort indicator enabled to see anything when
      calling this function; see gtk_tree_view_column_set_sort_indicator().
      Parameter:
      order - sort order that the sort indicator should indicate

    • setSpacing

      @Deprecated public void setSpacing(int spacing)
      Veraltet.
      Sets the spacing field of @tree_column, which is the number of pixels to
      place between cell renderers packed into it.
      Parameter:
      spacing - distance between cell renderers in pixels.

    • setTitle

      @Deprecated public void setTitle(@Nonnull Str title)
      Veraltet.
      Sets the title of the @tree_column. If a custom widget has been set, then
      this value is ignored.
      Parameter:
      title - The title of the @tree_column.

    • setTitle

      @Deprecated public void setTitle(String title)
      Veraltet.
      Sets the title of the @tree_column. If a custom widget has been set, then
      this value is ignored.
      Parameter:
      title - The title of the @tree_column.

    • setVisible

      @Deprecated public void setVisible(boolean visible)
      Veraltet.
      Sets the visibility of @tree_column.
      Parameter:
      visible - %TRUE if the @tree_column is visible.

    • setWidget

      @Deprecated public void setWidget(@Nullable Widget widget)
      Veraltet.
      Sets the widget in the header to be @widget. If widget is %NULL, then the
      header button is set with a `GtkLabel` set to the title of @tree_column.
      Parameter:
      widget - A child `GtkWidget`

    • onClicked

      public SignalHandler onClicked(TreeViewColumn.OnClicked signal)
      Connect to signal "clicked".
      See TreeViewColumn.OnClicked.onClicked() for signal description.
      Field SIGNAL_ON_CLICKED contains original signal name and can be used as resource reference.
      Parameter:
      signal - callback function (lambda).
      Gibt zurück:
      SignalHandler. Can be used to disconnect signal and to release callback function.

    • asBuildable

      public Buildable asBuildable()
      Implements interface Buildable. Call this to get access to interface functions.
      Gibt zurück:
      Buildable

    • asCellLayout

      public CellLayout asCellLayout()
      Implements interface CellLayout. Call this to get access to interface functions.
      Gibt zurück:
      CellLayout

    • getTypeID

      public static long getTypeID()

    • getParentTypeID

      public static long getParentTypeID()

    • getTypeSize

      public static TypeSystem.TypeSize getTypeSize()

    • getParentTypeSize

      public static TypeSystem.TypeSize getParentTypeSize()

    • getInstanceSize

      public static int getInstanceSize()