/*
 * This file is part of d-handy.
 *
 * d-handy is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; either version 3
 * of the License, or (at your option) any later version, with
 * some exceptions, please read the COPYING file.
 *
 * d-handy is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with d-handy; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA
 */
module handy.ActionRow;

private import glib.ConstructionException;
private import glib.Str;
private import gobject.ObjectG;
private import gobject.Signals;
private import gtk.Widget;
private import handy.PreferencesRow;
private import handy.c.functions;
public  import handy.c.types;
private import std.algorithm;


/** */
public class ActionRow : PreferencesRow
{
	/** the main Gtk struct */
	protected HdyActionRow* hdyActionRow;

	/** Get the main Gtk struct */
	public HdyActionRow* getActionRowStruct(bool transferOwnership = false)
	{
		if (transferOwnership)
			ownedRef = false;
		return hdyActionRow;
	}

	/** the main Gtk struct as a void* */
	protected override void* getStruct()
	{
		return cast(void*)hdyActionRow;
	}

	/**
	 * Sets our main struct and passes it to the parent class.
	 */
	public this (HdyActionRow* hdyActionRow, bool ownedRef = false)
	{
		this.hdyActionRow = hdyActionRow;
		super(cast(HdyPreferencesRow*)hdyActionRow, ownedRef);
	}

	alias activate = Widget.activate;

	/** */
	public void activate()
	{
		hdy_action_row_activate(hdyActionRow);
	}

	/**
	 */

	/** */
	public static GType getType()
	{
		return hdy_action_row_get_type();
	}

	/**
	 * Creates a new #HdyActionRow.
	 *
	 * Returns: a new #HdyActionRow
	 *
	 * Since: 0.0.6
	 *
	 * Throws: ConstructionException GTK+ fails to create the object.
	 */
	public this()
	{
		auto __p = hdy_action_row_new();

		if(__p is null)
		{
			throw new ConstructionException("null returned by new");
		}

		this(cast(HdyActionRow*) __p);
	}

	/**
	 * Adds a prefix widget to @self.
	 *
	 * Params:
	 *     widget = the prefix widget
	 *
	 * Since: 0.0.6
	 */
	public void addPrefix(Widget widget)
	{
		hdy_action_row_add_prefix(hdyActionRow, (widget is null) ? null : widget.getWidgetStruct());
	}

	/**
	 * Gets the widget activated when @self is activated.
	 *
	 * Returns: the widget activated when @self is
	 *     activated, or %NULL if none has been set.
	 *
	 * Since: 0.0.7
	 */
	public Widget getActivatableWidget()
	{
		auto __p = hdy_action_row_get_activatable_widget(hdyActionRow);

		if(__p is null)
		{
			return null;
		}

		return ObjectG.getDObject!(Widget)(cast(GtkWidget*) __p);
	}

	/**
	 * Gets the icon name for @self.
	 *
	 * Returns: the icon name for @self.
	 *
	 * Since: 0.0.6
	 */
	public string getIconName()
	{
		return Str.toString(hdy_action_row_get_icon_name(hdyActionRow));
	}

	/**
	 * Gets the subtitle for @self.
	 *
	 * Returns: the subtitle for @self, or %NULL.
	 *
	 * Since: 0.0.6
	 */
	public string getSubtitle()
	{
		return Str.toString(hdy_action_row_get_subtitle(hdyActionRow));
	}

	/**
	 * Gets whether an embedded underline in the text of the title and subtitle
	 * labels indicates a mnemonic. See hdy_action_row_set_use_underline().
	 *
	 * Returns: %TRUE if an embedded underline in the title and subtitle labels
	 *     indicates the mnemonic accelerator keys.
	 *
	 * Since: 0.0.6
	 */
	public override bool getUseUnderline()
	{
		return hdy_action_row_get_use_underline(hdyActionRow) != 0;
	}

	/**
	 * Sets the widget to activate when @self is activated, either by clicking
	 * on it, by calling hdy_action_row_activate(), or via mnemonics in the title or
	 * the subtitle. See the “use_underline” property to enable mnemonics.
	 *
	 * The target widget will be activated by emitting the
	 * GtkWidget::mnemonic-activate signal on it.
	 *
	 * Params:
	 *     widget = the target #GtkWidget, or %NULL to unset
	 *
	 * Since: 0.0.7
	 */
	public void setActivatableWidget(Widget widget)
	{
		hdy_action_row_set_activatable_widget(hdyActionRow, (widget is null) ? null : widget.getWidgetStruct());
	}

	/**
	 * Sets the icon name for @self.
	 *
	 * Params:
	 *     iconName = the icon name
	 *
	 * Since: 0.0.6
	 */
	public void setIconName(string iconName)
	{
		hdy_action_row_set_icon_name(hdyActionRow, Str.toStringz(iconName));
	}

	/**
	 * Sets the subtitle for @self.
	 *
	 * Params:
	 *     subtitle = the subtitle
	 *
	 * Since: 0.0.6
	 */
	public void setSubtitle(string subtitle)
	{
		hdy_action_row_set_subtitle(hdyActionRow, Str.toStringz(subtitle));
	}

	/**
	 * If true, an underline in the text of the title and subtitle labels indicates
	 * the next character should be used for the mnemonic accelerator key.
	 *
	 * Params:
	 *     useUnderline = %TRUE if underlines in the text indicate mnemonics
	 *
	 * Since: 0.0.6
	 */
	public override void setUseUnderline(bool useUnderline)
	{
		hdy_action_row_set_use_underline(hdyActionRow, useUnderline);
	}

	/**
	 * This signal is emitted after the row has been activated.
	 *
	 * Since: 1.0
	 */
	gulong addOnActivated(void delegate(ActionRow) dlg, ConnectFlags connectFlags=cast(ConnectFlags)0)
	{
		return Signals.connect(this, "activated", dlg, connectFlags ^ ConnectFlags.SWAPPED);
	}
}