gtk.IconView
gtk.IconView — a widget which displays a list of icons in a grid (new in PyGTK 2.6)
Synopsis
Ancestry
+--gobject.GObject +-- gtk.Object +-- gtk.Widget +-- gtk.Container +-- gtk.IconView (implements gtk.CellLayout)
gtk.IconView Properties
|
gtk.IconView Style Properties
|
gtk.IconView Signal Prototypes
gtk.Container Signal Prototypes
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( | |
def callback( |
Description
Note
This widget is available in PyGTK 2.6 and above.
The gtk.IconView
widget provides an alternative view of a gtk.ListStore
model. It displays the model as a grid of icons with labels. Like gtk.TreeView
, you
can select one or multiple items (depending on the selection mode, see the
set_selection_mode
()
method for more information). In addition to selection with the arrow keys,
gtk.IconView
supports rubberband selection, which is controlled by dragging the
pointer.
Constructor
gtk.IconView(model
=None)
| A gtk.TreeModel , or
None |
Returns : | a new gtk.IconView
widget. |
Note
This constructor is available in PyGTK 2.6 and above.
Creates a new gtk.IconView
widget. If model
is specified and not
None
it should specify a gtk.TreeModel
to
be used as the model.
Methods
gtk.IconView.set_model
def set_model(model
=None)
| a gtk.TreeModel
or None |
Note
This method is available in PyGTK 2.6 and above.
The set_model
() method sets the "model"
property to the gtk.TreeModel
specified by model
. If model
is None
the old model will be unset.
gtk.IconView.get_model
def get_model()
Returns : | The gtk.TreeModel
used by the cell view or None . |
Note
This method is available in PyGTK 2.6 and above.
The get_model
() method returns the
value of the "model" property which contains the gtk.TreeModel
used by the cell view. If no model is being used this method returns
None
.
gtk.IconView.set_text_column
def set_text_column(column
)
| The index of a column in the model or -1 to unset the column |
Note
This method is available in PyGTK 2.6 and above.
The set_text_column
() method sets the
"text-column" property to the value of column
which
should be the index of a column in the model containing strings to be used
for text. If column
is -1 the text column is
unset.
gtk.IconView.get_text_column
def get_text_column()
Returns : | The index of a model's column or -1 if unset. |
Note
This method is available in PyGTK 2.6 and above.
The get_text_column
() method returns
the value of the "text-column" property which contains the index of the
column in the model that provides strings to be used for text. If the
"text-column" property contains -1 then no column is used for text.
gtk.IconView.set_markup_column
def set_markup_column(column
)
| The index of a column in the model or -1. |
Note
This method is available in PyGTK 2.6 and above.
The set_markup_column
() method sets the
"markup-column" property to the value specified by
column
. The "markup-column" property indicates the
index of a column in the model to be used for markup information. If
column
is -1 the markup column will be unset. If the
markup column is set, it overrides the text column set by the set_text_column
()
method.
gtk.IconView.get_markup_column
def get_markup_column()
Returns : | the index of the model column containing markup or -1. |
Note
This method is available in PyGTK 2.6 and above.
The get_markup_column
method returns
the value of the "markup-column" property which contains the index of the
column in the model that contains the Pango markup for text. if the
"markup-column" property is -1, the markup column is unset.
gtk.IconView.set_pixbuf_column
def set_pixbuf_column(column
)
| the index of a model column or -1 |
Note
This method is available in PyGTK 2.6 and above.
The set_pixbuf_column
() method sets the
"pixbuf-column" property to the value of column
. If
column >= 0 the icon view gtk.gdk.Pixbuf
objects will be retrieved from the specified column. If
column
is -1 then no pixbufs will be used,
gtk.IconView.get_pixbuf_column
def get_pixbuf_column()
Returns : | The index of a column in the model or -1 |
Note
This method is available in PyGTK 2.6 and above.
The get_pixbuf_column
() returns the
value of the "pixbuf-column" property which contains the index of the model
column use to to retrieve gtk.gdk.Pixbuf
objects to display. If the "pixbuf-column" property is -1 no pixbufs will be
retrieved.
gtk.IconView.get_path_at_pos
def get_path_at_pos(x
, y
)
| the x coordinate |
| the y coordinate |
Returns : | the path at the specified point or
None . |
Note
This method is available in PyGTK 2.6 and above.
The get_path_at_pos
() method returns
the model path of the icon located at the coordinates specified by
(x
, y
). This method returns
None
if there is no icon at the specified
location.
gtk.IconView.get_item_at_pos
def get_item_at_pos(x
, y
)
| the x coordinate |
| the y coordinate |
Returns : | a 2-tuple comtaining the path and the cell
renderer at the specified point or None if the is no item
at the position. |
Note
This method is available in PyGTK 2.8 and above.
The get_item_at_pos
() method returns a
2-tuple containing the model path and cell renderer of the icon located at
the coordinates specified by (x
,
y
). This method returns None
if
there is no item at the specified location.
gtk.IconView.set_cursor
def set_cursor(path
, cell
=None, start_editing
=False)
| a tree path |
| a gtk.CellRenderer
or None |
| if True the specified cell
should start being edited |
Note
This method is available in PyGTK 2.8 and above.
The set_cursor
() method sets the
current keyboard focus to be at the location specified by
path
, and selects it. This is useful when you want to
focus the user's attention on a particular item. If
cell
is not None
, then focus is
given to the specified cell. Additionally, if
start_editing
is True
, then
editing should be started in the specified cell.
This method is often followed by gtk.Widget.grab_focus
()
in order to give keyboard focus to the icon view. Please note that editing
can only happen when the icon view is realized.
Note
In PyGTK 2.8 cell
and
start_editing
must be specified. Also
cell
cannot be None
.
gtk.IconView.get_cursor
def get_cursor()
Returns : | a 2-tuple containing the current cursor path
and cell renderer or None if the cursor isn't
set. |
Note
This method is available in PyGTK 2.8 and above.
The get_cursor
() method returns a
2-tuple containing the model path and gtk.CellRenderer
at the current cursor location. This method returns None
if the cursor is not set. If no cell renderer has focus then
None
will be returned for the cell renderer value.
gtk.IconView.selected_foreach
def selected_foreach(func
, data
)
| a callback function or method. |
| User data to pass to
func . |
Note
This method is available in PyGTK 2.6 and above.
The selected_foreach
() method calls the
callback function or method specified by func
for
each selected icon. The signature of func
is:
def func(iconview
,path
,user_data
):
where iconview
is the gtk.IconView
,
path
is the tree path of the icon row and
user_data
is data.
gtk.IconView.set_selection_mode
def set_selection_mode(mode
)
| The selection mode. |
Note
This method is available in PyGTK 2.6 and above.
The set_selection_mode
() method sets
the "selection-mode" property to the value of
mode
. mode
should be one of
the GTK Selection Mode Constants.
gtk.IconView.get_selection_mode
def get_selection_mode()
Returns : | the selection mode. |
Note
This method is available in PyGTK 2.6 and above.
The get_selection_mode
() method returns
the value of the "selection-mode" property which contains one of the GTK Selection Mode Constants.
gtk.IconView.set_orientation
def set_orientation(orientation
)
| the relative position of the icon and text. |
Note
This method is available in PyGTK 2.6 and above.
The set_orientation
() method sets the
"orientation" property to the value of
orientation
. orientation
should contain one of the GTK Orientation Constants. The "orientation"
property indicates the relative positioning of the icon and text.
gtk.IconView.get_orientation
def get_orientation(
,
)
Returns : | the relative position of the icon and text. |
Note
This method is available in PyGTK 2.6 and above.
The get_orientation
() method returns
the value of the "orientation" property that indicates the relative position
between the icon and text. See the set_orientation
()
method for more information.
gtk.IconView.set_columns
def set_columns(columns
)
| the number of columns in a row. |
Note
This method is available in PyGTK 2.6 and above.
The set_columns
() method sets the
"columns" property to the value of
columns
. columns
should
contain the number of columns to be displayed in each row or -1 to fit as
many columns as possible per row.
gtk.IconView.get_columns
def get_columns()
Returns : | the number of columns per row or -1. |
Note
This method is available in PyGTK 2.6 and above.
The get_columns
() method returns the
value of the "columns" property that indicates the number of columns per
row. See the set_columns
()
method for more information.
gtk.IconView.set_item_width
def set_item_width(item_width
)
| The space used to display an item or -1 to use the width of the largest item. |
Note
This method is available in PyGTK 2.6 and above.
The set_item_width
() method sets the
"item-width" property to the value of
item_width
. item_width
should
contain the maximum space (in pixels) to use to display an item in the icon
view or -1 to use the width of the largest item.
gtk.IconView.get_item_width
def get_item_width()
Returns : | the space available for displaying an item or -1. |
Note
This method is available in PyGTK 2.6 and above.
The get_item_width
() method returns the
value of the "item-width" property that contains the space available for
displaying an item. See the set_item_width
()
method for more information.
gtk.IconView.set_spacing
def set_spacing(spacing
)
| The space between the cells of an item in the icon view |
Note
This method is available in PyGTK 2.6 and above.
The set_spacing
() method sets the
"spacing" property to the value of
spacing
. spacing
should
contain the space in pixels that is inserted between the cells of an item in
the icon view.
gtk.IconView.get_spacing
def get_spacing()
Returns : | the space in pixels that is inserted between cells in the icon view. |
Note
This method is available in PyGTK 2.6 and above.
The get_spacing
() method returns the
value of the "spacing" property that contains the space in pixels that is
inserted between the cells of an item in the icon view. See the set_spacing
()
method for more information.
gtk.IconView.set_row_spacing
def set_row_spacing(row_spacing
)
| the space between rows in the icon view. |
Note
This method is available in PyGTK 2.6 and above.
The set_row_spacing
() method sets the
"row-spacing" property to the value of
row_spacing
. row_spacing
should contain the space in pixels to be inserted between rows in the icon
view..
gtk.IconView.get_row_spacing
def get_row_spacing()
Returns : | the space between rows in the icon view. |
Note
This method is available in PyGTK 2.6 and above.
The get_row_spacing
() method returns
the value of the "row-spacing" property that contains the space in pixels
inserted between the rows in the icon view. See the set_row_spacing
()
method for more information.
gtk.IconView.set_column_spacing
def set_column_spacing(column_spacing
)
| The space inserted between columns in the icon view |
Note
This method is available in PyGTK 2.6 and above.
The set_column_spacing
() method sets
the "column-spacing" property to the value of
column_spacing
. column_spacing
should contain the space in pixels to be inserted between columns in the
icon view.
gtk.IconView.get_column_spacing
def get_column_spacing()
Returns : | the space between columns in the icon view. |
Note
This method is available in PyGTK 2.6 and above.
The get_column_spacing
() method returns
the value of the "column-spacing" property that contains the space in pixels
between the columns in the icon view. See the set_column_spacing
()
method for more information.
gtk.IconView.set_margin
def set_margin(margin
)
| the space inserted at the edges of the icon view. |
Note
This method is available in PyGTK 2.6 and above.
The set_margin
() method sets the
"margin" property to the value of
margin
. margin
should contain
the space in pixels to be inserted at the edges of the icon view.
gtk.IconView.get_margin
def get_margin()
Returns : | the space inserted at the edges of the icon view. |
Note
This method is available in PyGTK 2.6 and above.
The get_margin
() method returns the
value of the "margin" property that continas the space in pixels inserted at
the edges of the icon view. See the set_margin
()
method for more information.
gtk.IconView.select_path
def select_path(path
)
| a path indicating the icon to be selected |
Note
This method is available in PyGTK 2.6 and above.
The select_path
method selects the icon
with the tree path specified by path
.
gtk.IconView.unselect_path
def unselect_path(path
)
| a path indicating the icon to be unselected |
Note
This method is available in PyGTK 2.6 and above.
The unselect_path
method unselects the
icon with the tree path specified by path
.
gtk.IconView.path_is_selected
def path_is_selected(path
)
| a path of an icon. |
Returns : | True if
path is selected. |
Note
This method is available in PyGTK 2.6 and above.
The path_is_selected
() method returns
True
if the icon with the tree path specified by
path
is selected.
gtk.IconView.get_selected_items
def get_selected_items()
Returns : | a list of the paths of the selected icons. |
Note
This method is available in PyGTK 2.6 and above.
The get_selected_items
() method returns
a list of the paths of the selected icons.
gtk.IconView.select_all
def select_all()
Note
This method is available in PyGTK 2.6 and above.
The select_all
() method selects all the
icons if the selection mode is set to
gtk.SELECTION_MULTIPLE
.
gtk.IconView.unselect_all
def unselect_all()
Note
This method is available in PyGTK 2.6 and above.
The unselect_all
() method unselects all
the icons.
gtk.IconView.item_activated
def item_activated(path
)
| a tree path pointing to an icon row. |
Note
This method is available in PyGTK 2.6 and above.
The item_activated
() method activates
the icon pointed to by the path specified by
path
.
gtk.IconView.scroll_to_path
def scroll_to_path(path
, use_align
, row_align
, col_align
)
| the path of the item to move to. |
| if True use the alignment
arguments |
| the vertical alignment of the item specified by
path . |
| The horizontal alignment of the item specified
by path . |
Note
This method is available in PyGTK 2.8 and above.
The scroll_to_path
() method moves the
alignments of the icon view to the position specified by
path
. row_align
determines
where the row is placed, and col_align
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.
If use_align
is False
,
then the alignment arguments are ignored, and the icon view does the
minimum amount of work to scroll the item onto the screen. This means that
the item will be scrolled to the edge closest to its current position. If
the item is currently visible on the screen, nothing is done.
This method only works if the model is set, and
path
is a valid row on the model. If the model
changes before the icon view is realized, the centered path will be
modified to reflect this change.
gtk.IconView.get_visible_range
def get_visible_range()
Returns : | a 2-tuple containing the start and end paths of
the visible region or None . |
Note
This method is available in PyGTK 2.8 and above.
The get_visible_range
() method returns
a 2-tuple containing the start and end paths for the visible region in the
iconview. If no valid paths are available this method returns
None
.
gtk.IconView.enable_model_drag_source
def enable_model_drag_source(start_button_mask
, targets
, actions
)
| the mask of buttons allowed to start drag |
| a sequence of 3-tuples containing target information that the drag will support |
| the combination of possible GDK Drag Action Constants for a drag from the iconview |
Note
This method is available in PyGTK 2.8 and above.
The enable_model_drag_source
() method
enables the iconview to be used as a drag source for automatic
DND. start_button_mask
specifies a combination of
the GDK Modifier Constants that can start the
drag. targets
is a sequence (tuple or list) of
3-tuples each containing target information: a string representing the drag
type, target flags (a combination of gtk.TARGET_SAME_APP
and gtk.TARGET_SAME_WIDGET
or neither) and an
application assigned integer ID used for identification
purposes. actions
is a combination of the GDK Drag Action Constants supported by the
iconview.
gtk.IconView.enable_model_drag_dest
def enable_model_drag_dest(targets
, actions
)
| a sequence of 3-tuples containing target information that the iconview will support for a drag drop |
| the combination of possible GDK Drag Action Constants for a drag drop onto to the iconview |
Note
This method is available in PyGTK 2.8 and above.
The enable_model_drag_dest
() method
enables the iconview to be a destination for a drag
drop. targets
is a sequence (tuple or list) of
3-tuples each containing target information: a string representing the drag
type, target flags (a combination of gtk.TARGET_SAME_APP
and gtk.TARGET_SAME_WIDGET
or neither) and an application
assigned integer ID used for identification
purposes. actions
is a combination of the GDK Drag Action Constants supported by the
iconview.
gtk.IconView.unset_model_drag_source
def unset_model_drag_source()
Note
This method is available in PyGTK 2.8 and above.
The unset_model_drag_source
() method
undoes the effect of the enable_model_drag_source
()
method.
gtk.IconView.unset_model_drag_dest
def unset_model_drag_dest()
Note
This method is available in PyGTK 2.8 and above.
The unset_model_drag_dest
() method
undoes the effect of the enable_model_drag_dest
()
method.
gtk.IconView.set_reorderable
def set_reorderable(reorderable
)
| if True the items are
reorderable. |
Note
This method is available in PyGTK 2.8 and above.
The set_reorderable
() method sets the
"reorderable" property to the value of
reorderable
. If reorderable
is
True
the user can reorder the model by dragging and
dropping rows. The developer can listen to these changes by connecting to
the model's "row_inserted" and "row_deleted" signals.
This method does not give you any degree of control over the order -- any reordering is allowed. If more control is needed, you should probably handle drag and drop manually.
gtk.IconView.get_reorderable
def get_reorderable()
Returns : | True if the iconview list
can be reordered. |
Note
This method is available in PyGTK 2.8 and above.
The get_reorderable
() method returns
the value of the "reorderable" property. If "reorderable" is
True
the user can reorder iconview using
drag-and-drop.
gtk.IconView.set_drag_dest_item
def set_drag_dest_item(path
, pos
)
| the path of the item to highlight, or
None . |
| specifies where to drop, relative to the item |
Note
This method is available in PyGTK 2.8 and above.
The set_drag_dest_item
() method
highlights for feedback the item specified by
path
. pos
is one of the GTK IconView Drop Position Constants that specifies
where the drop is to take place relative to the receiving item.
In PyGTK 2.10 and above, path
may be
None
.
gtk.IconView.get_drag_dest_item
def get_drag_dest_item()
Returns : | a 2-tuple containing the path of the highlighted
item and one of the GTK IconView Drop Position Constants specifying the
relative drop location or None . |
Note
This method is available in PyGTK 2.8 and above.
The get_drag_dest_item
() method returns
a 2-tuple containing the path of the highlighted item and one of the GTK IconView Drop Position Constants specifying the
drop location relative to the receiving item. If there is no highlighted
item, this method returns None
.
gtk.IconView.get_dest_item_at_pos
def get_dest_item_at_pos(drag_x
, drag_y
)
| the X position |
| the Y position |
Returns : | a 2-tuple containing the path of the highlighted item and a relative drop location. |
Note
This method is available in PyGTK 2.8 and above.
The get_dest_item_at_pos
() method
returns a 2-tuple containing the path of the highlighted item at the
location specified by drag_x
and
drag_y
and the drop location relative to the
receiving item. If there is no highlighted item, this method returns
None
.
gtk.IconView.create_drag_icon
def create_drag_icon(path
)
| a path |
Returns : | a gtk.gdk.Pixmap of the
drag icon. |
Note
This method is available in PyGTK 2.8 and above.
The create_drag_icon
() method returns a
gtk.gdk.Pixmap
representation of the item at the location specified by
path
. The return image can be used for a drag
icon.
gtk.IconView.convert_widget_to_bin_window_coords
def convert_widget_to_bin_window_coords(widget_x
, widget_y
)
| X coordinate relative to the widget. |
| Y coordinate relative to the widget. |
Returns : | A tuple containing the bin_window X and Y coordinates. |
Note
This method is available in PyGTK 2.12 and above.
Converts widget coordinates to coordinates for the bin_window, as expected by e.g.
get_path_at_pos
.
gtk.IconView.set_tooltip_cell
def set_tooltip_cell(tooltip
, path
, cell
)
| A tooltip. |
| A path. |
| A cell renderer or None . |
Note
This method is available in PyGTK 2.12 and above.
The set_tooltip_cell
() method sets the tip area of
tooltip
to the area which cell
occupies in the item pointed to by path
.
See also
().
gtk.IconView.set_tooltip_column
def set_tooltip_column(column
)
| An integer, which is a valid column number for icon_view's model |
Note
This method is available in PyGTK 2.12 and above.
If you only plan to have simple (text-only) tooltips on full items, you can use this function to have GtkIconView handle these automatically for you. column should be set to the column in icon_view's model containing the tooltip texts, or -1 to disable this feature.
When enabled, GtkWidget::has-tooltip will be set to True
and icon_view will connect a GtkWidget::query-tooltip signal handler.
gtk.IconView.get_tooltip_column
def get_tooltip_column()
Returns : | The index of the tooltip column that is currently being used, or -1 if this is disabled. |
Note
This method is available in PyGTK 2.12 and above.
The get_tooltip_column
() method returns the column of
icon_view's model which is being used for displaying tooltips on icon_view's rows.
gtk.IconView.set_tooltip_item
def set_tooltip_cell(tooltip
, path
)
| A tooltip. |
| A path. |
Note
This method is available in PyGTK 2.12 and above.
The set_tooltip_item
() method sets the tip area of
tooltip
to be the area covered by the item at
path
. See also
().
gtk.IconView.get_item_row
def get_item_row(path
)
| The path of the item. |
Returns : | The row in which the item is displayed. |
Note
This method is available in PyGTK 2.22 and above.
The get_item_row
() method gets the row in which the
item path is currently displayed. Row numbers start at 0.
gtk.IconView.get_item_column
def get_item_column(path
)
| The path of the item. |
Returns : | The column in which the item is displayed. |
Note
This method is available in PyGTK 2.22 and above.
The get_item_column
() method gets the column in which the
item path is currently displayed. Column numbers start at 0.
gtk.IconView.set_item_orientation
def set_item_orientation(orientation
)
| The relative position of texts and icons. |
Note
This method is available in PyGTK 2.22 and above.
The set_item_orientation
() method sets the "item-orientation"
property which determines whether the labels are drawn beside the icons instead of below.
gtk.IconView.get_item_orientation
def get_item_orientation()
Returns : | The relative position of texts and icons. |
Note
This method is available in PyGTK 2.22 and above.
The get_item_orientation
() method returns the value of the
"item-orientation" property which determines whether the labels are drawn beside the icons
instead of below.
Signals
The "activate-cursor-item" gtk.IconView Signal
def callback(iconview
, user_param1
, ...
)
| the widget that received the signal |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
Returns : | True if the signal
was handled. |
The "activate-cursor-item" signal is emitted when an icon is selected and the Enter key is pressed.
The "item-activated" gtk.IconView Signal
def callback(iconview
, path
, user_param1
, ...
)
| the widget that received the signal |
| the path to the activated icon item. |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
The "item-activated" signal is emitted when an icon item is
activated by the user double clicking an icon item, pressing the
Enter key when an icon item is selected or via a call to
the item_activated
()
method.
The "move-cursor" gtk.IconView Signal
def callback(iconview
, step
, number
, user_param1
, ...
)
| the widget that received the signal |
| the step size to move the cursor |
| the number of steps to move |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
Returns : | True if the signal
was handled. |
The "move-cursor" signal is emitted when the cursor is moved
using the keyboard keys: Up, Down,
Control+p,
Control+n,
Home, End, Page_Up,
Page_Down, Right, Left
with various Shift and Control
combinations. step
will be one of the GTK Movement Step Constants.
The "select-all" gtk.IconView Signal
def callback(iconview
, user_param1
, ...
)
| the widget that received the signal |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
The "select-all" signal is emitted when all icon items are selected by pressing Control+a.
The "select-cursor-item" gtk.IconView Signal
def callback(iconview
, user_param1
, ...
)
| the widget that received the signal |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
The "select-cursor-item" signal is emitted when the icon item at the cursor is selected by the user pressing the Space key.
The "selection-changed" gtk.IconView Signal
def callback(iconview
, user_param1
, ...
)
| the widget that received the signal |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
The "selection-changed" signal is emitted when the selection is changed either by user action or program method calls.
The "set-scroll-adjustments" gtk.IconView Signal
def callback(iconview
, hadj
, vadj
, user_param1
, ...
)
| the widget that received the signal |
| the new horizontal gtk.Adjustment |
| the new vertical gtk.Adjustment |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
The "set-scroll-adjustments" signal is emitted when the new
horizontal and veritcal scroll gtk.Adjustment
objects are set.
The "toggle-cursor-item" gtk.IconView Signal
def callback(iconview
, user_param1
, ...
)
| the widget that received the signal |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
The "toggle-cursor-item" signal is emitted when the user presses Control+Space.
The "unselect-all" gtk.IconView Signal
def callback(iconview
, user_param1
, ...
)
| the widget that received the signal |
| the first user parameter (if any) specified
with the connect () |
| additional user parameters (if any) |
The "unselect-all" signal is emitted when the user presses Control+Shift+a.