llfloatersidepanelcontainer.h

/** 
 * @file llfloatersidepanelcontainer.h
 * @brief LLFloaterSidePanelContainer class
 *
 *
 * $LicenseInfo:firstyear=2011&license=viewerlgpl$
 * Second Life Viewer Source Code
 * Copyright (C) 2011, Linden Research, Inc.
 * 
 * This library 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;
 * version 2.1 of the License only.
 * 
 * This library 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 this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 * 
 * Linden Research, Inc., 945 Battery Street, San Francisco, CA  94111  USA
 * $/LicenseInfo$
 */

#ifndef LL_LLFLOATERSIDEPANELCONTAINER_H
#define LL_LLFLOATERSIDEPANELCONTAINER_H

#include "llfloater.h"

/**
 * Class LLFloaterSidePanelContainer
 *
 * Provides an interface for all former Side Tray panels.
 *
 * This class helps to make sure that clicking a floater containing the side panel
 * doesn't make transient floaters (e.g. IM windows) hide, so that it's possible to
 * drag an inventory item from My Inventory window to a docked IM window,
 * i.e. share the item (see VWR-22891).
 */
class LLFloaterSidePanelContainer : public LLFloater
{
private:
	static const std::string sMainPanelName;

public:
	LLFloaterSidePanelContainer(const LLSD& key, const Params& params = getDefaultParams());
	~LLFloaterSidePanelContainer();

	/*virtual*/ void onOpen(const LLSD& key);

	/*virtual*/ void onClickCloseBtn();

	LLPanel* openChildPanel(const std::string& panel_name, const LLSD& params);

	static void showPanel(const std::string& floater_name, const LLSD& key);

	static void showPanel(const std::string& floater_name, const std::string& panel_name, const LLSD& key);
	
	static LLPanel* getPanel(const std::string& floater_name, const std::string& panel_name = sMainPanelName);
	
	/**
	 * Gets the panel of given type T (doesn't show it or do anything else with it).
	 *
	 * @param floater_name a string specifying the floater to be searched for a child panel.
	 * @param panel_name a string specifying the child panel to get.
	 * @returns a pointer to the panel of given type T.
	 */
	template <typename T>
	static T* getPanel(const std::string& floater_name, const std::string& panel_name = sMainPanelName)
	{
		T* panel = dynamic_cast<T*>(getPanel(floater_name, panel_name));
		if (!panel)
		{
			llwarns << "Child named \"" << panel_name << "\" of type " << typeid(T*).name() << " not found" << llendl;
		}
		return panel;
	}
};

#endif // LL_LLFLOATERSIDEPANELCONTAINER_H