ToolPalette

Object Hierarchy:

Description:

GtkWidget *palette, *group;
GtkToolItem *item;

palette = gtk_tool_palette_new ();
group = gtk_tool_item_group_new (_("Test Category"));
gtk_container_add (GTK_CONTAINER (palette), group);

item = gtk_tool_button_new (NULL, _("_Open"));
gtk_tool_button_set_icon_name (GTK_TOOL_BUTTON (item), "document-open");
gtk_tool_item_group_insert (GTK_TOOL_ITEM_GROUP (group), item, -1);

static void
passive_canvas_drag_data_received (GtkWidget				*widget,
																	 GdkDragContext	 *context,
																	 gint							x,
																	 gint							y,
																	 GtkSelectionData *selection,
																	 guint						 info,
																	 guint						 time,
																	 gpointer					data)
{
	GtkWidget *palette;
	GtkWidget *item;

	// Get the dragged item
	palette = gtk_widget_get_ancestor (gtk_drag_get_source_widget (context),
																		 GTK_TYPE_TOOL_PALETTE);
	if (palette != NULL)
		item = gtk_tool_palette_get_drag_item (GTK_TOOL_PALETTE (palette),
																					 selection);

	// Do something with item
}

GtkWidget *target, palette;

palette = gtk_tool_palette_new ();
target = gtk_drawing_area_new ();

g_signal_connect (G_OBJECT (target), "drag-data-received",
									G_CALLBACK (passive_canvas_drag_data_received), NULL);
gtk_tool_palette_add_drag_dest (GTK_TOOL_PALETTE (palette), target,
																GTK_DEST_DEFAULT_ALL,
																GTK_TOOL_PALETTE_DRAG_ITEMS,
																GDK_ACTION_COPY);

Content:

Properties:

• public IconSize icon_size { owned get; set; }
  The size of the icons in a tool palette.
• public bool icon_size_set { get; set; }
  Is true if the icon_size property has been set.
• public ToolbarStyle toolbar_style { get; set; }
  The style of items in the tool palette.

Static methods:

• public static unowned TargetEntry? get_drag_target_group ()
  Get the target entry for a dragged ToolItemGroup.
• public static unowned TargetEntry? get_drag_target_item ()
  Gets the target entry for a dragged ToolItem.

Creation methods:

• public ToolPalette ()
  Creates a new tool palette.

Methods:

• public void add_drag_dest (Widget widget, DestDefaults flags, ToolPaletteDragTargets targets, DragAction actions)
  Sets this as drag source (see set_drag_source) and sets widget as a drag destination for drags from this.
• public unowned Widget get_drag_item (SelectionData selection)
  Get the dragged item from the selection.
• public unowned ToolItemGroup? get_drop_group (int x, int y)
  Gets the group at position (x, y).
• public unowned ToolItem? get_drop_item (int x, int y)
  Gets the item at position (x, y).
• public bool get_exclusive (ToolItemGroup group)
  Gets whether group is exclusive or not.
• public bool get_expand (ToolItemGroup group)
  Gets whether group should be given extra space.
• public int get_group_position (ToolItemGroup group)
  Gets the position of group in this as index.
• public unowned Adjustment get_hadjustment ()
  Gets the horizontal adjustment of the tool palette.
• public IconSize get_icon_size ()
  Gets the size of icons in the tool palette.
• public ToolbarStyle get_style ()
  Gets the style (icons, text or both) of items in the tool palette.
• public unowned Adjustment get_vadjustment ()
  Gets the vertical adjustment of the tool palette.
• public void set_drag_source (ToolPaletteDragTargets targets)
  Sets the tool palette as a drag source.
• public void set_exclusive (ToolItemGroup group, bool exclusive)
  Sets whether the group should be exclusive or not.
• public void set_expand (ToolItemGroup group, bool expand)
  Sets whether the group should be given extra space.
• public void set_group_position (ToolItemGroup group, int position)
  Sets the position of the group as an index of the tool palette.
• public void set_icon_size (IconSize icon_size)
  Sets the size of icons in the tool palette.
• public void set_style (ToolbarStyle style)
  Sets the style (text, icons or both) of items in the tool palette.
• public void unset_icon_size ()
  Unsets the tool palette icon size set with set_icon_size, so that user preferences will be used to determine the icon size.
• public void unset_style ()
  Unsets a toolbar style set with set_style, so that user preferences will be used to determine the toolbar style.

Inherited Members: