OpenTTD Source 20241222-master-gc72542431a
date_gui.cpp
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#include "stdafx.h"
11#include "strings_func.h"
13#include "window_func.h"
14#include "window_gui.h"
15#include "date_gui.h"
17#include "dropdown_type.h"
18#include "dropdown_func.h"
19
20#include "widgets/date_widget.h"
21
22#include "safeguards.h"
23
24
29 TimerGameEconomy::YearMonthDay date;
32
58
60 {
61 Point pt = { this->parent->left + this->parent->width / 2 - sm_width / 2, this->parent->top + this->parent->height / 2 - sm_height / 2 };
62 return pt;
63 }
64
70 {
71 int selected;
72 DropDownList list;
73
74 switch (widget) {
75 default: NOT_REACHED();
76
77 case WID_SD_DAY:
78 for (uint i = 0; i < 31; i++) {
79 list.push_back(MakeDropDownListStringItem(STR_DAY_NUMBER_1ST + i, i + 1));
80 }
81 selected = this->date.day;
82 break;
83
84 case WID_SD_MONTH:
85 for (uint i = 0; i < 12; i++) {
86 list.push_back(MakeDropDownListStringItem(STR_MONTH_JAN + i, i));
87 }
88 selected = this->date.month;
89 break;
90
91 case WID_SD_YEAR:
92 for (TimerGameEconomy::Year i = this->min_year; i <= this->max_year; i++) {
93 SetDParam(0, i);
94 list.push_back(MakeDropDownListStringItem(STR_JUST_INT, i.base()));
95 }
96 selected = this->date.year.base();
97 break;
98 }
99
100 ShowDropDownList(this, std::move(list), selected, widget);
101 }
102
104 {
105 Dimension d = {0, 0};
106 switch (widget) {
107 default: return;
108
109 case WID_SD_DAY:
110 for (uint i = 0; i < 31; i++) {
112 }
113 break;
114
115 case WID_SD_MONTH:
116 for (uint i = 0; i < 12; i++) {
118 }
119 break;
120
121 case WID_SD_YEAR:
122 SetDParamMaxValue(0, this->max_year);
124 break;
125 }
126
127 d.width += padding.width;
128 d.height += padding.height;
129 size = d;
130 }
131
132 void SetStringParameters(WidgetID widget) const override
133 {
134 switch (widget) {
135 case WID_SD_DAY: SetDParam(0, this->date.day - 1 + STR_DAY_NUMBER_1ST); break;
136 case WID_SD_MONTH: SetDParam(0, this->date.month + STR_MONTH_JAN); break;
137 case WID_SD_YEAR: SetDParam(0, this->date.year); break;
138 }
139 }
140
141 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
142 {
143 switch (widget) {
144 case WID_SD_DAY:
145 case WID_SD_MONTH:
146 case WID_SD_YEAR:
147 ShowDateDropDown(widget);
148 break;
149
150 case WID_SD_SET_DATE:
151 if (this->callback != nullptr) this->callback(this, TimerGameEconomy::ConvertYMDToDate(this->date.year, this->date.month, this->date.day), this->callback_data);
152 this->Close();
153 break;
154 }
155 }
156
157 void OnDropdownSelect(WidgetID widget, int index) override
158 {
159 switch (widget) {
160 case WID_SD_DAY:
161 this->date.day = index;
162 break;
163
164 case WID_SD_MONTH:
165 this->date.month = index;
166 break;
167
168 case WID_SD_YEAR:
169 this->date.year = index;
170 break;
171 }
172 this->SetDirty();
173 }
174};
175
179 NWidget(WWT_CLOSEBOX, COLOUR_BROWN),
180 NWidget(WWT_CAPTION, COLOUR_BROWN), SetDataTip(STR_DATE_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
181 EndContainer(),
182 NWidget(WWT_PANEL, COLOUR_BROWN),
183 NWidget(NWID_VERTICAL), SetPIP(6, 6, 6),
185 NWidget(WWT_DROPDOWN, COLOUR_ORANGE, WID_SD_DAY), SetFill(1, 0), SetDataTip(STR_JUST_STRING, STR_DATE_DAY_TOOLTIP),
186 NWidget(WWT_DROPDOWN, COLOUR_ORANGE, WID_SD_MONTH), SetFill(1, 0), SetDataTip(STR_JUST_STRING, STR_DATE_MONTH_TOOLTIP),
187 NWidget(WWT_DROPDOWN, COLOUR_ORANGE, WID_SD_YEAR), SetFill(1, 0), SetDataTip(STR_JUST_INT, STR_DATE_YEAR_TOOLTIP),
188 EndContainer(),
191 NWidget(WWT_PUSHTXTBTN, COLOUR_BROWN, WID_SD_SET_DATE), SetMinimalSize(100, 12), SetDataTip(STR_DATE_SET_DATE, STR_DATE_SET_DATE_TOOLTIP),
193 EndContainer(),
194 EndContainer(),
196};
197
200 WDP_CENTER, nullptr, 0, 0,
202 0,
204);
205
216void ShowSetDateWindow(Window *parent, int window_number, TimerGameEconomy::Date initial_date, TimerGameEconomy::Year min_year, TimerGameEconomy::Year max_year, SetDateCallback *callback, void *callback_data)
217{
219 new SetDateWindow(_set_date_desc, window_number, parent, initial_date, min_year, max_year, callback, callback_data);
220}
Storage class for Economy time constants.
static Date date
Current date in days (day counter).
static YearMonthDay ConvertDateToYMD(Date date)
Converts a Date to a Year, Month & Day.
static Date ConvertYMDToDate(Year year, Month month, Day day)
Converts a tuple of Year, Month and Day to a Date.
static constexpr NWidgetPart _nested_set_date_widgets[]
Widgets for the date setting window.
Definition date_gui.cpp:177
static WindowDesc _set_date_desc(WDP_CENTER, nullptr, 0, 0, WC_SET_DATE, WC_NONE, 0, _nested_set_date_widgets)
Description of the date setting window.
void ShowSetDateWindow(Window *parent, int window_number, TimerGameEconomy::Date initial_date, TimerGameEconomy::Year min_year, TimerGameEconomy::Year max_year, SetDateCallback *callback, void *callback_data)
Create the new 'set date' window.
Definition date_gui.cpp:216
Functions related to the graphical selection of a date.
void SetDateCallback(const Window *w, TimerGameEconomy::Date date, void *data)
Callback for when a date has been chosen.
Definition date_gui.h:21
Types related to the date widgets.
@ WID_SD_DAY
Dropdown for the day.
Definition date_widget.h:15
@ WID_SD_YEAR
Dropdown for the year.
Definition date_widget.h:17
@ WID_SD_SET_DATE
Actually set the date.
Definition date_widget.h:18
@ WID_SD_MONTH
Dropdown for the month.
Definition date_widget.h:16
void ShowDropDownList(Window *w, DropDownList &&list, int selected, WidgetID button, uint width, bool instant_close, bool persist)
Show a drop down list.
Definition dropdown.cpp:404
Functions related to the drop down widget.
Types related to the drop down widget.
std::vector< std::unique_ptr< const DropDownListItem > > DropDownList
A drop down list is a collection of drop down list items.
Dimension maxdim(const Dimension &d1, const Dimension &d2)
Compute bounding box of both dimensions.
Geometry functions.
Dimension GetStringBoundingBox(std::string_view str, FontSize start_fontsize)
Return the string dimension in pixels.
Definition gfx.cpp:851
constexpr NWidgetPart SetFill(uint16_t fill_x, uint16_t fill_y)
Widget part function for setting filling.
constexpr NWidgetPart SetPIP(uint8_t pre, uint8_t inter, uint8_t post)
Widget part function for setting a pre/inter/post spaces.
constexpr NWidgetPart SetDataTip(uint32_t data, StringID tip)
Widget part function for setting the data and tooltip.
constexpr NWidgetPart SetMinimalSize(int16_t x, int16_t y)
Widget part function for setting the minimal size.
constexpr NWidgetPart NWidget(WidgetType tp, Colours col, WidgetID idx=-1)
Widget part function for starting a new 'real' widget.
constexpr NWidgetPart EndContainer()
Widget part function for denoting the end of a container (horizontal, vertical, WWT_FRAME,...
void SetDirty() const
Mark entire window as dirty (in need of re-paint)
Definition window.cpp:940
constexpr T Clamp(const T a, const T min, const T max)
Clamp a value between an interval.
Definition math_func.hpp:79
A number of safeguards to prevent using unsafe methods.
Definition of base types and functions in a cross-platform compatible way.
void SetDParamMaxValue(size_t n, uint64_t max_value, uint min_count, FontSize size)
Set DParam n to some number that is suitable for string size computations.
Definition strings.cpp:127
void SetDParam(size_t n, uint64_t v)
Set a string parameter v at index n in the global string parameter array.
Definition strings.cpp:104
Functions related to OTTD's strings.
Dimensions (a width and height) of a rectangle in 2D.
Partial widget specification to allow NWidgets to be written nested.
Coordinates of a point in 2D.
Window to select a date graphically by using dropdowns.
Definition date_gui.cpp:26
SetDateWindow(WindowDesc &desc, WindowNumber window_number, Window *parent, TimerGameEconomy::Date initial_date, TimerGameEconomy::Year min_year, TimerGameEconomy::Year max_year, SetDateCallback *callback, void *callback_data)
Create the new 'set date' window.
Definition date_gui.cpp:43
Point OnInitialPosition(int16_t sm_width, int16_t sm_height, int window_number) override
Compute the initial position of the window.
Definition date_gui.cpp:59
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
Definition date_gui.cpp:141
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
Definition date_gui.cpp:103
void OnDropdownSelect(WidgetID widget, int index) override
A dropdown option associated to this window has been selected.
Definition date_gui.cpp:157
TimerGameEconomy::Year min_year
The minimum year in the year dropdown.
Definition date_gui.cpp:30
SetDateCallback * callback
Callback to call when a date has been selected.
Definition date_gui.cpp:27
void SetStringParameters(WidgetID widget) const override
Initialize string parameters for a widget.
Definition date_gui.cpp:132
void * callback_data
Callback data pointer.
Definition date_gui.cpp:28
void ShowDateDropDown(WidgetID widget)
Helper function to construct the dropdown.
Definition date_gui.cpp:69
TimerGameEconomy::Year max_year
The maximum year (inclusive) in the year dropdown.
Definition date_gui.cpp:31
TimerGameEconomy::YearMonthDay date
The currently selected date.
Definition date_gui.cpp:29
Templated helper to make a type-safe 'typedef' representing a single POD value.
High level window description.
Definition window_gui.h:159
Data structure for an opened window.
Definition window_gui.h:273
virtual void Close(int data=0)
Hide the window and all its child windows, and mark them for a later deletion.
Definition window.cpp:1047
Window * parent
Parent window.
Definition window_gui.h:328
ResizeInfo resize
Resize information.
Definition window_gui.h:314
int left
x position of left edge of the window
Definition window_gui.h:309
int top
y position of top edge of the window
Definition window_gui.h:310
const NWID * GetWidget(WidgetID widnum) const
Get the nested widget with number widnum from the nested widget tree.
Definition window_gui.h:977
void InitNested(WindowNumber number=0)
Perform complete initialization of the Window with nested widgets, to allow use.
Definition window.cpp:1746
int height
Height of the window (number of pixels down in y direction)
Definition window_gui.h:312
int width
width of the window (number of pixels to the right in x direction)
Definition window_gui.h:311
WindowNumber window_number
Window number within the window class.
Definition window_gui.h:302
Definition of the game-economy-timer.
@ NC_EQUALSIZE
Value of the NCB_EQUALSIZE flag.
@ WWT_PUSHTXTBTN
Normal push-button (no toggle button) with text caption.
@ NWID_SPACER
Invisible widget that takes some space.
Definition widget_type.h:79
@ NWID_HORIZONTAL
Horizontal container.
Definition widget_type.h:75
@ WWT_PANEL
Simple depressed panel.
Definition widget_type.h:50
@ WWT_CAPTION
Window caption (window title between closebox and stickybox)
Definition widget_type.h:61
@ NWID_VERTICAL
Vertical container.
Definition widget_type.h:77
@ WWT_CLOSEBOX
Close box (at top-left of a window)
Definition widget_type.h:69
@ WWT_DROPDOWN
Drop down list.
Definition widget_type.h:70
void CloseWindowByClass(WindowClass cls, int data)
Close all windows of a given class.
Definition window.cpp:1152
Window functions not directly related to making/drawing windows.
Functions, definitions and such used only by the GUI.
@ WDP_CENTER
Center the window.
Definition window_gui.h:148
int WidgetID
Widget ID.
Definition window_type.h:18
int32_t WindowNumber
Number to differentiate different windows of the same class.
@ WC_SET_DATE
Set date; Window numbers:
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
Definition window_type.h:45