Package ch.bailu.gtk.gtk

Klasse IconView

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.Widget
ch.bailu.gtk.gtk.IconView
Alle implementierten Schnittstellen:
PointerInterface
public class IconView extends Widget
`GtkIconView` is a widget which displays data in a grid of icons.

<picture>
<source srcset="icon-view-dark.png" media="(prefers-color-scheme: dark)">
<img alt="An example GtkIconView" src="icon-view.png">
</picture>

`GtkIconView` provides an alternative view on a `GtkTreeModel`.
It displays the model as a grid of icons with labels. Like
[class@Gtk.TreeView], it allows to select one or multiple items
(depending on the selection mode, see [method@Gtk.IconView.set_selection_mode]).
In addition to selection with the arrow keys, `GtkIconView` supports
rubberband selection, which is controlled by dragging the pointer.

Note that if the tree model is backed by an actual tree store (as
opposed to a flat list where the mapping to icons is obvious),
`GtkIconView` will only display the first level of the tree and
ignore the tree’s branches.

## CSS nodes

```
iconview.view
╰── [rubberband]
```

`GtkIconView` has a single CSS node with name iconview and style class .view.
For rubberband selection, a subnode with name rubberband is used.

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

  • Felddetails

  • Konstruktordetails

    • IconView

      public IconView(PointerContainer pointer)

    • IconView

      @Deprecated public IconView()
      Veraltet.
      Creates a new `GtkIconView` widget

  • Methodendetails

    • getClassHandler

      public static ClassHandler getClassHandler()

    • newWithAreaIconView

      @Deprecated public static IconView newWithAreaIconView(@Nonnull CellArea area)
      Veraltet.
      Creates a new `GtkIconView` widget using the
      specified @area to layout cells inside the icons.
      Parameter:
      area - the `GtkCellArea` to use to layout cells
      Gibt zurück:
      A newly created `GtkIconView` widget

    • newWithModelIconView

      @Deprecated public static IconView newWithModelIconView(@Nonnull TreeModel model)
      Veraltet.
      Creates a new `GtkIconView` widget with the model @model.
      Parameter:
      model - The model.
      Gibt zurück:
      A newly created `GtkIconView` widget.

    • createDragIcon

      @Deprecated public Paintable createDragIcon(@Nonnull TreePath path)
      Veraltet.
      Creates a `GdkPaintable` representation of the item at @path.
      This image is used for a drag icon.
      Parameter:
      path - a `GtkTreePath` in @icon_view
      Gibt zurück:
      a newly-allocated `GdkPaintable` of the drag icon.

    • enableModelDragDest

      @Deprecated public void enableModelDragDest(@Nonnull ContentFormats formats, int actions)
      Veraltet.
      Turns @icon_view into a drop destination for automatic DND. Calling this
      method sets `GtkIconView`:reorderable to %FALSE.
      Parameter:
      formats - the formats that the drag will support
      actions - the bitmask of possible actions for a drag to this widget

    • enableModelDragSource

      @Deprecated public void enableModelDragSource(int start_button_mask, @Nonnull ContentFormats formats, int actions)
      Veraltet.
      Turns @icon_view into a drag source for automatic DND. Calling this
      method sets `GtkIconView`:reorderable to %FALSE.
      Parameter:
      start_button_mask - Mask of allowed buttons to start drag
      formats - the formats that the drag will support
      actions - the bitmask of possible actions for a drag from this widget

    • getActivateOnSingleClick

      @Deprecated public boolean getActivateOnSingleClick()
      Veraltet.
      Gets the setting set by gtk_icon_view_set_activate_on_single_click().
      Gibt zurück:
      %TRUE if item-activated will be emitted on a single click

    • getCellRect

      @Deprecated public boolean getCellRect(@Nonnull TreePath path, @Nullable CellRenderer cell, @Nonnull Rectangle rect)
      Veraltet.
      Fills the bounding rectangle in widget coordinates for the cell specified by
      @path and @cell. If @cell is %NULL the main cell area is used.

      This function is only valid if @icon_view is realized.
      Parameter:
      path - a `GtkTreePath`
      cell - a `GtkCellRenderer`
      rect - rectangle to fill with cell rect
      Gibt zurück:
      %FALSE if there is no such item, %TRUE otherwise

    • getColumnSpacing

      @Deprecated public int getColumnSpacing()
      Veraltet.
      Returns the value of the ::column-spacing property.
      Gibt zurück:
      the space between columns

    • getColumns

      @Deprecated public int getColumns()
      Veraltet.
      Returns the value of the ::columns property.
      Gibt zurück:
      the number of columns, or -1

    • getItemColumn

      @Deprecated public int getItemColumn(@Nonnull TreePath path)
      Veraltet.
      Gets the column in which the item @path is currently
      displayed. Column numbers start at 0.
      Parameter:
      path - the `GtkTreePath` of the item
      Gibt zurück:
      The column in which the item is displayed

    • getItemOrientation

      @Deprecated public int getItemOrientation()
      Veraltet.
      Returns the value of the ::item-orientation property which determines
      whether the labels are drawn beside the icons instead of below.
      Gibt zurück:
      the relative position of texts and icons

    • getItemPadding

      @Deprecated public int getItemPadding()
      Veraltet.
      Returns the value of the ::item-padding property.
      Gibt zurück:
      the padding around items

    • getItemRow

      @Deprecated public int getItemRow(@Nonnull TreePath path)
      Veraltet.
      Gets the row in which the item @path is currently
      displayed. Row numbers start at 0.
      Parameter:
      path - the `GtkTreePath` of the item
      Gibt zurück:
      The row in which the item is displayed

    • getItemWidth

      @Deprecated public int getItemWidth()
      Veraltet.
      Returns the value of the ::item-width property.
      Gibt zurück:
      the width of a single item, or -1

    • getMargin

      @Deprecated public int getMargin()
      Veraltet.
      Returns the value of the ::margin property.
      Gibt zurück:
      the space at the borders

    • getMarkupColumn

      @Deprecated public int getMarkupColumn()
      Veraltet.
      Returns the column with markup text for @icon_view.
      Gibt zurück:
      the markup column, or -1 if it’s unset.

    • getModel

      @Deprecated public TreeModel getModel()
      Veraltet.
      Returns the model the `GtkIconView` is based on. Returns %NULL if the
      model is unset.
      Gibt zurück:
      The currently used `GtkTreeModel`

    • getPathAtPos

      @Deprecated public TreePath getPathAtPos(int x, int y)
      Veraltet.
      Gets the path for the icon at the given position.
      Parameter:
      x - The x position to be identified
      y - The y position to be identified
      Gibt zurück:
      The `GtkTreePath` corresponding to the icon or %NULL if no icon exists at that position.

    • getPixbufColumn

      @Deprecated public int getPixbufColumn()
      Veraltet.
      Returns the column with pixbufs for @icon_view.
      Gibt zurück:
      the pixbuf column, or -1 if it’s unset.

    • getReorderable

      @Deprecated public boolean getReorderable()
      Veraltet.
      Retrieves whether the user can reorder the list via drag-and-drop.
      See gtk_icon_view_set_reorderable().
      Gibt zurück:
      %TRUE if the list can be reordered.

    • getRowSpacing

      @Deprecated public int getRowSpacing()
      Veraltet.
      Returns the value of the ::row-spacing property.
      Gibt zurück:
      the space between rows

    • getSelectedItems

      @Deprecated public List getSelectedItems()
      Veraltet.
      Creates a list of paths of all selected items. Additionally, if you are
      planning on modifying the model after calling this function, you may
      want to convert the returned list into a list of `GtkTreeRowReferences`.
      To do this, you can use gtk_tree_row_reference_new().

      To free the return value, use `g_list_free_full`: 
      <!-- language="C" -->
 GtkWidget *icon_view = gtk_icon_view_new ();
 // Use icon_view
 
 GList *list = gtk_icon_view_get_selected_items (GTK_ICON_VIEW (icon_view));
 
 // use list
 
 g_list_free_full (list, (GDestroyNotify) gtk_tree_path_free);
      Gibt zurück:
      A `GList` containing a `GtkTreePath` for each selected row.

    • getSelectionMode

      @Deprecated public int getSelectionMode()
      Veraltet.
      Gets the selection mode of the @icon_view.
      Gibt zurück:
      the current selection mode

    • getSpacing

      @Deprecated public int getSpacing()
      Veraltet.
      Returns the value of the ::spacing property.
      Gibt zurück:
      the space between cells

    • getTextColumn

      @Deprecated public int getTextColumn()
      Veraltet.
      Returns the column with text for @icon_view.
      Gibt zurück:
      the text column, or -1 if it’s unset.

    • getTooltipColumn

      @Deprecated public int getTooltipColumn()
      Veraltet.
      Returns the column of @icon_view’s model which is being used for
      displaying tooltips on @icon_view’s rows.
      Gibt zurück:
      the index of the tooltip column that is currently being used, or -1 if this is disabled.

    • itemActivated

      @Deprecated public void itemActivated(@Nonnull TreePath path)
      Veraltet.
      Activates the item determined by @path.
      Parameter:
      path - The `GtkTreePath` to be activated

    • pathIsSelected

      @Deprecated public boolean pathIsSelected(@Nonnull TreePath path)
      Veraltet.
      Returns %TRUE if the icon pointed to by @path is currently
      selected. If @path does not point to a valid location, %FALSE is returned.
      Parameter:
      path - A `GtkTreePath` to check selection on.
      Gibt zurück:
      %TRUE if @path is selected.

    • scrollToPath

      @Deprecated public void scrollToPath(@Nonnull TreePath path, boolean use_align, float row_align, float col_align)
      Veraltet.
      Moves the alignments of @icon_view to the position specified by @path.
      @row_align determines where the row is placed, and @col_align determines
      where @column is placed. Both are expected to be between 0.0 and 1.0.
      0.0 means left/top alignment, 1.0 means right/bottom alignment, 0.5 means
      center.

      If @use_align is %FALSE, then the alignment arguments are ignored, and the
      tree does the minimum amount of work to scroll the item onto the screen.
      This means that the item will be scrolled to the edge closest to its current
      position. If the item is currently visible on the screen, nothing is done.

      This function only works if the model is set, and @path is a valid row on
      the model. If the model changes before the @icon_view is realized, the
      centered path will be modified to reflect this change.
      Parameter:
      path - The path of the item to move to.
      use_align - whether to use alignment arguments, or %FALSE.
      row_align - The vertical alignment of the item specified by @path.
      col_align - The horizontal alignment of the item specified by @path.

    • selectAll

      @Deprecated public void selectAll()
      Veraltet.
      Selects all the icons. @icon_view must has its selection mode set
      to %GTK_SELECTION_MULTIPLE.

    • selectPath

      @Deprecated public void selectPath(@Nonnull TreePath path)
      Veraltet.
      Selects the row at @path.
      Parameter:
      path - The `GtkTreePath` to be selected.

    • selectedForeach

      @Deprecated public void selectedForeach(IconView.OnIconViewForeachFunc func, @Nullable Pointer data)
      Veraltet.
      Calls a function for each selected icon. Note that the model or
      selection cannot be modified from within this function.
      Parameter:
      func - The function to call for each selected icon.
      data - User data to pass to the function.

    • setActivateOnSingleClick

      @Deprecated public void setActivateOnSingleClick(boolean single)
      Veraltet.
      Causes the `GtkIconView`::item-activated signal to be emitted on
      a single click instead of a double click.
      Parameter:
      single - %TRUE to emit item-activated on a single click

    • setColumnSpacing

      @Deprecated public void setColumnSpacing(int column_spacing)
      Veraltet.
      Sets the ::column-spacing property which specifies the space
      which is inserted between the columns of the icon view.
      Parameter:
      column_spacing - the column spacing

    • setColumns

      @Deprecated public void setColumns(int columns)
      Veraltet.
      Sets the ::columns property which determines in how
      many columns the icons are arranged. If @columns is
      -1, the number of columns will be chosen automatically
      to fill the available area.
      Parameter:
      columns - the number of columns

    • setCursor

      @Deprecated public void setCursor(@Nonnull TreePath path, @Nullable CellRenderer cell, boolean start_editing)
      Veraltet.
      Sets the current keyboard focus to be at @path, and selects it. This is
      useful when you want to focus the user’s attention on a particular item.
      If @cell is not %NULL, then focus is given to the cell specified by
      it. Additionally, if @start_editing is %TRUE, then editing should be
      started in the specified cell.

      This function is often followed by `gtk_widget_grab_focus
      (icon_view)` in order to give keyboard focus to the widget.
      Please note that editing can only happen when the widget is realized.
      Parameter:
      path - A `GtkTreePath`
      cell - One of the cell renderers of @icon_view
      start_editing - %TRUE if the specified cell should start being edited.

    • setDragDestItem

      @Deprecated public void setDragDestItem(@Nullable TreePath path, int pos)
      Veraltet.
      Sets the item that is highlighted for feedback.
      Parameter:
      path - The path of the item to highlight
      pos - Specifies where to drop, relative to the item

    • setItemOrientation

      @Deprecated public void setItemOrientation(int orientation)
      Veraltet.
      Sets the ::item-orientation property which determines whether the labels
      are drawn beside the icons instead of below.
      Parameter:
      orientation - the relative position of texts and icons

    • setItemPadding

      @Deprecated public void setItemPadding(int item_padding)
      Veraltet.
      Sets the `GtkIconView`:item-padding property which specifies the padding
      around each of the icon view’s items.
      Parameter:
      item_padding - the item padding

    • setItemWidth

      @Deprecated public void setItemWidth(int item_width)
      Veraltet.
      Sets the ::item-width property which specifies the width
      to use for each item. If it is set to -1, the icon view will
      automatically determine a suitable item size.
      Parameter:
      item_width - the width for each item

    • setMargin

      @Deprecated public void setMargin(int margin)
      Veraltet.
      Sets the ::margin property which specifies the space
      which is inserted at the top, bottom, left and right
      of the icon view.
      Parameter:
      margin - the margin

    • setMarkupColumn

      @Deprecated public void setMarkupColumn(int column)
      Veraltet.
      Sets the column with markup information for @icon_view to be
      @column. The markup column must be of type `G_TYPE_STRING`.
      If the markup column is set to something, it overrides
      the text column set by gtk_icon_view_set_text_column().
      Parameter:
      column - A column in the currently used model, or -1 to display no text

    • setModel

      @Deprecated public void setModel(@Nullable TreeModel model)
      Veraltet.
      Sets the model for a `GtkIconView`.
      If the @icon_view already has a model set, it will remove
      it before setting the new model. If @model is %NULL, then
      it will unset the old model.
      Parameter:
      model - The model.

    • setPixbufColumn

      @Deprecated public void setPixbufColumn(int column)
      Veraltet.
      Sets the column with pixbufs for @icon_view to be @column. The pixbuf
      column must be of type `GDK_TYPE_PIXBUF`
      Parameter:
      column - A column in the currently used model, or -1 to disable

    • setReorderable

      @Deprecated public void setReorderable(boolean reorderable)
      Veraltet.
      This function is a convenience function to allow you to reorder models that
      support the `GtkTreeDragSourceIface` and the `GtkTreeDragDestIface`. Both
      `GtkTreeStore` and `GtkListStore` support these. If @reorderable is %TRUE, then
      the user can reorder the model by dragging and dropping rows. The
      developer can listen to these changes by connecting to the model's
      row_inserted and row_deleted signals. The reordering is implemented by setting up
      the icon view as a drag source and destination. Therefore, drag and
      drop can not be used in a reorderable view for any other purpose.

      This function does not give you any degree of control over the order -- any
      reordering is allowed. If more control is needed, you should probably
      handle drag and drop manually.
      Parameter:
      reorderable - %TRUE, if the list of items can be reordered.

    • setRowSpacing

      @Deprecated public void setRowSpacing(int row_spacing)
      Veraltet.
      Sets the ::row-spacing property which specifies the space
      which is inserted between the rows of the icon view.
      Parameter:
      row_spacing - the row spacing

    • setSelectionMode

      @Deprecated public void setSelectionMode(int mode)
      Veraltet.
      Sets the selection mode of the @icon_view.
      Parameter:
      mode - The selection mode

    • setSpacing

      @Deprecated public void setSpacing(int spacing)
      Veraltet.
      Sets the ::spacing property which specifies the space
      which is inserted between the cells (i.e. the icon and
      the text) of an item.
      Parameter:
      spacing - the spacing

    • setTextColumn

      @Deprecated public void setTextColumn(int column)
      Veraltet.
      Sets the column with text for @icon_view to be @column. The text
      column must be of type `G_TYPE_STRING`.
      Parameter:
      column - A column in the currently used model, or -1 to display no text

    • setTooltipCell

      @Deprecated public void setTooltipCell(@Nonnull Tooltip tooltip, @Nonnull TreePath path, @Nullable CellRenderer cell)
      Veraltet.
      Sets the tip area of @tooltip to the area which @cell occupies in
      the item pointed to by @path. See also gtk_tooltip_set_tip_area().

      See also gtk_icon_view_set_tooltip_column() for a simpler alternative.
      Parameter:
      tooltip - a `GtkTooltip`
      path - a `GtkTreePath`
      cell - a `GtkCellRenderer`

    • setTooltipColumn

      @Deprecated public void setTooltipColumn(int column)
      Veraltet.
      If you only plan to have simple (text-only) tooltips on full items, you
      can use this function to have `GtkIconView` handle these automatically
      for you. @column should be set to the column in @icon_view’s model
      containing the tooltip texts, or -1 to disable this feature.

      When enabled, `GtkWidget:has-tooltip` will be set to %TRUE and
      @icon_view will connect a `GtkWidget::query-tooltip` signal handler.

      Note that the signal handler sets the text with gtk_tooltip_set_markup(),
      so &, <, etc have to be escaped in the text.
      Parameter:
      column - an integer, which is a valid column number for @icon_view’s model

    • setTooltipItem

      @Deprecated public void setTooltipItem(@Nonnull Tooltip tooltip, @Nonnull TreePath path)
      Veraltet.
      Sets the tip area of @tooltip to be the area covered by the item at @path.
      See also gtk_icon_view_set_tooltip_column() for a simpler alternative.
      See also gtk_tooltip_set_tip_area().
      Parameter:
      tooltip - a `GtkTooltip`
      path - a `GtkTreePath`

    • unselectAll

      @Deprecated public void unselectAll()
      Veraltet.
      Unselects all the icons.

    • unselectPath

      @Deprecated public void unselectPath(@Nonnull TreePath path)
      Veraltet.
      Unselects the row at @path.
      Parameter:
      path - The `GtkTreePath` to be unselected.

    • unsetModelDragDest

      @Deprecated public void unsetModelDragDest()
      Veraltet.
      Undoes the effect of gtk_icon_view_enable_model_drag_dest(). Calling this
      method sets `GtkIconView`:reorderable to %FALSE.

    • unsetModelDragSource

      @Deprecated public void unsetModelDragSource()
      Veraltet.
      Undoes the effect of gtk_icon_view_enable_model_drag_source(). Calling this
      method sets `GtkIconView`:reorderable to %FALSE.

    • onActivateCursorItem

      public SignalHandler onActivateCursorItem(IconView.OnActivateCursorItem signal)
      Connect to signal "activate-cursor-item".
      See IconView.OnActivateCursorItem.onActivateCursorItem() for signal description.
      Field SIGNAL_ON_ACTIVATE_CURSOR_ITEM 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.

    • onItemActivated

      public SignalHandler onItemActivated(IconView.OnItemActivated signal)
      Connect to signal "item-activated".
      See IconView.OnItemActivated.onItemActivated(ch.bailu.gtk.gtk.TreePath) for signal description.
      Field SIGNAL_ON_ITEM_ACTIVATED 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.

    • onMoveCursor

      public SignalHandler onMoveCursor(IconView.OnMoveCursor signal)
      Connect to signal "move-cursor".
      See IconView.OnMoveCursor.onMoveCursor(int, int, boolean, boolean) for signal description.
      Field SIGNAL_ON_MOVE_CURSOR 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.

    • onSelectAll

      public SignalHandler onSelectAll(IconView.OnSelectAll signal)
      Connect to signal "select-all".
      See IconView.OnSelectAll.onSelectAll() for signal description.
      Field SIGNAL_ON_SELECT_ALL 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.

    • onSelectCursorItem

      public SignalHandler onSelectCursorItem(IconView.OnSelectCursorItem signal)
      Connect to signal "select-cursor-item".
      See IconView.OnSelectCursorItem.onSelectCursorItem() for signal description.
      Field SIGNAL_ON_SELECT_CURSOR_ITEM 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.

    • onSelectionChanged

      public SignalHandler onSelectionChanged(IconView.OnSelectionChanged signal)
      Connect to signal "selection-changed".
      See IconView.OnSelectionChanged.onSelectionChanged() for signal description.
      Field SIGNAL_ON_SELECTION_CHANGED 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.

    • onToggleCursorItem

      public SignalHandler onToggleCursorItem(IconView.OnToggleCursorItem signal)
      Connect to signal "toggle-cursor-item".
      See IconView.OnToggleCursorItem.onToggleCursorItem() for signal description.
      Field SIGNAL_ON_TOGGLE_CURSOR_ITEM 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.

    • onUnselectAll

      public SignalHandler onUnselectAll(IconView.OnUnselectAll signal)
      Connect to signal "unselect-all".
      See IconView.OnUnselectAll.onUnselectAll() for signal description.
      Field SIGNAL_ON_UNSELECT_ALL 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.

    • asAccessible

      public Accessible asAccessible()
      Implements interface Accessible. Call this to get access to interface functions.
      Setzt außer Kraft:
      asAccessible in Klasse Widget
      Gibt zurück:
      Accessible

    • asBuildable

      public Buildable asBuildable()
      Implements interface Buildable. Call this to get access to interface functions.
      Setzt außer Kraft:
      asBuildable in Klasse Widget
      Gibt zurück:
      Buildable

    • asCellLayout

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

    • asConstraintTarget

      public ConstraintTarget asConstraintTarget()
      Implements interface ConstraintTarget. Call this to get access to interface functions.
      Setzt außer Kraft:
      asConstraintTarget in Klasse Widget
      Gibt zurück:
      ConstraintTarget

    • asScrollable

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

    • 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()