Portability	portable (depends on GHC)
Stability	provisional
Maintainer	gtk2hs-users@lists.sourceforge.net
Safe Haskell	Safe-Infered

Graphics.UI.Gtk.ModelView.TreeView

Contents

Description
Class Hierarchy
Types
Constructors
Methods
Attributes
Signals
Deprecated

Description

A widget for displaying both trees and lists.

Synopsis

Description

Widget that displays any object that implements the TreeModel interface.

The widget supports scrolling natively. This implies that pixel coordinates can be given in two formats: relative to the current view's upper left corner or relative to the whole list's coordinates. The former are called widget coordinates while the letter are called tree coordinates.

Class Hierarchy

 | GObject
 | +----Object
 | +----Widget
 | +----Container
 | +----TreeView

Types

data TreeView Source

Instances

Eq TreeView
Ord TreeView
GObjectClass TreeView
TreeViewClass TreeView
ContainerClass TreeView
WidgetClass TreeView
ObjectClass TreeView

class ContainerClass o => TreeViewClass o Source

Instances

TreeViewClass TreeView

castToTreeView :: GObjectClass obj => obj -> TreeView Source

gTypeTreeView :: GType Source

toTreeView :: TreeViewClass o => o -> TreeView Source

type Point = (Int, Int)Source

Represents the x and y coordinate of a point.

data DragAction Source

Used in DragContext to indicate what the destination should do with the dropped data.

ActionDefault: Initialisation value, should not be used.
ActionCopy: Copy the data.
ActionMove: Move the data, i.e. first copy it, then delete it from the source.
ActionLink: Add a link to the data. Note that this is only useful if source and destination agree on what it means.
ActionPrivate: Special action which tells the source that the destination will do something that the source doesn't understand.
ActionAsk: Ask the user what to do with the data.

Constructors

ActionDefault
ActionCopy
ActionMove
ActionLink
ActionPrivate
ActionAsk

Instances

Bounded DragAction
Enum DragAction
Eq DragAction
Show DragAction
Flags DragAction

data TreeViewGridLines Source

Grid lines.

Constructors

TreeViewGridLinesNone
TreeViewGridLinesHorizontal
TreeViewGridLinesVertical
TreeViewGridLinesBoth

Instances

Enum TreeViewGridLines

Constructors

treeViewNew :: IO TreeView Source

Creates a new TreeView widget.

treeViewNewWithModel :: TreeModelClass model => model -> IO TreeView Source

Create a new TreeView widget with model as the storage model.

Methods

treeViewGetModel :: TreeViewClass self => self -> IO (Maybe TreeModel)Source

Returns the model that supplies the data for this TreeView. Returns Nothing if the model is unset.

treeViewSetModel :: (TreeViewClass self, TreeModelClass model) => self -> model -> IO ()Source

Set the TreeModel for the current View.

treeViewGetSelection :: TreeViewClass self => self -> IO TreeSelection Source

Retrieve a TreeSelection that holds the current selected nodes of the View.

treeViewGetHAdjustment :: TreeViewClass self => self -> IO (Maybe Adjustment)Source

Gets the Adjustment currently being used for the horizontal aspect.

treeViewSetHAdjustment Source

Arguments

:: TreeViewClass self
=> self
-> Maybe Adjustment	`adjustment` - The `Adjustment` to set, or `Nothing`
-> IO ()

Sets the Adjustment for the current horizontal aspect.

treeViewGetVAdjustment :: TreeViewClass self => self -> IO (Maybe Adjustment)Source

Gets the Adjustment currently being used for the vertical aspect.

treeViewSetVAdjustment Source

Arguments

:: TreeViewClass self
=> self
-> Maybe Adjustment	`adjustment` - The `Adjustment` to set, or `Nothing`
-> IO ()

Sets the Adjustment for the current vertical aspect.

treeViewGetHeadersVisible :: TreeViewClass self => self -> IO Bool Source

Query if the column headers are visible.

treeViewSetHeadersVisible :: TreeViewClass self => self -> Bool -> IO ()Source

Set the visibility state of the column headers.

treeViewColumnsAutosize :: TreeViewClass self => self -> IO ()Source

Resize the columns to their optimal size.

treeViewSetHeadersClickable :: TreeViewClass self => self -> Bool -> IO ()Source

Set wether the columns headers are sensitive to mouse clicks.

treeViewGetRulesHint :: TreeViewClass self => self -> IO Bool Source

Query if visual aid for wide columns is turned on.

treeViewSetRulesHint :: TreeViewClass self => self -> Bool -> IO ()Source

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).

treeViewAppendColumn :: TreeViewClass self => self -> TreeViewColumn -> IO Int Source

Append a new column to the TreeView. Returns the new number of columns.

treeViewRemoveColumn :: TreeViewClass self => self -> TreeViewColumn -> IO Int Source

Remove column tvc from the TreeView widget. The number of remaining columns is returned.

treeViewInsertColumn :: TreeViewClass self => self -> TreeViewColumn -> Int -> IO Int Source

Inserts column tvc into the TreeView widget at the position pos. Returns the number of columns after insertion. Specify -1 for pos to insert the column at the end.

treeViewGetColumn :: TreeViewClass self => self -> Int -> IO (Maybe TreeViewColumn)Source

Retrieve a TreeViewColumn.

Retrieve the pos th columns of TreeView. If the index is out of range Nothing is returned.

treeViewGetColumns :: TreeViewClass self => self -> IO [TreeViewColumn]Source

Return all TreeViewColumns in this TreeView.

treeViewMoveColumnAfter :: TreeViewClass self => self -> TreeViewColumn -> TreeViewColumn -> IO ()Source

Move a specific column.

Use treeViewMoveColumnToFront if you want to move the column to the left end of the TreeView.

treeViewMoveColumnFirst :: TreeViewClass self => self -> TreeViewColumn -> IO ()Source

Move a specific column.

Use treeViewMoveColumnAfter if you want to move the column somewhere else than to the leftmost position.

treeViewSetExpanderColumn :: TreeViewClass self => self -> Maybe TreeViewColumn -> IO ()Source

Set location of hierarchy controls.

Sets the column to draw the expander arrow at. If col is Nothing, then the expander arrow is always at the first visible column.

If you do not want expander arrow to appear in your tree, set the expander column to a hidden column.

treeViewGetExpanderColumn :: TreeViewClass self => self -> IO TreeViewColumn Source

Get location of hierarchy controls.

Gets the column to draw the expander arrow at. If col is Nothing, then the expander arrow is always at the first visible column.

treeViewSetColumnDragFunction :: TreeViewClass self => self -> Maybe (TreeViewColumn -> Maybe TreeViewColumn -> Maybe TreeViewColumn -> IO Bool) -> IO ()Source

Specify where a column may be dropped.

Sets a user function for determining where a column may be dropped when dragged. This function is called on every column pair in turn at the beginning of a column drag to determine where a drop can take place.
The callback function take the TreeViewColumn to be moved, the second and third arguments are the columns on the left and right side of the new location. At most one of them might be Nothing which indicates that the column is about to be dropped at the left or right end of the TreeView.
The predicate pred should return True if it is ok to insert the column at this place.
Use Nothing for the predicate if columns can be inserted anywhere.

treeViewScrollToPoint :: TreeViewClass self => self -> Int -> Int -> IO ()Source

Scroll to a coordinate.

Scrolls the tree view such that the top-left corner of the visible area is treeX, treeY, where treeX and treeY are specified in tree window coordinates. The TreeView must be realized before this function is called. If it isn't, you probably want to use treeViewScrollToCell.

treeViewScrollToCell :: TreeViewClass self => self -> TreePath -> TreeViewColumn -> Maybe (Float, Float) -> IO ()Source

Scroll to a cell.

Scroll to a cell as specified by path and tvc. The cell is aligned within the TreeView widget as follows: horizontally by hor from left (0.0) to right (1.0) and vertically by ver from top (0.0) to buttom (1.0).

treeViewSetCursor :: TreeViewClass self => self -> TreePath -> Maybe (TreeViewColumn, Bool) -> IO ()Source

Selects a specific row.

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 focusColumn is given, then the input focus is given to the column specified by it. Additionally, if focusColumn is specified, and startEditing is True, then editing will be started in the specified cell. This function is often followed by a widgetGrabFocus to the TreeView in order to give keyboard focus to the widget.

treeViewSetCursorOnCell :: (TreeViewClass self, CellRendererClass focusCell) => self -> TreePath -> TreeViewColumn -> focusCell -> Bool -> IO ()Source

Selects a cell in a specific row.

Similar to treeViewSetCursor but allows a column to containt several CellRenderers.
Only available in Gtk 2.2 and higher.

treeViewGetCursor :: TreeViewClass self => self -> IO (TreePath, Maybe TreeViewColumn)Source

Retrieves the position of the focus.

Returns a pair (path, column).If the cursor is not currently set, path will be []. If no column is currently selected, column will be Nothing.

treeViewRowActivated :: TreeViewClass self => self -> TreePath -> TreeViewColumn -> IO ()Source

Emit the activated signal on a cell.

treeViewExpandAll :: TreeViewClass self => self -> IO ()Source

Recursively expands all nodes in the tree view.

treeViewCollapseAll :: TreeViewClass self => self -> IO ()Source

Recursively collapses all visible, expanded nodes in the tree view.

treeViewExpandToPath :: TreeViewClass self => self -> TreePath -> IO ()Source

Make a certain path visible.

This will expand all parent rows of tp as necessary.
Only available in Gtk 2.2 and higher.

treeViewExpandRow Source

Arguments

:: TreeViewClass self
=> self
-> TreePath	`path` - path to a row
-> Bool	`openAll` - whether to recursively expand, or just expand immediate children
-> IO Bool	returns `True` if the row existed and had children

Opens the row so its children are visible.

treeViewCollapseRow Source

Arguments

:: TreeViewClass self
=> self
-> TreePath	`path` - path to a row in the tree view
-> IO Bool	returns `True` if the row was collapsed.

Collapses a row (hides its child rows, if they exist).

treeViewMapExpandedRows :: TreeViewClass self => self -> (TreePath -> IO ()) -> IO ()Source

Call function for every expaned row.

treeViewRowExpanded Source

Arguments

:: TreeViewClass self
=> self
-> TreePath	`path` - A `TreePath` to test expansion state.
-> IO Bool	returns `True` if `path` is expanded.

Check if row is expanded.

treeViewGetReorderable :: TreeViewClass self => self -> IO Bool Source

Query if rows can be moved around.

See treeViewSetReorderable.

treeViewSetReorderable :: TreeViewClass self => self -> Bool -> IO ()Source

Check if rows can be moved around.

Set whether the user can use drag and drop (DND) to reorder the rows in the store. This works on both TreeStore and ListStore models. If ro 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 signals. If you need to control which rows may be dragged or where rows may be dropped, you can override the treeDragSourceRowDraggable function in the default DND implementation of the model.

treeViewGetPathAtPos :: TreeViewClass self => self -> Point -> IO (Maybe (TreePath, TreeViewColumn, Point))Source

Map a pixel to the specific cell.

Finds the path at the Point (x, y). The coordinates x and y are relative to the top left corner of the TreeView drawing window. As such, coordinates in a mouse click event can be used directly to determine the cell which the user clicked on. This function is useful to realize popup menus.
The returned point is the input point relative to the cell's upper left corner. The whole TreeView is divided between all cells. The returned point is relative to the rectangle this cell occupies within the TreeView.

treeViewGetCellArea :: TreeViewClass self => self -> Maybe TreePath -> TreeViewColumn -> IO Rectangle Source

Retrieve the smallest bounding box of a cell.

Fills the bounding rectangle in tree window coordinates for the cell at the row specified by tp and the column specified by tvc. If path is Nothing or points to a path not currently displayed, the y and height fields of the Rectangle will be filled with 0. The sum of all cell rectangles does not cover the entire tree; there are extra pixels in between rows, for example.

treeViewGetBackgroundArea :: TreeViewClass self => self -> Maybe TreePath -> TreeViewColumn -> IO Rectangle Source

Retrieve the largest bounding box of a cell.

Fills the bounding rectangle in tree window coordinates for the cell at the row specified by tp and the column specified by tvc. If path is Nothing or points to a path not currently displayed, the y and height fields of the Rectangle will be filled with 0. The background areas tile the widget's area to cover the entire tree window (except for the area used for header buttons). Contrast this with treeViewGetCellArea.

treeViewGetVisibleRect :: TreeViewClass self => self -> IO Rectangle Source

Retrieve the currently visible area.

The returned rectangle gives the visible part of the tree in tree coordinates.

treeViewConvertBinWindowToTreeCoords Source

Arguments

:: TreeViewClass self
=> self
-> Point	`(bx, by)` - bin window X and Y coordinates
-> IO Point	`(tx, ty)` returns tree X and Y coordinates

Converts bin window coordinates to coordinates for the tree (the full scrollable area of the tree).

treeViewConvertBinWindowToWidgetCoords Source

Arguments

:: TreeViewClass self
=> self
-> Point	`(bx, by)` - bin window X and Y coordinates
-> IO Point	`(wx, wy)` returns widget X and Y coordinates

Converts bin window coordinates (see treeViewGetBinWindow to widget relative coordinates.

treeViewConvertTreeToBinWindowCoords Source

Arguments

:: TreeViewClass self
=> self
-> Point	`(tx, ty)` - tree X and Y coordinates
-> IO Point	`(bx, by)` returns bin window X and Y coordinates

Converts tree coordinates (coordinates in full scrollable area of the tree) to bin window coordinates.

treeViewConvertTreeToWidgetCoords Source

Arguments

:: TreeViewClass self
=> self
-> Point	`(tx, ty)` - tree X and Y coordinates
-> IO Point	`(wx, wy)` returns widget X and Y coordinates

Converts tree coordinates (coordinates in full scrollable area of the tree) to widget coordinates.

treeViewConvertWidgetToBinWindowCoords Source

Arguments

:: TreeViewClass self
=> self
-> Point	`(wx, wy)` - widget X and Y coordinates
-> IO Point	`(bx, by)` returns bin window X and Y coordinates

Converts widget coordinates to coordinates for the window (see treeViewGetBinWindow ).

treeViewConvertWidgetToTreeCoords Source

Arguments

:: TreeViewClass self
=> self
-> Point	`(wx, wy)` - bin window X and Y coordinates
-> IO Point	`(tx, ty)` returns tree X and Y coordinates

Converts widget coordinates to coordinates for the tree (the full scrollable area of the tree).

treeViewCreateRowDragIcon :: TreeViewClass self => self -> TreePath -> IO Pixmap Source

Creates a Pixmap representation of the row at the given path. This image can be used for a drag icon.

treeViewGetEnableSearch :: TreeViewClass self => self -> IO Bool Source

Returns whether or not the tree allows to start interactive searching by typing in text.

If enabled, the user can type in text which will set the cursor to the first matching entry.

treeViewSetEnableSearch :: TreeViewClass self => self -> Bool -> IO ()Source

If this is set, then the user can type in text to search through the tree interactively (this is sometimes called "typeahead find").

Note that even if this is False, the user can still initiate a search using the "start-interactive-search" key binding. In any case, a predicate that compares a row of the model with the text the user has typed must be set using treeViewSetSearchEqualFunc.

treeViewGetSearchColumn Source

Arguments

:: TreeViewClass self
=> self
-> IO (ColumnId row String)	returns the column the interactive search code searches in.

Gets the column searched on by the interactive search code.

treeViewSetSearchColumn Source

Arguments

:: TreeViewClass self
=> self
-> ColumnId row String	`column` - the column of the model to search in, or -1 to disable searching
-> IO ()

Sets column as the column where the interactive search code should search in.

If the sort column is set, users can use the "start-interactive-search" key binding to bring up search popup. The enable-search property controls whether simply typing text will also start an interactive search.

Note that column refers to a column of the model. Furthermore, the search column is not used if a comparison function is set, see treeViewSetSearchEqualFunc.

treeViewSetSearchEqualFunc :: TreeViewClass self => self -> Maybe (String -> TreeIter -> IO Bool) -> IO ()Source

Set the predicate to test for equality.

The predicate must returns True if the text entered by the user and the row of the model match. Calling this function will overwrite the treeViewSearchColumn (which isn't used anyway when a comparison function is installed).

treeViewGetFixedHeightMode Source

Arguments

:: TreeViewClass self
=> self
-> IO Bool	returns `True` if the tree view is in fixed height mode

Returns whether fixed height mode is turned on for the tree view.

Available since Gtk+ version 2.6

treeViewSetFixedHeightMode Source

Arguments

:: TreeViewClass self
=> self
-> Bool	`enable` - `True` to enable fixed height mode
-> IO ()

Enables or disables the fixed height mode of the tree view. 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 type TreeViewColumnFixed.

Available since Gtk+ version 2.6

treeViewGetHoverSelection Source

Arguments

:: TreeViewClass self
=> self
-> IO Bool	returns `True` if the tree view is in hover selection mode

Returns whether hover selection mode is turned on for treeView.

Available since Gtk+ version 2.6

treeViewSetHoverSelection Source

Arguments

:: TreeViewClass self
=> self
-> Bool	`hover` - `True` to enable hover selection mode
-> IO ()

Enables of disables the hover selection mode of the tree view. Hover selection makes the selected row follow the pointer. Currently, this works only for the selection modes SelectionSingle and SelectionBrowse.

Available since Gtk+ version 2.6

treeViewGetHoverExpand Source

Arguments

:: TreeViewClass self
=> self
-> IO Bool	returns `True` if the tree view is in hover expansion mode

Returns whether hover expansion mode is turned on for the tree view.

Available since Gtk+ version 2.6

treeViewSetHoverExpand Source

Arguments

:: TreeViewClass self
=> self
-> Bool	`expand` - `True` to enable hover selection mode
-> IO ()

Enables of disables the hover expansion mode of the tree view. Hover expansion makes rows expand or collaps if the pointer moves over them.

Available since Gtk+ version 2.6

treeViewGetHeadersClickable Source

Arguments

:: TreeViewClass self
=> self
-> IO Bool	returns `True` if all header columns are clickable, otherwise `False`

Returns whether all header columns are clickable.

Available since Gtk+ version 2.10

treeViewGetVisibleRange Source

Arguments

:: TreeViewClass self
=> self
-> IO (TreePath, TreePath)	the first and the last node that is visible

Return the first and last visible path. Note that there may be invisible paths in between.

Available since Gtk+ version 2.8

treeViewEnableModelDragDest Source

Arguments

:: TreeViewClass self
=> self
-> TargetList	`targets` - the list of targets that the the view will support
-> [DragAction]	`actions` - flags denoting the possible actions for a drop into this widget
-> IO ()

Turns treeView into a drop destination for automatic DND.

treeViewEnableModelDragSource Source

Arguments

:: TreeViewClass self
=> self
-> [Modifier]	`startButtonMask` - Mask of allowed buttons to start drag
-> TargetList	`targets` - the list of targets that the the view will support
-> [DragAction]	`actions` - flags denoting the possible actions for a drag from this widget
-> IO ()

Turns treeView into a drag source for automatic DND.

treeViewUnsetRowsDragSource :: TreeViewClass self => self -> IO ()Source

Undoes the effect of treeViewEnableModelDragSource.

treeViewUnsetRowsDragDest :: TreeViewClass self => self -> IO ()Source

Undoes the effect of treeViewEnableModelDragDest.

treeViewGetSearchEntry Source

Arguments

:: TreeViewClass self
=> self
-> IO (Maybe Entry)	returns the entry currently in use as search entry.

Returns the Entry which is currently in use as interactive search entry for treeView. In case the built-in entry is being used, Nothing will be returned.

Available since Gtk+ version 2.10

treeViewSetSearchEntry Source

Arguments

:: (TreeViewClass self, EntryClass entry)
=> self
-> Maybe entry	`entry` - the entry the interactive search code of `treeView` should use or `Nothing`
-> IO ()

Sets the entry which the interactive search code will use for this treeView. This is useful when you want to provide a search entry in our interface at all time at a fixed position. Passing Nothing for entry will make the interactive search code use the built-in popup entry again.

Available since Gtk+ version 2.10

treeViewSetRowSeparatorFunc Source

Arguments

:: TreeViewClass self
=> self
-> Maybe (TreeIter -> IO Bool)	`func` - a callback function that returns `True` if the given row of the model should be drawn as separator
-> IO ()

Sets the row separator function, which is used to determine whether a row should be drawn as a separator. If the row separator function is Nothing, no separators are drawn. This is the default value.

Available since Gtk+ version 2.6

treeViewGetRubberBanding Source

Arguments

:: TreeViewClass self
=> self
-> IO Bool	returns `True` if rubber banding in `treeView` is enabled.

Returns whether rubber banding is turned on for treeView. If the selection mode is SelectionMultiple, rubber banding will allow the user to select multiple rows by dragging the mouse.

Available since Gtk+ version 2.10

treeViewSetRubberBanding Source

Arguments

:: TreeViewClass self
=> self
-> Bool	`enable` - `True` to enable rubber banding
-> IO ()

Enables or disables rubber banding in treeView. If the selection mode is SelectionMultiple, rubber banding will allow the user to select multiple rows by dragging the mouse.

Available since Gtk+ version 2.10

treeViewGetEnableTreeLines Source

Arguments

:: TreeViewClass self
=> self
-> IO Bool	returns `True` if tree lines are drawn in `treeView`, `False` otherwise.

Returns whether or not tree lines are drawn in treeView.

Available since Gtk+ version 2.10

treeViewSetEnableTreeLines Source

Arguments

:: TreeViewClass self
=> self
-> Bool	`enabled` - `True` to enable tree line drawing, `False` otherwise.
-> IO ()

Sets whether to draw lines interconnecting the expanders in treeView. This does not have any visible effects for lists.

Available since Gtk+ version 2.10

treeViewGetGridLines Source

Arguments

:: TreeViewClass self
=> self
-> IO TreeViewGridLines	returns a `TreeViewGridLines` value indicating which grid lines are enabled.

Returns which grid lines are enabled in treeView.

Available since Gtk+ version 2.10

treeViewSetGridLines Source

Arguments

:: TreeViewClass self
=> self
-> TreeViewGridLines	`gridLines` - a `TreeViewGridLines` value indicating which grid lines to enable.
-> IO ()

Sets which grid lines to draw in treeView.

Available since Gtk+ version 2.10

treeViewSetTooltipRow Source

Arguments

:: TreeViewClass self
=> self
-> Tooltip	the `tooltip`
-> TreePath	`path` - the position of the `tooltip`
-> IO ()

Sets the tip area of tooltip to be the area covered by path. See also treeViewTooltipColumn for a simpler alternative. See also tooltipSetTipArea.

treeViewSetTooltipCell Source

Arguments

:: (TreeViewClass self, TreeViewColumnClass col, CellRendererClass renderer)
=> self
-> Tooltip	the `tooltip`
-> Maybe TreePath	`path` at which the tip should be shown
-> Maybe col	`column` at which the tip should be shown
-> Maybe renderer	the `renderer` for which to show the tip
-> IO ()

Sets the tip area of tooltip to the area path, column and cell have in common. For example if path is Nothing and column is set, the tip area will be set to the full area covered by column. See also tooltipSetTipArea. Note that if path is not specified and cell is set and part of a column containing the expander, the tooltip might not show and hide at the correct position. In such cases path must be set to the current node under the mouse cursor for this function to operate correctly. See also treeViewTooltipColumn for a simpler alternative.

treeViewGetTooltipContext Source

Arguments

:: TreeViewClass self
=> self
-> Maybe Point	`point` - the coordinates of the mouse or `Nothing` if a keyboard tooltip is to be generated
-> IO (Maybe TreeIter)	`Just iter` if a tooltip should be shown for that row

This function is supposed to be used in a widgetQueryTooltip signal handler for this TreeView. The point value which is received in the signal handler should be passed to this function without modification. A return value of Just iter indicates that there is a tree view row at the given coordinates (if Just (x,y) is passed in, denoting a mouse position), resp. the cursor row (if Nothing is passed in, denoting a keyboard request).

Attributes

treeViewModel :: (TreeViewClass self, TreeModelClass model) => ReadWriteAttr self (Maybe TreeModel) modelSource

The model for the tree view.

treeViewHAdjustment :: TreeViewClass self => Attr self (Maybe Adjustment)Source

Horizontal Adjustment for the widget.

treeViewVAdjustment :: TreeViewClass self => Attr self (Maybe Adjustment)Source

Vertical Adjustment for the widget.

treeViewHeadersVisible :: TreeViewClass self => Attr self Bool Source

Show the column header buttons.

Default value: True

treeViewHeadersClickable :: TreeViewClass self => Attr self Bool Source

Column headers respond to click events.

Default value: False

treeViewExpanderColumn :: TreeViewClass self => ReadWriteAttr self TreeViewColumn (Maybe TreeViewColumn)Source

Set the column for the expander column.

treeViewReorderable :: TreeViewClass self => Attr self Bool Source

View is reorderable.

Default value: False

treeViewRulesHint :: TreeViewClass self => Attr self Bool Source

Set a hint to the theme engine to draw rows in alternating colors.

Default value: False

treeViewEnableSearch :: TreeViewClass self => Attr self Bool Source

View allows user to search through columns interactively.

Default value: True

treeViewSearchColumn :: TreeViewClass self => Attr self (ColumnId row String)Source

Model column to search through when searching through code.

Default value: invalidColumnId

treeViewFixedHeightMode :: TreeViewClass self => Attr self Bool Source

Setting the treeViewFixedHeightMode property to True speeds up TreeView by assuming that all rows have the same height. Only enable this option if all rows are the same height. Please see treeViewSetFixedHeightMode for more information on this option.

Default value: False

Available since Gtk+ version 2.4

treeViewHoverSelection :: TreeViewClass self => Attr self Bool Source

Enables of disables the hover selection mode of treeView. Hover selection makes the selected row follow the pointer. Currently, this works only for the selection modes SelectionSingle and SelectionBrowse.

This mode is primarily intended for TreeViews in popups, e.g. in ComboBox or EntryCompletion.

Default value: False

Available since Gtk+ version 2.6

treeViewHoverExpand :: TreeViewClass self => Attr self Bool Source

Enables of disables the hover expansion mode of treeView. Hover expansion makes rows expand or collaps if the pointer moves over them.

This mode is primarily intended for TreeViews in popups, e.g. in ComboBox or EntryCompletion.

Default value: False

Available since Gtk+ version 2.6

treeViewShowExpanders :: TreeViewClass self => Attr self Bool Source

View has expanders.

Default value: True

treeViewLevelIndentation :: TreeViewClass self => Attr self Int Source

Extra indentation for each level.

Allowed values: >= 0

Default value: 0

treeViewRubberBanding :: TreeViewClass self => Attr self Bool Source

Whether to enable selection of multiple items by dragging the mouse pointer.

Default value: False

treeViewEnableGridLines :: TreeViewClass self => Attr self TreeViewGridLines Source

Whether grid lines should be drawn in the tree view.

Default value: TreeViewGridLinesNone

treeViewEnableTreeLines :: TreeViewClass self => Attr self Bool Source

Whether tree lines should be drawn in the tree view.

Default value: False

treeViewGridLines :: TreeViewClass self => Attr self TreeViewGridLines Source

'gridLines' property. See treeViewGetGridLines and treeViewSetGridLines

treeViewSearchEntry :: (TreeViewClass self, EntryClass entry) => ReadWriteAttr self (Maybe Entry) (Maybe entry)Source

'searchEntry' property. See treeViewGetSearchEntry and treeViewSetSearchEntry

treeViewTooltipColumn :: TreeViewClass self => Attr self (ColumnId row String)Source

The column for which to show tooltips.

If you only plan to have simple (text-only) tooltips on full rows, you can use this function to have TreeView handle these automatically for you. column should be set to a column in model containing the tooltip texts, or -1 to disable this feature. When enabled, widgetHasTooltip will be set to True and this view will connect to the widgetQueryTooltip signal handler.

Note that the signal handler sets the text as Markup, so &, <, etc have to be escaped in the text.

Default value: invalidColumnId

Signals

columnsChanged :: TreeViewClass self => Signal self (IO ())Source

The number of columns of the treeview has changed.

cursorChanged :: TreeViewClass self => Signal self (IO ())Source

The position of the cursor (focused cell) has changed.

rowCollapsed :: TreeViewClass self => Signal self (TreeIter -> TreePath -> IO ())Source

The given row has been collapsed (child nodes are hidden).

rowExpanded :: TreeViewClass self => Signal self (TreeIter -> TreePath -> IO ())Source

The given row has been expanded (child nodes are shown).

rowActivated :: TreeViewClass self => Signal self (TreePath -> TreeViewColumn -> IO ())Source

A row was activated.

Activation usually means the user has pressed return on a row.

testCollapseRow :: TreeViewClass self => Signal self (TreeIter -> TreePath -> IO Bool)Source

The given row is about to be collapsed (hide its children nodes). Use this signal if you need to control the collapsibility of individual rows.

testExpandRow :: TreeViewClass self => Signal self (TreeIter -> TreePath -> IO Bool)Source

The given row is about to be expanded (show its children nodes). Use this signal if you need to control the expandability of individual rows.

Deprecated

treeViewWidgetToTreeCoords Source

Arguments

:: TreeViewClass self
=> self
-> Point	`(wx, wy)` - widget X and Y coordinates
-> IO Point	`(tx, ty)` returns tree X and Y coordinates

treeViewWidgetToTreeCoords has been deprecated since version 2.12 and should not be used in newly-written code. Due to historial reasons the name of this function is incorrect. For converting coordinates relative to the widget to bin window coordinates, please see treeViewConvertWidgetToBinWindowCoords.

Converts bin window coordinates to coordinates for the tree (the full scrollable area of the tree).

treeViewTreeToWidgetCoords Source

Arguments

:: TreeViewClass self
=> self
-> Point	`(tx, ty)` - tree X and Y coordinates
-> IO Point	`(wx, wy)` returns widget X and Y coordinates

treeViewTreeToWidgetCoords has been deprecated since version 2.12 and should not be used in newly-written code. Due to historial reasons the name of this function is incorrect. For converting bin window coordinates to coordinates relative to bin window, please see treeViewConvertBinWindowToWidgetCoords.

Converts tree coordinates (coordinates in full scrollable area of the tree) to bin window coordinates.

onColumnsChanged, afterColumnsChanged :: TreeViewClass self => self -> IO () -> IO (ConnectId self)Source

The user has dragged a column to another position.

onCursorChanged, afterCursorChanged :: TreeViewClass self => self -> IO () -> IO (ConnectId self)Source

The cursor in the tree has moved.

onRowActivated, afterRowActivated :: TreeViewClass self => self -> (TreePath -> TreeViewColumn -> IO ()) -> IO (ConnectId self)Source

A row was activated.

Activation usually means the user has pressed return on a row.

onRowCollapsed, afterRowCollapsed :: TreeViewClass self => self -> (TreeIter -> TreePath -> IO ()) -> IO (ConnectId self)Source

Children of this node were hidden.

onRowExpanded, afterRowExpanded :: TreeViewClass self => self -> (TreeIter -> TreePath -> IO ()) -> IO (ConnectId self)Source

Children of this node are made visible.

onStartInteractiveSearch, afterStartInteractiveSearch :: TreeViewClass self => self -> IO () -> IO (ConnectId self)Source

The user wants to search interactively.

Connect to this signal if you want to provide you own search facility. Note that you must handle all keyboard input yourself.

onTestCollapseRow, afterTestCollapseRow :: TreeViewClass self => self -> (TreeIter -> TreePath -> IO Bool) -> IO (ConnectId self)Source

Determine if this row should be collapsed.

If the application connects to this function and returns False, the specifc row will not be altered.

onTestExpandRow, afterTestExpandRow :: TreeViewClass self => self -> (TreeIter -> TreePath -> IO Bool) -> IO (ConnectId self)Source

Determine if this row should be expanded.

If the application connects to this function and returns False, the specifc row will not be altered.