gtk.IconView a widget which displays a list of icons in a grid (new in PyGTK 2.6) Synopsis gtk.IconView gtk.Container gtk.CellLayout gtk.IconView modelNone set_model modelNone get_model set_text_column column get_text_column set_markup_column column get_markup_column set_pixbuf_column column get_pixbuf_column get_path_at_pos x y get_item_at_pos x y set_cursor path cellNone start_editingFalse get_cursor selected_foreach func data set_selection_mode mode get_selection_mode set_orientation orientation get_orientation set_columns columns get_columns set_item_width item_width get_item_width set_spacing spacing get_spacing set_row_spacing row_spacing get_row_spacing set_column_spacing column_spacing get_column_spacing set_margin margin get_margin select_path path unselect_path path path_is_selected path get_selected_items select_all unselect_all item_activated path scroll_to_path path use_align row_align col_align get_visible_range enable_model_drag_source start_button_mask targets actons enable_model_drag_dest targets actions unset_model_drag_source unset_model_drag_dest set_reorderable reorderable get_reorderable set_drag_dest_item path pos get_drag_dest_item get_dest_item_at_pos drag_x drag_y create_drag_icon path convert_widget_to_bin_window_coords widget_x widget_y set_tooltip_cell tooltip path cell set_tooltip_column column get_tooltip_column set_tooltip_item tooltip path get_item_row path get_item_column path set_item_orientation orientation get_item_orientation set_item_padding item_padding get_item_padding Ancestry +-- gobject.GObject +-- gtk.Object +-- gtk.Widget +-- gtk.Container +-- gtk.IconView (implements gtk.CellLayout) Implemented Interfaces gtk.IconView implements gtk.Buildable gtk.IconView Properties gtk.Object Properties gtk.Widget Properties gtk.Container Properties
"column-spacing" Read-Write The space (in pixels) inserted between grid columns. Allowed values: >= 0. Default value: 6. Available in GTK+ 2.6 and above. "columns" Read-Write The number of columns in a row. If it is -1, the number of columns will be chosen automatically to fill the available width. Allowed values: >= -1. Default value: -1. Available in GTK+ 2.6 and above. "item-orientation" Read-Write Specifies how the cells (i.e. the icon and the text) of the item are positioned relative to each other. Default value: gtk.ORIENTATION_VERTICAL. Available in GTK+ 2.22 and above. "item-padding" Read-Write Specifies the padding around each of the icon view's item. . Available in GTK+ 2.22 and above. "item-width" Read-Write The width used for each item. If it is -1 the width the largest item is used. Allowed values: >= -1. Default value: -1. Available in GTK+ 2.6 and above. "margin" Read-Write The space (in pixels) inserted at the edges of the icon view. Allowed values: >= 0. Default value: 6. Available in GTK+ 2.6 and above. "markup-column" Read-Write The number of the model column containing markup information to be displayed. If this property and the "text-column" property are both set to column numbers, this overrides the text column. If both are set to -1, no text is displayed. Allowed values: >= -1. Default value: -1. Available in GTK+ 2.6 and above. "model" Read-Write The gtk.TreeModel for the icon view. Available in GTK+ 2.6 and above. "orientation" Read-Write How the text and icon of each item are positioned relative to each other. Default value: gtk.ORIENTATION_VERTICAL. Available in GTK+ 2.6 and above. "pixbuf-column" Read-Write The number of the model column containing the pixbufs that are displayed. Setting this property to -1 turns off the display of pixbufs. Allowed values: >= -1. Default value: -1. Available in GTK+ 2.6 and above. "reorderable" Read-Write If True the icon view is reorderable. Default value: False. Available in GTK+ 2.8 and above. "row-spacing" Read-Write The space (in pixels) inserted between grid rows. Allowed values: >= 0. Default value: 6. Available in GTK+ 2.6 and above. "selection-mode" Read-Write The selection mode of the icon view. If the mode is gtk.SELECTION_MULTIPLE, rubberband selection is enabled, for the other modes, only keyboard selection is possible. Default value: gtk.SELECTION_SINGLE. Available in GTK+ 2.6 and above. "spacing" Read-Write The space (in pixels) inserted between cells of an item. Allowed values: >= 0. Default value: 0. Available in GTK+ 2.6 and above. "text-column" Read-Write The number of the model column containing the text that is displayed. If this property and the "markup-column" property are both set to -1, no text is displayed. Allowed values: >= -1. Default value: -1. Available in GTK+ 2.6 and above. "tooltip-column" Read-Write The number of the model column containing the tooltip text for the items.
gtk.IconView Style Properties gtk.Widget Style Properties
"selection-box-alpha" Read The opacity of the selection box. Default value: 64. Available in GTK+ 2.6 and above. "selection-box-color" Read The color of the selection box. Available in GTK+ 2.6 and above.
gtk.IconView Signal Prototypes gobject.GObject Signal Prototypes gtk.Object Signal Prototypes gtk.Widget Signal Prototypes gtk.Container Signal Prototypes "activate-cursor-item" callback iconview user_param1 ... "item-activated" callback iconview path user_param1 ... "move-cursor" callback iconview step number user_param1 ... "select-all" callback iconview user_param1 ... "select-cursor-item" callback iconview user_param1 ... "selection-changed" callback iconview user_param1 ... "set-scroll-adjustments" callback iconview hadj vadj user_param1 ... "toggle-cursor-item" callback iconview user_param1 ... "unselect-all" callback iconview user_param1 ... Description 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 modelNone model : A gtk.TreeModel, or None Returns : a new gtk.IconView widget. 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 set_model modelNone model : a gtk.TreeModel or None 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 get_model Returns : The gtk.TreeModel used by the cell view or None. 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 set_text_column column column : The index of a column in the model or -1 to unset the column 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 get_text_column Returns : The index of a model's column or -1 if unset. 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 set_markup_column column column : The index of a column in the model or -1. 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 get_markup_column Returns : the index of the model column containing markup or -1. 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 set_pixbuf_column column column : the index of a model column or -1 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 get_pixbuf_column Returns : The index of a column in the model or -1 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 get_path_at_pos x y x : the x coordinate y : the y coordinate Returns : the path at the specified point or None. 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 get_item_at_pos x y x : the x coordinate y : 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. 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 set_cursor path cellNone start_editingFalse path : a tree path cell : a gtk.CellRenderer or None start_editing : if True the specified cell should start being edited 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. In PyGTK 2.8 cell and start_editing must be specified. Also cell cannot be None. gtk.IconView.get_cursor get_cursor Returns : a 2-tuple containing the current cursor path and cell renderer or None if the cursor isn't set. 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 selected_foreach func data func : a callback function or method. data : User data to pass to func. 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 set_selection_mode mode mode : The selection mode. 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.IconView.get_selection_mode get_selection_mode Returns : the selection mode. 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.IconView.set_orientation set_orientation orientation orientation : the relative position of the icon and text. 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 . The "orientation" property indicates the relative positioning of the icon and text. gtk.IconView.get_orientation get_orientation Returns : the relative position of the icon and text. 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 set_columns columns columns : the number of columns in a row. 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 get_columns Returns : the number of columns per row or -1. 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 set_item_width item_width item_width : The space used to display an item or -1 to use the width of the largest item. 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 get_item_width Returns : the space available for displaying an item or -1. 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 set_spacing spacing spacing : The space between the cells of an item in the icon view 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 get_spacing Returns : the space in pixels that is inserted between cells in the icon view. 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 set_row_spacing row_spacing row_spacing : the space between rows in the icon view. 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 get_row_spacing Returns : the space between rows in the icon view. 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 set_column_spacing column_spacing column_spacing : The space inserted between columns in the icon view 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 get_column_spacing Returns : the space between columns in the icon view. 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 set_margin margin margin : the space inserted at the edges of the icon view. 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 get_margin Returns : the space inserted at the edges of the icon view. 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 select_path path path : a path indicating the icon to be selected 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 unselect_path path path : a path indicating the icon to be unselected 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 path_is_selected path path : a path of an icon. Returns : True if path is selected. 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 get_selected_items Returns : a list of the paths of the selected icons. 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 select_all 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 unselect_all This method is available in PyGTK 2.6 and above. The unselect_all() method unselects all the icons. gtk.IconView.item_activated item_activated path path : a tree path pointing to an icon row. 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 scroll_to_path path use_align row_align col_align path : the path of the item to move to. use_align : if True use the alignment arguments row_align : the vertical alignment of the item specified by path. col_align : The horizontal alignment of the item specified by path. 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 get_visible_range Returns : a 2-tuple containing the start and end paths of the visible region or None. 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 enable_model_drag_source start_button_mask targets actions start_button_mask : the mask of buttons allowed to start drag targets : a sequence of 3-tuples containing target information that the drag will support actions : the combination of possible for a drag from the iconview 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 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 supported by the iconview. gtk.IconView.enable_model_drag_dest enable_model_drag_dest targets actions targets : a sequence of 3-tuples containing target information that the iconview will support for a drag drop actions : the combination of possible for a drag drop onto to the iconview 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 supported by the iconview. gtk.IconView.unset_model_drag_source unset_model_drag_source 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 unset_model_drag_dest 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 set_reorderable reorderable reorderable : if True the items are reorderable. 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 get_reorderable Returns : True if the iconview list can be reordered. 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 set_drag_dest_item path pos path : the path of the item to highlight, or None . pos : specifies where to drop, relative to the item 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 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 get_drag_dest_item Returns : a 2-tuple containing the path of the highlighted item and one of the specifying the relative drop location or None. 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 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 get_dest_item_at_pos drag_x drag_y drag_x : the X position drag_y : the Y position Returns : a 2-tuple containing the path of the highlighted item and a relative drop location. 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 create_drag_icon path path : a path Returns : a gtk.gdk.Pixmap of the drag icon. 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 convert_widget_to_bin_window_coords widget_x widget_y widget_x : X coordinate relative to the widget. widget_y : Y coordinate relative to the widget. Returns : A tuple containing the bin_window X and Y coordinates. 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 set_tooltip_cell tooltip path cell tooltip : A tooltip. path : A path. cell : A cell renderer or None. 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.Tooltip.set_tip_area(). gtk.IconView.set_tooltip_column set_tooltip_column column column : An integer, which is a valid column number for icon_view's model 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 get_tooltip_column Returns : The index of the tooltip column that is currently being used, or -1 if this is disabled. 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 set_tooltip_cell tooltip path tooltip : A tooltip. path : A path. 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.Tooltip.set_tip_area(). gtk.IconView.get_item_row get_item_row path path : The path of the item. Returns : The row in which the item is displayed. 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 get_item_column path path : The path of the item. Returns : The column in which the item is displayed. 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 set_item_orientation orientation orientation : The relative position of texts and icons. 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 get_item_orientation Returns : The relative position of texts and icons. 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. gtk.IconView.set_item_padding set_item_padding item_padding item_padding : The item padding. This method is available in PyGTK 2.22 and above. The set_item_padding() method sets the "item-padding" property which specifies the padding around each of the icon view's items. gtk.IconView.get_item_padding get_item_padding Returns : The padding around items. This method is available in PyGTK 2.22 and above. The get_item_padding() method returns the value of the "item-padding" property. Signals The "activate-cursor-item" gtk.IconView Signal callback iconview user_param1 ... iconview : the widget that received the signal user_param1 : the first user parameter (if any) specified with the connect() method ... : 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 callback iconview path user_param1 ... iconview : the widget that received the signal path : the path to the activated icon item. user_param1 : the first user parameter (if any) specified with the connect() method ... : 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 callback iconview step number user_param1 ... iconview : the widget that received the signal step : the step size to move the cursor number : the number of steps to move user_param1 : the first user parameter (if any) specified with the connect() method ... : 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, Controlp , Controln , Home, End, Page_Up, Page_Down, Right, Left with various Shift and Control combinations. step will be one of the . The "select-all" gtk.IconView Signal callback iconview user_param1 ... iconview : the widget that received the signal user_param1 : the first user parameter (if any) specified with the connect() method ... : additional user parameters (if any) The "select-all" signal is emitted when all icon items are selected by pressing Controla . The "select-cursor-item" gtk.IconView Signal callback iconview user_param1 ... iconview : the widget that received the signal user_param1 : the first user parameter (if any) specified with the connect() method ... : 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 callback iconview user_param1 ... iconview : the widget that received the signal user_param1 : the first user parameter (if any) specified with the connect() method ... : 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 callback iconview hadj vadj user_param1 ... iconview : the widget that received the signal hadj : the new horizontal gtk.Adjustment vadj : the new vertical gtk.Adjustment user_param1 : the first user parameter (if any) specified with the connect() method ... : 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 callback iconview user_param1 ... iconview : the widget that received the signal user_param1 : the first user parameter (if any) specified with the connect() method ... : additional user parameters (if any) The "toggle-cursor-item" signal is emitted when the user presses ControlSpace . The "unselect-all" gtk.IconView Signal callback iconview user_param1 ... iconview : the widget that received the signal user_param1 : the first user parameter (if any) specified with the connect() method ... : additional user parameters (if any) The "unselect-all" signal is emitted when the user presses ControlShifta .