Constructor Detail

• IconView

  public IconView()

  Construct an IconView whose backing model will be assigned later. You'll need to use setModel() to set it.

  Since:

  4.0.8

• IconView

  public IconView(TreeModel model)

  Create a new IconView

  Remember you cannot use a TreeStore model with an IconView.

  Since:

  4.0.7

Method Detail

• connect

  public void connect(IconView.ItemActivated handler)

  Hook up a IconView.ItemActivated handler.

  Since:

  4.0.7

• connect

  public void connect(IconView.SelectionChanged handler)

  Hook up a handler for the IconView.SelectionChanged signal.

  Since:

  4.0.7

• getSelectedItems

  public TreePath[] getSelectedItems()

  Get the items currently selected.

  You can use the TreeModel's getIter() method to convert the returned TreePaths to the more convenient TreeIter:

   IconView view;
   TreeModel model;
   
   for (TreePath path : view.getSelectedItems()) {
       TreeIter item = model.getIter(path);
       // do something with the item
   }
   

  Also remember that both TreeIter and TreePath are temporally objects no longer valid once you make any change to the model. Thus, if you plan to modify the model, you may want to convert the returned TreePaths to TreeRowReferences.

  Returns:

  An arrays with the selected items. If no item is selected, an empty array is returned.

  Since:

  4.0.7

• isSelected

  public boolean isSelected(TreePath path)

  Return true if the currently selected icon is pointed by path.

  Since:

  4.0.15

• selectAll

  public void selectAll()

  Select all the icons, in order to work, you must have set the SelectionMode to MULTIPLE.

  Since:

  4.0.15

• selectPath

  public void selectPath(TreePath path)

  Select the row at path.

  Since:

  4.0.15

• setColumns

  public void setColumns(int num)

  The number of columns in which icons should be displayed. The default is -1 which indicates that the IconView will determine this automatically based on the size allocated to it.

  Since:

  4.0.8

• setItemWidth

  public void setItemWidth(int width)

  Set the maximum width that will be given to each column of icons. The width is measured in pixels. The default value is -1 which indicates

  Since:

  4.0.8

• setMarkupColumn

  public void setMarkupColumn(DataColumnString column)

  Set the DataColumn, containing Pango markup, to render as the label of each item.

  Since:

  4.0.7

• setModel

  public void setModel(TreeModel model)

  Set or change the TreeModel from which this IconView draws its data.

  Since:

  4.0.7

• setPixbufColumn

  public void setPixbufColumn(DataColumnPixbuf column)

  Set the DataColumn of the model that contains the Pixbuf to use as the icon of each item.

  Since:

  4.0.7

• setSelectionMode

  public void setSelectionMode(SelectionMode mode)

  Set what kinds of selections are allowed. The interesting constants you'll use most often are NONE and MULTIPLE since SINGLE is the default. See SelectionMode for the details of the behaviour implied by each option.

  Since:

  4.0.7

• setTextColumn

  public void setTextColumn(DataColumnString column)

  Set the DataColumn in the TreeModel containing the plain text to use as label of each item. Usually you will use this method to choose the model column to map to the label. Alternatively you can use setMarkupColumn() to provide a text with Pango markup.

  Since:

  4.0.7

• unselectAll

  public void unselectAll()

  Unselect all the icons.

  Since:

  4.0.15

• unselectPath

  public void unselectPath(TreePath path)

  Unselect the row at path.

  Since:

  4.0.15