Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
GObject
org.gnu.gtk.GtkObject
org.gnu.gtk.Widget
org.gnu.gtk.Container
org.gnu.gtk.TreeView
public class TreeView
extends Container
TreeView
TreeView
. An application can have any
number of treeviews and they can be placed as can normal widgets. The data
for the widget, and the method in which it is displayed is controlled by
other classes. Gtk has been designed so that any number of treeview widgets
can be linked to the same data store. TreeViewColumn
s,
CellRenderer
s and TreeSelection
s are created for each view,
so Views can use the same data store but have their own column layout, data
display within those columns (linked to any of the dataBlocks in the store);
and their own selections.
TreeModel
DataColumn
s, which could be considered
the columns of that table (in fact, in the C version of GTK, they are always
referred to as columns; but this can get confused with TreeViewColumns which
are quite a different matter). These DataColumns each store one type of data
(String, boolean, int, etc.). The 'rows' of this data table (the individual
records) can be accessed using iterators called TreeIter
s. These are
used extensively in many methods. Setting data involves getting an iterator
(creating a new row gets you a TreeIter) and then setting the value for each
of the DataColumns. The ordering of the DataColumns in the Model has no
meaning. For presentation, you decide exactly which DataColumns are to be
used on screen by mapping them to a a TreeViewColumn via a CellRenderer (see
below).
GTK provides two implementations of TreeModel
:
ListStore
- This is used for tables and lists. Data is organised in
rows and columns.
TreeStore
- This is for data organized in hierarchical trees. You
order your data using TreePath
s.
TreeViewColumn
TreeView
you're creating. The TreeViewColumns determine
how the data is displayed. They have settings such as the column title,
whether the column can be resized, and even whether the columns can be
reorganized (by dragging the columns). Each TreeView
widget has it's
own set of TreeViewColumns. Determining how the data is displayed in the
columns is done by CellRenderers (see below). Any number of CellRenderers can
be packed into a given column.
CellRenderer
TreeViewColumn.addAttributeMapping(CellRenderer,CellRendererAttribute,DataColumn)
. The renderer attributes vary with each
renderer, for example CellRendererText has a TEXT attribute for the text the
be displayed. The final parameter is for the DataColumn in the store in which
the data is contained.
Java-Gnome comes with a number of simple example applications involving
trees. They may be useful for learning the functionality of these classes.
Finally, some people may find use for a convenience wrapper that Java-Gnome
derived; see SimpleList
to display a single column list of string
values.
Constructor Summary | |
| |
| |
Method Summary | |
void |
|
void |
|
int |
|
TreeViewColumn |
|
TreeViewColumn |
|
TreeViewColumn |
|
TreeViewColumn |
|
TreeViewColumn |
|
TreeViewColumn |
|
void |
|
void |
|
boolean |
|
void |
|
boolean | |
void |
|
boolean | |
TreeViewColumn |
|
TreeViewColumn[] |
|
TreeViewColumn |
|
TreePath |
|
boolean | |
Class |
|
EventType |
|
TreeViewColumn | |
boolean |
|
Adjustment |
|
boolean |
|
boolean |
|
boolean |
|
TreeModel |
|
boolean | |
boolean |
|
TreeViewRowSeparatorMethod |
|
TreeViewColumn |
|
DataColumn |
|
TreeSelection |
|
static TreeView |
|
static Type |
|
Adjustment |
|
int |
|
void |
|
int |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void | |
void |
|
void |
|
void |
|
void |
|
void |
|
TreeViewColumn |
|
TreeViewColumn |
|
TreeViewColumn |
|
TreeViewColumn |
|
TreeViewColumn |
|
TreeViewColumn |
|
Methods inherited from class org.gnu.gtk.Container | |
add , addListener , getBooleanChildProperty , getBorderWidth , getChildProperty , getChildren , getEventListenerClass , getEventType , getIntChildProperty , getResizeMode , getType , remove , removeListener , resizeChildren , setBooleanChildProperty , setBorderWidth , setChildProperty , setIntChildProperty , setResizeMode |
public TreeView()
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 TreeView object.
public TreeView(Handle handle)
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.
Creates a new tree view from a native handle
public TreeView(TreeModel 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.
Creates a new TreeView Widget with the initial model set
public void activateCell(TreePath path, TreeViewColumn 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.
Activates the cell determined by path and column.
- Parameters:
path
- The TreePath to be activated.column
- The TreeViewColumn to be activated.
public void addListener(TreeViewListener listener)
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 events related to user actions on the TreeView widget.
- See Also:
TreeViewListener
public int appendColumn(TreeViewColumn 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.
Appends column to the list of columns.
- Parameters:
column
- The GtkTreeViewColumn to add.
- Returns:
- The number of columns in tree_view after appending.
public TreeViewColumn appendDataColumn(TreeViewColumn aExistingCol, int aCol)
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.
Appends a data column of the model to an existingTreeViewColumn
, previously created with one of theshowDataColumn
methods. It should be used when it's desired to have more than one data in just one column. This method will try to guess the renderer to use, and because of that, it has some limitations. For instance, you should only use it to show these kinds of DataColumns:DataColumnBoolean
,DataColumnString
,DataColumnPixbuf
,DataColumnStockItem
. For other kinds of DataColumn, the methodappendDataColumn(TreeViewColumn, int, CellRenderer, CellRendererAttribute)
should be used, which is more flexible, allowing you to specify which renderer to use, and its rendering attributes.
- Parameters:
aExistingCol
- an existingTreeViewColumn
.aCol
- the number of the column in the model to be shown; starting from 0.
- Returns:
- an instance to the updated column.
public TreeViewColumn appendDataColumn(TreeViewColumn aExistingCol, int aCol, boolean expand)
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.
Appends a data column of the model to an existingTreeViewColumn
, previously created with one of theshowDataColumn
methods. It should be used when it's desired to have more than one data in just one column. This method will try to guess the renderer to use, and because of that, it has some limitations. For instance, you should only use it to show these kinds of DataColumns:DataColumnBoolean
,DataColumnString
,DataColumnPixbuf
,DataColumnStockItem
. For other kinds of DataColumn, the methodappendDataColumn(TreeViewColumn, int, CellRenderer, CellRendererAttribute)
should be used, which is more flexible, allowing you to specify which renderer to use, and its rendering attributes.
- Parameters:
aExistingCol
- an existingTreeViewColumn
.aCol
- the number of the column in the model to be shown; starting from 0.expand
-true
if this column should expand to fill the available space in the row,false
otherwise.
- Returns:
- an instance to the updated column.
public TreeViewColumn appendDataColumn(TreeViewColumn aExistingCol, int aCol, CellRenderer aRenderer, aAttr[] )
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.
Appends a data column of the model to an existingTreeViewColumn
, previously created with one of theshowDataColumn
methods, and lets you use a specific renderer and rendering attributes. It should be used when it's desired to have more than one data in just one column.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.aRenderer
- the renderer to be used
- Returns:
- an instance to the updated column.
public TreeViewColumn appendDataColumn(TreeViewColumn aExistingCol, int aCol, CellRenderer aRenderer, aAttr[] , boolean expand)
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.
Appends a data column of the model to an existingTreeViewColumn
, previously created with one of theshowDataColumn
methods, and lets you use a specific renderer and rendering attributes. It should be used when it's desired to have more than one data in just one column.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.aRenderer
- the renderer to be usedexpand
-true
if this column should expand to fill the available space in the row,false
otherwise.
- Returns:
- an instance to the updated column.
public TreeViewColumn appendDataColumn(TreeViewColumn aExistingCol, int aCol, CellRenderer aRenderer, CellRendererAttribute aAttr)
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.
Appends a data column of the model to an existingTreeViewColumn
, previously created with one of theshowDataColumn
methods, and lets you use a specific renderer and rendering attributes. It should be used when it's desired to have more than one data in just one column.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.aRenderer
- the renderer to be usedaAttr
- the rendering attributes to be used
- Returns:
- an instance to the updated column.
public TreeViewColumn appendDataColumn(TreeViewColumn aExistingCol, int aCol, CellRenderer aRenderer, CellRendererAttribute aAttr, boolean expand)
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.
Appends a data column of the model to an existingTreeViewColumn
, previously created with one of theshowDataColumn
methods, and lets you use a specific renderer and rendering attributes. It should be used when it's desired to have more than one data in just one column.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.aRenderer
- the renderer to be usedaAttr
- the rendering attributes to be usedexpand
-true
if this column should expand to fill the available space in the row,false
otherwise.
- Returns:
- an instance to the updated column.
public void autoSizeColumns()
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.
Resizes all columns to their optimal width. Only works after the treeview has been realized.
public void collapseAll()
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.
Recursively collapses all visible, expanded nodes.
public boolean collapseRow(TreePath 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.
Collapses a row (hides its child rows, if they exist).
- Parameters:
path
- Path to a row in the view
- Returns:
- true if the row was collapsed.
public void expandAll()
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.
Recursively expands all nodes
public boolean expandRow(TreePath path, boolean openAll)
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.
Opens the row so its children are visible.
- Parameters:
path
- Path to a rowopenAll
- Whether to recursively expand, or just expand immediate children
- Returns:
- true if the row existed and had children
public void expandToPath(TreePath 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.
Expands the row at path. This will also expand all parent rows of path as necessary.
- Parameters:
path
- path to a row
- Since:
- 2.2
public boolean getAlternateRowColor()
public TreeViewColumn getColumn(int 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.
Gets the column at the given position in the tree view.
- Parameters:
position
- The position of the column, counting from 0.
- Returns:
- The TreeViewColumn, or
null
if the position is outside the range of columns.
public TreeViewColumn[] getColumns()
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 the columns currently in the view
public TreeViewColumn getCursorColumn()
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 column
public TreePath getCursorPath()
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 path
public boolean getEnableSearch()
public Class getEventListenerClass(String signal)
- Overrides:
- getEventListenerClass in interface Container
public EventType getEventType(String signal)
- Overrides:
- getEventType in interface Container
public boolean getFixedHeightMode()
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 whether fixed height mode is turned on for this TreeView.
public Adjustment getHAdjustment()
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.
Gets the GtkAdjustment currently being used for the horizontal aspect.
- Returns:
- A GtkAdjustment object, or null if none is currently being used.
public boolean getHeadersVisible()
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 headers on the TreeView are visible.
public boolean getHoverExpand()
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 whether hover expansion mode is turned on for TreeView.
public boolean getHoverSelection()
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 whether hover selection mode is turned on for this TreeView.
public TreeModel getModel()
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 associated with this tree.
public boolean getReorderable()
public boolean getRowExpanded(TreePath 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.
Returns true if the node pointed to by path is expanded.
- Parameters:
path
- A TreePath to test expansion state.
- Returns:
- true if path is expanded.
public TreeViewRowSeparatorMethod getRowSeparatorMethod()
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.
Get the object which is used to determine whether a row should be drawn as a separator.
- Returns:
- The TreeViewRowSeparatorMethod or null if no method has been set.
public TreeViewColumn getSearchColumn()
Deprecated. This method is broken and has been deprecated in favor of the
getSearchDataColumn()
method.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.
public DataColumn getSearchDataColumn()
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.
Gets the column searched on by the interactive search code.
- Returns:
- A DataColumn object representing the column of the data model in which the interactive search takes place.
public TreeSelection getSelection()
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.
Gets the TreeSelection associated with this widget
public static TreeView getTreeView(Handle handle)
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.
Creates a new tree view from a native handle
public static Type getType()
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.
Retrieve the runtime type used by the GLib library.
public Adjustment getVAdjustment()
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.
Gets the Adjustment currently being used for the vertical aspect.
public int insertColumn(TreeViewColumn column, int 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.
This inserts the column into the tree_view at position. If position is -1, then the column is inserted at the end.
- Parameters:
column
- The GtkTreeViewColumn to be inserted.position
- The position to insert column in.
- Returns:
- The number of columns in tree_view after insertion.
public void moveColumn(TreeViewColumn column, TreeViewColumn baseColumn)
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.
Moves column to be after to baseColumn. If baseColumn is null, then column is placed in the first position.
- Parameters:
column
- The GtkTreeViewColumn to be moved.baseColumn
- The GtkTreeViewColumn to be moved relative to, or null.
public int removeColumn(TreeViewColumn 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.
Removes column from tree_view.
- Parameters:
column
- The GtkTreeViewColumn to remove.
- Returns:
- The number of columns in tree_view after removing.
public void removeListener(TreeViewListener listener)
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(TreeViewListener)
public void scrollToCell(TreePath 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.
Moves the alignments of the view to the position specified by path.
- Parameters:
path
- The path of the row to move to, or null.
public void scrollToCell(TreePath path, TreeViewColumn 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.
Moves the alignments of the view to the position specified by column and path.
- Parameters:
path
- The path of the row to move tocolumn
- The TreeViewColumn to move horizontally to
public void scrollToCell(TreePath path, TreeViewColumn column, double rowAlign, double colAlign)
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.
Moves the alignments of the view to the position specified by column and path. rowAlign determines where the row is placed, and colAlign 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.
- Parameters:
path
- The path of the row to move tocolumn
- The TreeViewColumn to move horizontally torowAlign
- The vertical alignment of the row specified by path.colAlign
- : The horizontal alignment of the column specified by column.
public void scrollToCell(TreeViewColumn 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.
Moves the alignments of the view to the position specified by column
- Parameters:
column
- The TreeViewColumn to move horizontally to
public void scrollToPoint(int x, int 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.
Scrolls the TreeView such that the top-left corner of the visible area is x, y, where x and y are specified in tree window coordinates. If either x or y are -1 then that direction isn't scrolled.
- Parameters:
x
-y
-
public void setAlternateRowColor(boolean setting)
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.
This function tells GTK+ that the user interface for your application requires users to read across tree rows and associate cells with one another. By default, GTK+ will then render the tree with alternating row colors. Do not use it just because you prefer the appearance of the ruled tree; that's a question for the theme. Some themes will draw tree rows in alternating colors even when rules are turned off, and users who prefer that appearance all the time can choose those themes. You should call this function only as a semantic hint to the theme engine that your tree makes alternating colors useful from a functional standpoint (since it has lots of columns, generally).
- Parameters:
setting
- true if the tree requires reading across rows
public void setCursor(TreePath path, TreeViewColumn focusColumn, boolean startEditing)
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 row. If column is specified, and startEditing is true, then editing should be started in the specified cell. This function is often followed byWidget.grabFocus()
in order to give keyboard focus to the widget. Please note that editing can only happen when the widget is realized.
- Parameters:
path
- A TreePathfocusColumn
- A TreeViewColumn, or nullstartEditing
- true if the specified cell should start being edited.
public void setCursor(TreePath path, TreeViewColumn focusColumn, CellRenderer focusCell, boolean startEditing)
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 row. If column is specified, and startEditing is true, then editing should be started in the specified cell. If focusCell is also specified, the particular cellRenderer in that column will get focusThis function is often followed byWidget.grabFocus()
in order to give keyboard focus to the widget. Please note that editing can only happen when the widget is realized.
- Parameters:
path
- A TreePathfocusColumn
- A TreeViewColumn, or nullfocusCell
- A cellrenderer, or nullstartEditing
- true if the specified cell should start being edited.
- Since:
- 2.2
public void setEnableSearch(boolean enableSearch)
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.
If enable search is set, then the user can type in text to search through the tree interactively. SeesetSearchDataColumn(DataColumn)
to tell the TreeView which data to search on.
- Parameters:
enableSearch
- true, if the user can search interactively
public void setExpanderColumn(TreeViewColumn 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 column to draw the expander arrow at. If column is null, then the expander arrow is always at the first visible column.
- Parameters:
column
- null, or the column to draw the expander arrow at.
public void setFixedHeightMode(boolean enable)
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.
Enables or disables the fixed height mode of this TreeView. Fixed height mode speeds up TreeView by assuming that all rows have the same height. Only enable this option if all rows are the same height and all columns are of typeTreeViewColumnSizing.FIXED
.
- Parameters:
enable
- true to enable fixed height mode.
public void setHAdjustment(Adjustment hadj)
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 Adjustment for the current horizontal aspect.
public void setHeadersClickable(boolean setting)
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.
Allow the column title buttons to be clicked.
- Parameters:
setting
- true if the columns are clickable.
public void setHeadersVisible(boolean headersVisible)
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 the visibility state of the headers.
- Parameters:
headersVisible
- true if the headers are visible
public void setHoverExpand(boolean expand)
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.
Enables or disables the hover expansion mode of this TreeView. Hover expansion makes rows expand or collapse if the pointer moves over them.
- Parameters:
expand
- true to enable hover selection mode.
public void setHoverSelection(boolean hover)
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.
Enables of disables the hover selection mode of this TreeView. Hover selection makes the selected row follow the pointer. Currently, this works only for the selection modesSelectionMode.SINGLE
andSelectionMode.BROWSE
.
- Parameters:
hover
- true to enable hover selection mode.
public void setModel(TreeModel 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 model for a GtkTreeView. If theTreeView
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.
- Parameters:
model
- the new model for theTreeView
public void setReorderable(boolean reorderable)
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.
This function is a convenience function to allow you to reorder models that support the DragSourceIface and the DragDestIface. BothTreeStore
andListStore
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 adding listeners. This function does not give you any degree of control over the order -- any reorderering is allowed. If more control is needed, you should probably handle drag and drop manually.
- Parameters:
reorderable
- true, if the tree can be reordered.
public void setRowSeparatorMethod(TreeViewRowSeparatorMethod method)
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 object which is used to determine whether a row should be drawn as a separator.
- Parameters:
method
- The TreeViewRowSeparatorMethod or null if no separators are to be drawn (the default).
public void setSearchColumn(TreeViewColumn column)
Deprecated. This method is broken and has been deprecated in favor of the
setSearchDataColumn(DataColumn)
method.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.
public void setSearchDataColumn(DataColumn 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 column as the column where the interactive search code should search in. Additionally, turns on interactive searching (iesetEnableSearch(true)
)
- Parameters:
column
- The column of the data model to search in.
public void setVAdjustment(Adjustment vadj)
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 Adjustment for the current vertical aspect.
public TreeViewColumn showDataColumn(int aCol)
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.
Shows a data column of the model in thisTreeView
. This method will try to guess the renderer to use, and because of that, it has some limitations. For instance, you should only use it to show these kinds of DataColumns:DataColumnBoolean
,DataColumnString
,DataColumnPixbuf
,DataColumnStockItem
. For other kinds of DataColumn, the methodshowDataColumn(int, CellRenderer, CellRendererAttribute)
should be used, which is more flexible, allowing you to specify which renderer to use, and its rendering attributes.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.
- Returns:
- an instance to the new shown column.
public TreeViewColumn showDataColumn(int aCol, boolean expand)
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.
Shows a data column of the model in thisTreeView
. This method will try to guess the renderer to use, and because of that, it has some limitations. For instance, you should only use it to show these kinds of DataColumns:DataColumnBoolean
,DataColumnString
,DataColumnPixbuf
,DataColumnStockItem
. For other kinds of DataColumn, the methodshowDataColumn(int, CellRenderer, CellRendererAttribute)
should be used, which is more flexible, allowing you to specify which renderer to use, and its rendering attributes.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.expand
-true
if this column should expand to fill the available space in the row,false
otherwise.
- Returns:
- an instance to the new shown column.
public TreeViewColumn showDataColumn(int aCol, CellRenderer aRenderer, aAttr[] )
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.
Shows a data column of the model in thisTreeView
, with a specific renderer and rendering attributes.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.aRenderer
- the renderer to be used
- Returns:
- an instance to the new shown column.
public TreeViewColumn showDataColumn(int aCol, CellRenderer aRenderer, aAttr[] , boolean expand)
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.
Shows a data column of the model in thisTreeView
, with a specific renderer and rendering attributes.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.aRenderer
- the renderer to be usedexpand
-true
if this column should expand to fill the available space in the row,false
otherwise.
- Returns:
- an instance to the new shown column.
public TreeViewColumn showDataColumn(int aCol, CellRenderer aRenderer, CellRendererAttribute aAttr)
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.
Shows a data column of the model in thisTreeView
, with a specific renderer and rendering attributes.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.aRenderer
- the renderer to be usedaAttr
- the rendering attributes to be used
- Returns:
- an instance to the new shown column.
public TreeViewColumn showDataColumn(int aCol, CellRenderer aRenderer, CellRendererAttribute aAttr, boolean expand)
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.
Shows a data column of the model in thisTreeView
, with a specific renderer and rendering attributes.
- Parameters:
aCol
- the number of the column in the model to be shown; starting from 0.aRenderer
- the renderer to be usedaAttr
- the rendering attributes to be usedexpand
-true
if this column should expand to fill the available space in the row,false
otherwise.
- Returns:
- an instance to the new shown column.