|
OpenTTD Source
1.10.0-RC1
|
Functions, definitions and such used only by the GUI. More...
#include "vehicle_type.h"#include "viewport_type.h"#include "company_type.h"#include "tile_type.h"#include "widget_type.h"#include "core/smallvec_type.hpp"#include "core/smallmap_type.hpp"#include "string_type.h"Go to the source code of this file.
Data Structures | |
| struct | WindowDesc |
| High level window description. More... | |
| struct | ResizeInfo |
| Data structure for resizing a window. More... | |
| struct | ViewportData |
| Data structure for a window viewport. More... | |
| struct | Window |
| Data structure for an opened window. More... | |
| class | PickerWindowBase |
| Base class for windows opened from a toolbar. More... | |
Macros | |
| #define | FOR_ALL_WINDOWS_FROM_BACK_FROM(w, start) for (w = start; w != nullptr; w = w->z_front) if (w->window_class != WC_INVALID) |
| Iterate over all windows. | |
| #define | FOR_ALL_WINDOWS_FROM_FRONT_FROM(w, start) for (w = start; w != nullptr; w = w->z_back) if (w->window_class != WC_INVALID) |
| #define | FOR_ALL_WINDOWS_FROM_BACK(w) FOR_ALL_WINDOWS_FROM_BACK_FROM(w, _z_back_window) |
| #define | FOR_ALL_WINDOWS_FROM_FRONT(w) FOR_ALL_WINDOWS_FROM_FRONT_FROM(w, _z_front_window) |
Functions | |
| void | DrawFrameRect (int left, int top, int right, int bottom, Colours colour, FrameFlags flags) |
| Draw frame rectangle. More... | |
| void | DrawCaption (const Rect &r, Colours colour, Owner owner, StringID str) |
| Draw a caption bar. More... | |
| Point | GetToolbarAlignedWindowPosition (int window_width) |
| Computer the position of the top-left corner of a window to be opened right under the toolbar. More... | |
| Window * | BringWindowToFrontById (WindowClass cls, WindowNumber number) |
| Find a window and make it the relative top-window on the screen. More... | |
| Window * | FindWindowFromPt (int x, int y) |
| Do a search for a window at specific coordinates. More... | |
| template<typename Wcls > | |
| Wcls * | AllocateWindowDescFront (WindowDesc *desc, int window_number, bool return_existing=false) |
| Open a new window. More... | |
| void | RelocateAllWindows (int neww, int newh) |
| Relocate all windows to fit the new size of the game application screen. More... | |
| void | GuiShowTooltips (Window *parent, StringID str, uint paramcount=0, const uint64 params[]=nullptr, TooltipCloseCondition close_tooltip=TCC_HOVER) |
| Shows a tooltip. More... | |
| int | GetWidgetFromPos (const Window *w, int x, int y) |
| Returns the index for the widget located at the given position relative to the window. More... | |
| void | SetFocusedWindow (Window *w) |
| Set the window that has the focus. More... | |
| void | ScrollbarClickHandler (Window *w, NWidgetCore *nw, int x, int y) |
| Special handling for the scrollbar widget type. More... | |
Variables | |
| Window * | _z_front_window |
| List of windows opened at the screen sorted from the front. More... | |
| Window * | _z_back_window |
| List of windows opened at the screen sorted from the back. More... | |
| Window * | _focused_window |
| static const int | TIMEOUT_DURATION = 7 |
| The initial timeout value for WF_TIMEOUT. | |
| static const int | WHITE_BORDER_DURATION = 3 |
| The initial timeout value for WF_WHITE_BORDER. | |
| Point | _cursorpos_drag_start |
| int | _scrollbar_start_pos |
| int | _scrollbar_size |
| byte | _scroller_click_timeout |
| bool | _scrolling_viewport |
| A viewport is being scrolled with the mouse. | |
| bool | _mouse_hovering |
| The mouse is hovering over the same point. | |
| SpecialMouseMode | _special_mouse_mode |
| Mode of the mouse. | |
Functions, definitions and such used only by the GUI.
Definition in file window_gui.h.
| enum FrameFlags |
Flags to describe the look of the frame.
Definition at line 25 of file window_gui.h.
| enum SortButtonState |
State of a sort direction button.
| Enumerator | |
|---|---|
| SBS_OFF | Do not sort (with this button). |
| SBS_DOWN | Sort ascending. |
| SBS_UP | Sort descending. |
Definition at line 222 of file window_gui.h.
| enum SpecialMouseMode |
Mouse modes.
| Enumerator | |
|---|---|
| WSM_NONE | No special mouse mode. |
| WSM_DRAGDROP | Dragging an object. |
| WSM_SIZING | Sizing mode. |
| WSM_PRESIZE | Presizing mode (docks, tunnels). |
Definition at line 904 of file window_gui.h.
| enum WidgetDrawDistances |
Distances used in drawing widgets.
Definition at line 36 of file window_gui.h.
| enum WindowDefaultFlag |
Window default widget/window handling flags.
Definition at line 207 of file window_gui.h.
| enum WindowFlags |
Window flags.
| Enumerator | |
|---|---|
| WF_TIMEOUT | Window timeout counter. |
| WF_DRAGGING | Window is being dragged. |
| WF_SIZING_RIGHT | Window is being resized towards the right. |
| WF_SIZING_LEFT | Window is being resized towards the left. |
| WF_SIZING | Window is being resized. |
| WF_STICKY | Window is made sticky by user. |
| WF_DISABLE_VP_SCROLL | Window does not do autoscroll,.
|
| WF_WHITE_BORDER | Window white border counter bit mask. |
| WF_HIGHLIGHTED | Window has a widget that has a highlight. |
| WF_CENTERED | Window is centered and shall stay centered after ReInit. |
Definition at line 231 of file window_gui.h.
| enum WindowPosition |
How do we the window to be placed?
| Enumerator | |
|---|---|
| WDP_MANUAL | Manually align the window (so no automatic location finding) |
| WDP_AUTO | Find a place automatically. |
| WDP_CENTER | Center the window. |
| WDP_ALIGN_TOOLBAR | Align toward the toolbar. |
Definition at line 152 of file window_gui.h.
| Wcls* AllocateWindowDescFront | ( | WindowDesc * | desc, |
| int | window_number, | ||
| bool | return_existing = false |
||
| ) |
Open a new window.
| Wcls | Window class to use if the window does not exist. |
| desc | The pointer to the WindowDesc to be created |
| window_number | the window number of the new window |
| return_existing | If set, also return the window if it already existed. |
nullptr. Definition at line 874 of file window_gui.h.
References BringWindowToFrontById(), WindowDesc::cls, GuiShowTooltips(), and RelocateAllWindows().
| Window* BringWindowToFrontById | ( | WindowClass | cls, |
| WindowNumber | number | ||
| ) |
Find a window and make it the relative top-window on the screen.
The window gets unshaded if it was shaded, and a white border is drawn at its edges for a brief period of time to visualize its "activation".
| cls | WindowClass of the window to activate |
| number | WindowNumber of the window to activate |
Definition at line 1262 of file window.cpp.
References BringWindowToFront(), FindWindowById(), Window::IsShaded(), Window::SetDirty(), Window::SetShaded(), and Window::SetWhiteBorder().
Referenced by AllocateWindowDescFront(), DoSelectCompanyManagerFace(), ShowAIDebugWindow(), ShowCompanyFinances(), ShowDepotWindow(), ShowGenerateWorldProgress(), and ShowIndustryCargoesWindow().
Draw a caption bar.
| r | Rectangle of the bar. |
| colour | Colour of the window. |
| owner | 'Owner' of the window. |
| str | Text to draw in the bar. |
Definition at line 538 of file widget.cpp.
References _colour_gradient, _company_colours, DrawFrameRect(), DrawString(), FR_BORDERONLY, FR_DARKENED, FR_LOWERED, GetStringBoundingBox(), GfxFillRect(), max(), MAX_COMPANIES, WD_CAPTIONTEXT_LEFT, and WD_CAPTIONTEXT_RIGHT.
Referenced by NewsWindow::DrawWidget().
| void DrawFrameRect | ( | int | left, |
| int | top, | ||
| int | right, | ||
| int | bottom, | ||
| Colours | colour, | ||
| FrameFlags | flags | ||
| ) |
Draw frame rectangle.
| left | Left edge of the frame |
| top | Top edge of the frame |
| right | Right edge of the frame |
| bottom | Bottom edge of the frame |
| colour | Colour table to use. |
| flags | Flags controlling how to draw the frame. |
Definition at line 175 of file widget.cpp.
Referenced by DrawButtonDropdown(), DrawCaption(), DrawInset(), DrawMatrix(), DrawResizeBox(), BaseNetworkContentDownloadStatusWindow::DrawWidget(), GenerateProgressWindow::DrawWidget(), ScanProgressWindow::DrawWidget(), and Window::DrawWidgets().
| Window* FindWindowFromPt | ( | int | x, |
| int | y | ||
| ) |
Do a search for a window at specific coordinates.
For this we start at the topmost window, obviously and work our way down to the bottom
| x | position x to query |
| y | position y to query |
Definition at line 1881 of file window.cpp.
Referenced by HandleMouseOver().
| Point GetToolbarAlignedWindowPosition | ( | int | window_width | ) |
Computer the position of the top-left corner of a window to be opened right under the toolbar.
| window_width | the width of the window to get the position for |
Definition at line 1735 of file window.cpp.
References FindWindowById(), and WC_MAIN_TOOLBAR.
Referenced by TransparenciesWindow::OnInitialPosition(), and TerraformToolbarWindow::OnInitialPosition().
| int GetWidgetFromPos | ( | const Window * | w, |
| int | x, | ||
| int | y | ||
| ) |
Returns the index for the widget located at the given position relative to the window.
It includes all widget-corner pixels as well.
Definition at line 160 of file widget.cpp.
Referenced by DropdownWindow::GetDropDownItem(), and Window::OnDropdownClose().
| void GuiShowTooltips | ( | Window * | parent, |
| StringID | str, | ||
| uint | paramcount, | ||
| const uint64 | params[], | ||
| TooltipCloseCondition | close_tooltip | ||
| ) |
Shows a tooltip.
| parent | The window this tooltip is related to. |
| str | String to be displayed |
| paramcount | number of params to deal with |
| params | (optional) up to 5 pieces of additional information that may be added to a tooltip |
| close_tooltip | when the left (true) or right (false) mouse button is released |
Definition at line 764 of file misc_gui.cpp.
References DeleteWindowById(), Window::GetWidget(), Window::InvalidateData(), Window::IsWidgetGloballyFocused(), Window::SetWidgetDirty(), WC_OSK, WC_TOOLTIPS, and Window::window_class.
Referenced by AllocateWindowDescFront(), and IndustryCargoesWindow::OnTooltip().
| void RelocateAllWindows | ( | int | neww, |
| int | newh | ||
| ) |
Relocate all windows to fit the new size of the game application screen.
| neww | New width of the game application screen |
| newh | New height of the game application screen. |
Definition at line 3567 of file window.cpp.
References DeleteWindowById(), and WC_DROPDOWN_MENU.
Referenced by AllocateWindowDescFront().
| void ScrollbarClickHandler | ( | Window * | w, |
| NWidgetCore * | nw, | ||
| int | x, | ||
| int | y | ||
| ) |
Special handling for the scrollbar widget type.
Handles the special scrolling buttons and other scrolling.
| w | Window on which a scroll was performed. |
| nw | Pointer to the scrollbar widget. |
| x | The X coordinate of the mouse click. |
| y | The Y coordinate of the mouse click. |
Definition at line 136 of file widget.cpp.
| void SetFocusedWindow | ( | Window * | w | ) |
Set the window that has the focus.
| w | The window to set the focus on |
Definition at line 434 of file window.cpp.
References Window::nested_focus, and NWidgetBase::SetDirty().
Referenced by Window::InitializeData(), SignListWindow::OnHotkey(), and Window::OnHotkey().
| Window* _z_back_window |
List of windows opened at the screen sorted from the back.
Definition at line 59 of file window.cpp.
| Window* _z_front_window |
List of windows opened at the screen sorted from the front.
Definition at line 57 of file window.cpp.