193010e947
A system to throw errors that allow for easy error reporting to the user by showing a translated pop-up alert box with the error message. The messages use strings.xml for translation and allow the usual replacement args (ie [FILE] is replaced with a filename). The exceptions can be cascaded, by adding more (translated) text when caught and then re-throwing the result. Macros are being used to support adding a function name prefix to a message of the current function that the exception is thrown from. The syntax is: <macro>(<line>); to show 'line' <macro>(<alert>, <line>); to append 'line' to a caught alert. <macro>(<line>, <alert>); to prepend 'line' to a caught alert. where <macro> is one of: THROW_ALERT, THROW_MALERT, THROW_FALERT, THROW_FMALERT, THROW_ALERTE, THROW_MALERTE, THROW_FALERTE, THROW_FMALERTE, where M = modal, F = Function name. and where <line> is one of: <xmldesc> <xmldesc>, AIArgs<args> where <xmldesc> is a string literal that will be looked up in strings.xml, and <args> is: (<key>, <replacement>)[<args>] There are more variations of the macros to throw an arbitrary class (append _CLASS), include an int code (append C) or to store the current errno as code (append E). For example, THROW_MALERTC(code, ...), or THROW_FALERT_CLASS(Foobar, ...), where the ... is the same as for the macros above. Documentation and example usage has been added to aialert.h.
70 lines
2.2 KiB
C++
70 lines
2.2 KiB
C++
/**
|
|
* @file llnotificationsutil.h
|
|
*
|
|
* $LicenseInfo:firstyear=2008&license=viewerlgpl$
|
|
* Second Life Viewer Source Code
|
|
* Copyright (C) 2010, 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 LLNOTIFICATIONSUTIL_H
|
|
#define LLNOTIFICATIONSUTIL_H
|
|
|
|
// The vast majority of clients of the notifications system just want to add
|
|
// a notification to the screen, so define this lightweight public interface
|
|
// to avoid including the heavyweight llnotifications.h
|
|
|
|
#include "llnotificationptr.h"
|
|
|
|
#include <boost/function.hpp>
|
|
|
|
class LLSD;
|
|
class AIAlert;
|
|
|
|
namespace LLNotificationsUtil
|
|
{
|
|
LLNotificationPtr add(AIAlert const& alert, unsigned int suppress_mask = 0); // Singu extension.
|
|
|
|
LLNotificationPtr add(const std::string& name);
|
|
|
|
LLNotificationPtr add(const std::string& name,
|
|
const LLSD& substitutions);
|
|
|
|
LLNotificationPtr add(const std::string& name,
|
|
const LLSD& substitutions,
|
|
const LLSD& payload);
|
|
|
|
LLNotificationPtr add(const std::string& name,
|
|
const LLSD& substitutions,
|
|
const LLSD& payload,
|
|
const std::string& functor_name);
|
|
|
|
LLNotificationPtr add(const std::string& name,
|
|
const LLSD& substitutions,
|
|
const LLSD& payload,
|
|
boost::function<void (const LLSD&, const LLSD&)> functor);
|
|
|
|
S32 getSelectedOption(const LLSD& notification, const LLSD& response);
|
|
|
|
void cancel(LLNotificationPtr pNotif);
|
|
|
|
LLNotificationPtr find(LLUUID uuid);
|
|
}
|
|
|
|
#endif
|