winamp/Src/external_dependencies/openmpt-trunk/mptrack/Reporting.h

/*
 * Reporting.h
 * -----------
 * Purpose: A class for showing notifications, prompts, etc...
 * Notes  : (currently none)
 * Authors: OpenMPT Devs
 * The OpenMPT source code is released under the BSD license. Read LICENSE for more details.
 */


#pragma once

#include "openmpt/all/BuildSettings.hpp"


OPENMPT_NAMESPACE_BEGIN


enum ConfirmAnswer
{
	cnfYes,
	cnfNo,
	cnfCancel,
};


enum RetryAnswer
{
	rtyRetry,
	rtyCancel,
};


class Reporting
{

public:

	// TODO Quick'n'dirty workaround for MsgBox(). Shouldn't be public.
	static UINT CustomNotification(const AnyStringLocale &text, const AnyStringLocale &caption, UINT flags, const CWnd *parent);

	// Show a simple notification
	static void Notification(const AnyStringLocale &text, const CWnd *parent = nullptr);
	static void Notification(const AnyStringLocale &text, const AnyStringLocale &caption, const CWnd *parent = nullptr);

	// Show a simple information
	static void Information(const AnyStringLocale &text, const CWnd *parent = nullptr);
	static void Information(const AnyStringLocale &text, const AnyStringLocale &caption, const CWnd *parent = nullptr);

	// Show a simple warning
	static void Warning(const AnyStringLocale &text, const CWnd *parent = nullptr);
	static void Warning(const AnyStringLocale &text, const AnyStringLocale &caption, const CWnd *parent = nullptr);

	// Show an error box.
	static void Error(const AnyStringLocale &text, const CWnd *parent = nullptr);
	static void Error(const AnyStringLocale &text, const AnyStringLocale &caption, const CWnd *parent = nullptr);

	// Simplified version of the above
	static void Message(LogLevel level, const AnyStringLocale &text, const CWnd *parent = nullptr);
	static void Message(LogLevel level, const AnyStringLocale &text, const AnyStringLocale &caption, const CWnd *parent = nullptr);

	// Show a confirmation dialog.
	static ConfirmAnswer Confirm(const AnyStringLocale &text, bool showCancel = false, bool defaultNo = false, const CWnd *parent = nullptr);
	static ConfirmAnswer Confirm(const AnyStringLocale &text, const AnyStringLocale &caption, bool showCancel = false, bool defaultNo = false, const CWnd *parent = nullptr);
	// work-around string literals for caption decaying to bool and catching the wrong overload instead of converting to a string.
	static ConfirmAnswer Confirm(const AnyStringLocale &text, const char *caption, bool showCancel = false, bool defaultNo = false, const CWnd *parent = nullptr) { return Confirm(text, AnyStringLocale(caption), showCancel, defaultNo, parent); }
	static ConfirmAnswer Confirm(const AnyStringLocale &text, const wchar_t *caption, bool showCancel = false, bool defaultNo = false, const CWnd *parent = nullptr) { return Confirm(text, AnyStringLocale(caption), showCancel, defaultNo, parent); }
	static ConfirmAnswer Confirm(const AnyStringLocale &text, const CString &caption, bool showCancel = false, bool defaultNo = false, const CWnd *parent = nullptr) { return Confirm(text, AnyStringLocale(caption), showCancel, defaultNo, parent); }

	// Show a confirmation dialog.
	static RetryAnswer RetryCancel(const AnyStringLocale &text, const CWnd *parent = nullptr);
	static RetryAnswer RetryCancel(const AnyStringLocale &text, const AnyStringLocale &caption, const CWnd *parent = nullptr);

};


OPENMPT_NAMESPACE_END