addListener
public void addListener(IconViewListener listener)
Register an object to handle IconView events.
clear
public void clear()
Unsets all the mappings on all renderers on the CellLayout and removes
all renderers from the CellLayout.
- clear in interface CellLayout
getCellRendererAtPosition
public CellRenderer getCellRendererAtPosition(int x,
int y)
Finds the cell at the point (x,y), relative to widget coordinates.
x
- The x position to be identified.y
- The y position to be identified.
- CellRenderer responsible for the cell at (x,y) or null if no item
exists at the specified position.
getColumnSpacing
public int getColumnSpacing()
getColumns
public int getColumns()
Returns the number of columns for this IconView.
getCursorCellRenderer
public CellRenderer getCursorCellRenderer()
Returns the current cursor cell. If no cell currently has focus, then
null will be returned.
- current cursor CellRenderer or null.
getCursorPath
public TreePath getCursorPath()
Returns the current cursor path. If the cursor isn't currently set, then
null will be returned.
- current cursor TreePath or null.
getIconView
public static IconView getIconView(Handle handle)
Internal static factory method to be used by Java-Gnome only.
getItemWidth
public int getItemWidth()
Returns the width of each item.
getMargin
public int getMargin()
getMarkupColumn
public int getMarkupColumn()
Returns the column with markup text for this IconView.
getModel
public TreeModel getModel()
Returns the model that the IconView is using. It will return null if a
model is the IconView currently does not have a model.
getOrientation
public Orientation getOrientation()
Returns the Orientation for this IconView.
getPathAtPosition
public TreePath getPathAtPosition(int x,
int y)
Find the path at the point (x,y) relative to widget coordinates.
getPixbufColumn
public int getPixbufColumn()
Returns the column with Pixbufs for this IconView.
getReorderable
public boolean getReorderable()
Retrieves whether the user can reorder the list via drag-and-drop.
true
if the list can be reordered.
getRowSpacing
public int getRowSpacing()
getSelectedItems
public TreePath[] getSelectedItems()
Returns an array of all selected paths.
getSelectionMode
public SelectionMode getSelectionMode()
Returns the selection mode for this IconView.
getSpacing
public int getSpacing()
getTextColumn
public int getTextColumn()
Returns the column with text fro this IconView.
itemActivated
public void itemActivated(TreePath path)
Activate the item specified by path.
packEnd
public void packEnd(CellRenderer renderer,
boolean expand)
Adds the cell to the end of the CellLayout. 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.
- packEnd in interface CellLayout
packStart
public void packStart(CellRenderer renderer,
boolean expand)
Packs the cell into the beginning of the CellLayout. 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.
- packStart in interface CellLayout
pathIsSelected
public boolean pathIsSelected(TreePath path)
returns true if the path is currently selected.
removeListener
public void removeListener(IconViewListener listener)
Removes a listener.
reorder
public void reorder(CellRenderer renderer,
int position)
Re-inserts the renderer at position. Note that the renderer has already
to be packed into the CellLayout for this to function properly.
- reorder in interface CellLayout
selectAll
public void selectAll()
Selects all of the icons. The IconView must have its' selection mode set
to SelectionMode.MULTIPLE.
selectPath
public void selectPath(TreePath path)
Selects the row at the specified path.
setColumnSpacing
public void setColumnSpacing(int columnSpacing)
setColumns
public void setColumns(int columns)
Set the number of columns for this IconView.
setCursor
public void setCursor(TreePath path,
CellRenderer renderer,
boolean startEditing)
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 renderer is not null, then focus is given to the cell specified by it.
Additionally, if startEditing is true, then editing should be started in
the specified cell.
Due to a bug in gtk+, calling this method will cause the virtual machine
to crash (because of a segmentation fault) if the CellRenderer is not a
part of this IconView and startEditing is set to true. This issue is
fixed in gtk+ 2.8.17 and higher and will cause an assertion failure
instead (which does not crash the virtual machine).
path
- A TreePathrenderer
- A CellRenderer of this IconView or nullstartEditing
- true if the specified cell should start being edited.
setItemWidth
public void setItemWidth(int width)
Sets the width of each item.
setMargin
public void setMargin(int margin)
setMarkupColumn
public void setMarkupColumn(int column)
Sets the column with markup information for this IconView to be the
specified column. The markup column must be of type DataColumnString. If
the markup column is set to something it overrides the text column set by
setTextColumn
setModel
public void setModel(TreeModel model)
Sets the model for this IconView. If the IconView already has a model it
will remove it before setting the new model. If model is null it will
unset the old model.
setOrientation
public void setOrientation(Orientation orientation)
Sets the orientation of this IconView which determines whether the labels
are drawn beside instead of below the icons.
setPixbufColumn
public void setPixbufColumn(int column)
Sets the column with Pixbufs for this IconView to be the specified
column. This pixubf column must be of type DataColumnPixbuf.
setReorderable
public void setReorderable(boolean reorderable)
Convenience method that allows the caller to set whether models that
support
TreeDragSource
and
TreeDragDest
should be
reorderable by the users. Both
TreeStore
and
ListStore
support these.
If
reorderable
is
true
, then the user can
reorder the model by dragging and dropping rows. Those interested in
notification when these changes take place should add a TreeModelListener
to the model, and listen to TreeModelEvents of type ROW_INSERTED and
ROW_DELETED.
This method does not give any degree of control over the order -- any
reordering is allowed. If more control is needed, drag and drop should be
handled manually.
reorderable
- if the list of items can be reordered.
setRowSpacing
public void setRowSpacing(int rowSpacing)
setSelectionMode
public void setSelectionMode(SelectionMode mode)
Sets the selection mode for this IconView.
setSpacing
public void setSpacing(int spacing)
setTextColumn
public void setTextColumn(int column)
Sets the column with text for this IconView to be the specified column.
The text column must be of type DataColumnString.
unselectAll
public void unselectAll()
Unselects all of the icons.
unselectPath
public void unselectPath(TreePath path)
Unselects the row at the specified path.