OpenTTD Source 20250312-master-gcdcc6b491d
error.h
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * OpenTTD 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, version 2.
4 * OpenTTD 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.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
6 */
7
10#ifndef ERROR_H
11#define ERROR_H
12
13#include "strings_type.h"
14#include "company_type.h"
15#include "command_type.h"
17
18#include <chrono>
19
20struct GRFFile;
21
29
32protected:
39
40public:
41 ErrorMessageData(EncodedString &&summary_msg, EncodedString &&detailed_msg, bool is_critical = false, int x = 0, int y = 0, EncodedString &&extra_msg = {}, CompanyID company = CompanyID::Invalid());
42
44 bool HasFace() const { return company != CompanyID::Invalid(); }
45};
46
48typedef std::list<ErrorMessageData> ErrorList;
49
52
53void ShowErrorMessage(EncodedString &&summary_msg, int x, int y, const CommandCost &cc);
54void ShowErrorMessage(EncodedString &&summary_msg, EncodedString &&detailed_msg, WarningLevel wl, int x = 0, int y = 0, EncodedString &&extra_msg = {}, CompanyID company = CompanyID::Invalid());
56
58void ShowFirstError();
60
61#endif /* ERROR_H */
Common return value for all commands.
Container for an encoded string, created by GetEncodedString.
The data of the error message.
Definition error.h:31
bool HasFace() const
Check whether error window shall display a company manager face.
Definition error.h:44
CompanyID company
Company belonging to the face being shown. CompanyID::Invalid() if no face present.
Definition error.h:38
Point position
Position of the error message window.
Definition error.h:37
EncodedString detailed_msg
Detailed error message showed in second line. Can be INVALID_STRING_ID.
Definition error.h:35
EncodedString extra_msg
Extra error message shown in third line. Can be INVALID_STRING_ID.
Definition error.h:36
EncodedString summary_msg
General error message showed in first line. Must be valid.
Definition error.h:34
bool is_critical
Whether the error message is critical.
Definition error.h:33
Types related to commands.
Types related to companies.
void UnshowCriticalError()
Unshow the critical error.
void ClearErrorMessages()
Clear all errors from the queue.
std::list< ErrorMessageData > ErrorList
Define a queue with errors.
Definition error.h:48
void ScheduleErrorMessage(ErrorList &datas)
Schedule a list of errors.
bool HideActiveErrorMessage()
Close active error message window.
WarningLevel
Message severity/type.
Definition error.h:23
@ WL_WARNING
Other information.
Definition error.h:25
@ WL_ERROR
Errors (eg. saving/loading failed)
Definition error.h:26
@ WL_CRITICAL
Critical errors, the MessageBox is shown in all cases.
Definition error.h:27
@ WL_INFO
Used for DoCommand-like (and some non-fatal AI GUI) errors/information.
Definition error.h:24
void ShowFirstError()
Show the first error of the queue.
void ShowErrorMessage(EncodedString &&summary_msg, int x, int y, const CommandCost &cc)
Display an error message in a window.
All geometry types in OpenTTD.
Types related to strings.
Dynamic data of a loaded NewGRF.
Definition newgrf.h:111
Coordinates of a point in 2D.