org.gnu.gtk
public class IconView extends Container implements CellLayout
Deprecated: This class is part of the java-gnome 2.x family of libraries,
which, due to their inefficiency and complexity, are no longer
being maintained and have been abandoned by the java-gnome
project. This class may in the future have an equivalent in
java-gnome 4.0, try looking for
org.gnome.gtk.IconView
.
You should be aware that there is a considerably different API
in the new library: the architecture is completely different
and most notably internals are no longer exposed to public view.
Constructor Summary | |
---|---|
IconView()
Create a new IconView | |
IconView(TreeModel model)
Create a new IconView specifying the model.
| |
IconView(Handle handle)
Create a new IconView with a handle to a native resource returned from a
call to the native libraries. |
Method Summary | |
---|---|
void | addAttributeMapping(CellRenderer renderer, CellRendererAttribute attribute, DataColumn column)
Adds an attribute mapping to the list in the CellLayout. |
void | addListener(IconViewListener listener)
Register an object to handle IconView events.
|
void | clear()
Unsets all the mappings on all renderers on the CellLayout and removes
all renderers from the CellLayout. |
void | clearAttributeMappings(CellRenderer renderer)
Clears all existing attributes previously set with
IconView. |
CellRenderer | getCellRendererAtPosition(int x, int y)
Finds the cell at the point (x,y), relative to widget coordinates.
|
int | getColumns()
Returns the number of columns for this IconView. |
int | getColumnSpacing() |
CellRenderer | getCursorCellRenderer()
Returns the current cursor cell. |
TreePath | getCursorPath()
Returns the current cursor path. |
Class | getEventListenerClass(String signal) |
EventType | getEventType(String signal) |
static IconView | getIconView(Handle handle)
Internal static factory method to be used by Java-Gnome only. |
int | getItemWidth()
Returns the width of each item. |
int | getMargin() |
int | getMarkupColumn()
Returns the column with markup text for this IconView. |
TreeModel | getModel()
Returns the model that the IconView is using. |
Orientation | getOrientation()
Returns the Orientation for this IconView. |
TreePath | getPathAtPosition(int x, int y)
Find the path at the point (x,y) relative to widget coordinates.
|
int | getPixbufColumn()
Returns the column with Pixbufs for this IconView. |
boolean | getReorderable()
Retrieves whether the user can reorder the list via drag-and-drop.
|
int | getRowSpacing() |
TreePath[] | getSelectedItems()
Returns an array of all selected paths. |
SelectionMode | getSelectionMode()
Returns the selection mode for this IconView. |
int | getSpacing() |
int | getTextColumn()
Returns the column with text fro this IconView. |
void | itemActivated(TreePath path)
Activate the item specified by path.
|
void | packEnd(CellRenderer renderer, boolean expand)
Adds the cell to the end of the CellLayout. |
void | packStart(CellRenderer renderer, boolean expand)
Packs the cell into the beginning of the CellLayout. |
boolean | pathIsSelected(TreePath path)
returns true if the path is currently selected.
|
void | removeListener(IconViewListener listener)
Removes a listener.
|
void | reorder(CellRenderer renderer, int position)
Re-inserts the renderer at position. |
void | selectAll()
Selects all of the icons. |
void | selectPath(TreePath path)
Selects the row at the specified path.
|
void | setColumns(int columns)
Set the number of columns for this IconView.
|
void | setColumnSpacing(int columnSpacing) |
void | setCursor(TreePath path, CellRenderer renderer, boolean startEditing)
Sets the current keyboard focus to be at path, and selects it. |
void | setItemWidth(int width)
Sets the width of each item.
|
void | setMargin(int margin) |
void | setMarkupColumn(int column)
Sets the column with markup information for this IconView to be the
specified column. |
void | setModel(TreeModel model)
Sets the model for this IconView. |
void | setOrientation(Orientation orientation)
Sets the orientation of this IconView which determines whether the labels
are drawn beside instead of below the icons.
|
void | setPixbufColumn(int column)
Sets the column with Pixbufs for this IconView to be the specified
column. |
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. |
void | setRowSpacing(int rowSpacing) |
void | setSelectionMode(SelectionMode mode)
Sets the selection mode for this IconView.
|
void | setSpacing(int spacing) |
void | setTextColumn(int column)
Sets the column with text for this IconView to be the specified column.
|
void | unselectAll()
Unselects all of the icons. |
void | unselectPath(TreePath path)
Unselects the row at the specified path.
|
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Create a new IconViewDeprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Create a new IconView specifying the model.Parameters: model
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Create a new IconView with a handle to a native resource returned from a call to the native libraries. This constructor should only be used internally by Java-Gnome.Parameters: handle The handle that represents a pointer to a native resource.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Adds an attribute mapping to the list in the CellLayout. The column is the column of the model to get a value from, and the attribute is the parameter on cell to be set from the value.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Register an object to handle IconView events.See Also: IconViewListener
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Unsets all the mappings on all renderers on the CellLayout and removes all renderers from the CellLayout.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Clears all existing attributes previously set with IconView.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Finds the cell at the point (x,y), relative to widget coordinates.Parameters: x The x position to be identified. y The y position to be identified.
Returns: CellRenderer responsible for the cell at (x,y) or null if no item exists at the specified position.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the number of columns for this IconView.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the current cursor cell. If no cell currently has focus, then null will be returned.Returns: current cursor CellRenderer or null.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the current cursor path. If the cursor isn't currently set, then null will be returned.Returns: current cursor TreePath or null.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Internal static factory method to be used by Java-Gnome only.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the width of each item.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the column with markup text for this IconView.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the model that the IconView is using. It will return null if a model is the IconView currently does not have a model.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the Orientation for this IconView.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Find the path at the point (x,y) relative to widget coordinates.Parameters: x y
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the column with Pixbufs for this IconView.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Retrieves whether the user can reorder the list via drag-and-drop.Returns: true
if the list can be reordered.
Since: 2.8.1
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns an array of all selected paths.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the selection mode for this IconView.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Returns the column with text fro this IconView.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Activate the item specified by path.Parameters: path
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
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.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
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.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
returns true if the path is currently selected.Parameters: path
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Removes a listener.See Also: addListener
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Re-inserts the renderer at position. Note that the renderer has already to be packed into the CellLayout for this to function properly.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Selects all of the icons. The IconView must have its' selection mode set to SelectionMode.MULTIPLE.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Selects the row at the specified path.Parameters: path
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Set the number of columns for this IconView.Parameters: columns
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Parameters: columnSpacing
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
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).
Parameters: path A TreePath renderer A CellRenderer of this IconView or null startEditing true if the specified cell should start being edited.
Throws: IllegalArgumentException If renderer is null and startEditing is true
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Sets the width of each item.Parameters: width
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Parameters: margin
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
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 bysetTextColumn
Parameters: column
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
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.Parameters: model
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Sets the orientation of this IconView which determines whether the labels are drawn beside instead of below the icons.Parameters: orientation
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Sets the column with Pixbufs for this IconView to be the specified column. This pixubf column must be of type DataColumnPixbuf.Parameters: column
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
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.
Parameters: reorderable if the list of items can be reordered.
Since: 2.8.1
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Parameters: rowSpacing
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Sets the selection mode for this IconView.Parameters: mode
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Parameters: spacing
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Sets the column with text for this IconView to be the specified column. The text column must be of type DataColumnString.Parameters: column
Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Unselects all of the icons.Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.
Unselects the row at the specified path.Parameters: path