drop_down_menu.cpp

/*
   Copyright (C) 2008 - 2017 by Mark de Wever <koraq@xs4all.nl>
   Part of the Battle for Wesnoth Project http://www.wesnoth.org/

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.
   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY.

   See the COPYING file for more details.
*/

#define GETTEXT_DOMAIN "wesnoth-lib"

#include "gui/dialogs/drop_down_menu.hpp"
#include "gui/widgets/listbox.hpp"
#include "gui/auxiliary/find_widget.hpp"
#include "gui/dialogs/modal_dialog.hpp"
#include "gui/widgets/image.hpp"
#include "gui/widgets/integer_selector.hpp"
#include "gui/widgets/scrollbar.hpp"
#include "gui/widgets/settings.hpp"
#include "gui/widgets/toggle_button.hpp"
#include "gui/widgets/toggle_panel.hpp"
#include "gui/widgets/window.hpp"

#include "sdl/rect.hpp"
#include "utils/functional.hpp"

namespace gui2
{
namespace dialogs
{

REGISTER_DIALOG(drop_down_menu)

namespace
{
	void click_callback(window& window, bool keep_open, bool&, bool&, point coordinate)
	{
		listbox& list = find_widget<listbox>(&window, "list", true);

		/* Disregard clicks on scrollbars and toggle buttons so the dropdown menu can be scrolled or have an embedded
		 * toggle button selected without the menu closing.
		 *
		 * This works since this click_callback function is called before widgets' left-button-up handlers.
		 *
		 * Additionally, this is done before row deselection so selecting/deselecting a toggle button doesn't also leave
		 * the list with no row visually selected. Oddly, the visial deselection doesn't seem to cause any crashes, and
		 * the previously selected row is reselected when the menu is opened again. Still, it's odd to see your selection
		 * vanish.
		 */
		if(list.vertical_scrollbar()->get_state() == scrollbar_base::PRESSED) {
			return;
		}

		if(dynamic_cast<toggle_button*>(window.find_at(coordinate, true)) != nullptr) {
			return;
		}

		/* FIXME: This dialog uses a listbox with 'has_minimum = false'. This allows a listbox to have 0 or 1 selections,
		 * and selecting the same entry toggles that entry's state (ie, if it was selected, it will be deselected). Because
		 * of this, selecting the same entry in the dropdown list essentially sets the list's selected row to -1, causing problems.
		 *
		 * In order to work around this, we first manually deselect the selected entry here. This handler is called *before*
		 * the listbox's click handler, and as such the selected item will remain toggled on when the click handler fires.
		 */
		const int sel = list.get_selected_row();
		if(sel >= 0) {
			list.select_row(sel, false);
		}

		SDL_Rect rect = window.get_rectangle();
		if(!sdl::point_in_rect(coordinate, rect)) {
			window.set_retval(window::CANCEL);
		} else if(!keep_open) {
			window.set_retval(window::OK);
		}
	}

	void callback_flip_embedded_toggle(window& window)
	{
		listbox& list = find_widget<listbox>(&window, "list", true);

		/* If the currently selected row has a toggle button, toggle it.
		 * Note this cannot be handled in click_callback since at that point the new row selection has not registered,
		 * meaning the currently selected row's button is toggled.
		 */
		grid* row_grid = list.get_row_grid(list.get_selected_row());
		if(toggle_button* checkbox = find_widget<toggle_button>(row_grid, "checkbox", false, false)) {
			checkbox->set_value_bool(!checkbox->get_value_bool());
		}
	}

	void resize_callback(window& window)
	{
		window.set_retval(window::CANCEL);
		window.close();
	}
}

void drop_down_menu::pre_show(window& window)
{
	window_ = &window;

	window.set_variable("button_x", wfl::variant(button_pos_.x));
	window.set_variable("button_y", wfl::variant(button_pos_.y));
	window.set_variable("button_w", wfl::variant(button_pos_.w));
	window.set_variable("button_h", wfl::variant(button_pos_.h));

	listbox& list = find_widget<listbox>(&window, "list", true);

	std::map<std::string, string_map> data;
	string_map item;

	for(const auto& entry : items_) {
		data.clear();

		item["label"] = entry["icon"];
		data.emplace("icon", item);

		if(!entry.has_attribute("image")) {
			item["label"] = entry["label"];
			item["use_markup"] = utils::bool_string(use_markup_);
			data.emplace("label", item);
		}

		if(entry.has_attribute("details")) {
			item["label"] = entry["details"];
			item["use_markup"] = utils::bool_string(use_markup_);
			data.emplace("details", item);
		}

		grid& new_row = list.add_row(data);

		// Set the tooltip on the whole panel
		find_widget<toggle_panel>(&new_row, "panel", false).set_tooltip(entry["tooltip"]);

		if(entry.has_attribute("image")) {
			image* img = build_single_widget_instance<image>("image");
			img->set_label(entry["image"]);

			grid* mi_grid = dynamic_cast<grid*>(new_row.find("menu_item", false));
			if(mi_grid) {
				mi_grid->swap_child("label", img, false);
			}
		}

		if(entry.has_attribute("checkbox")) {
			toggle_button* checkbox = build_single_widget_instance<toggle_button>("toggle_button");
			checkbox->set_id("checkbox");
			checkbox->set_value_bool(entry["checkbox"].to_bool(false));

			if(callback_toggle_state_change_ != nullptr) {
				connect_signal_notify_modified(*checkbox, std::bind(callback_toggle_state_change_));
			}

			grid* mi_grid = dynamic_cast<grid*>(new_row.find("menu_item", false));
			if(mi_grid) {
				mi_grid->swap_child("icon", checkbox, false);
			}
		}
	}

	if(selected_item_ >= 0 && unsigned(selected_item_) < list.get_item_count()) {
		list.select_row(selected_item_);
	}

	window.keyboard_capture(&list);

	// Dismiss on click outside the window
	window.connect_signal<event::SDL_LEFT_BUTTON_UP>(
		std::bind(&click_callback, std::ref(window), keep_open_, _3, _4, _5), event::dispatcher::front_child);

	// Handle embedded button toggling.
	// For some reason this works as a listbox value callback but don't ask me why.
	// - vultraz, 2017-02-17
	connect_signal_notify_modified(list, std::bind(&callback_flip_embedded_toggle, std::ref(window)));

	// Dismiss on resize
	window.connect_signal<event::SDL_VIDEO_RESIZE>(std::bind(&resize_callback, std::ref(window)), event::dispatcher::front_child);
}

void drop_down_menu::post_show(window& window)
{
	listbox& list = find_widget<listbox>(&window, "list", true);

	selected_item_ = list.get_selected_row();

	window_ = nullptr;
}

boost::dynamic_bitset<> drop_down_menu::get_toggle_states() const
{
	assert(window_ != nullptr);

	const listbox& list = find_widget<const listbox>(window_, "list", true);

	boost::dynamic_bitset<> states;

	for(unsigned i = 0; i < list.get_item_count(); ++i) {
		const grid* row_grid = list.get_row_grid(i);

		if(const toggle_button* checkbox = find_widget<const toggle_button>(row_grid, "checkbox", false, false)) {
			states.push_back(checkbox->get_value_bool());
		} else {
			states.push_back(false);
		}
	}

	return states;
}

} // namespace dialogs
} // namespace gui2