The Battle for Wesnoth  1.19.0-dev
prompt.hpp
Go to the documentation of this file.
1 /*
2  Copyright (C) 2023 - 2024
3  Part of the Battle for Wesnoth Project https://www.wesnoth.org/
4 
5  This program is free software; you can redistribute it and/or modify
6  it under the terms of the GNU General Public License as published by
7  the Free Software Foundation; either version 2 of the License, or
8  (at your option) any later version.
9  This program is distributed in the hope that it will be useful,
10  but WITHOUT ANY WARRANTY.
11 
12  See the COPYING file for more details.
13 */
14 
15 #pragma once
16 
18 
19 namespace gui2
20 {
21 
22 namespace dialogs
23 {
24 
25 /**
26  * @ingroup GUIWindowDefinitionWML
27  *
28  * Dialog for getting a single text value from the player.
29  * Key |Type |Mandatory|Description
30  * ------------------|---------------|---------|-----------
31  * prompt_box | text_box |yes |The text box to enter the value into.
32  */
33 class prompt : public modal_dialog
34 {
35 public:
36  prompt(std::string& value);
37 
38  /** The execute function. See @ref modal_dialog for more information. */
40 
41 private:
42  virtual void pre_show(window& window) override;
43  virtual void post_show(window& window) override;
44 
45  virtual const std::string& window_id() const override;
46 
47  std::string& value_;
48 };
49 
50 } // namespace dialogs
51 } // namespace gui2
Abstract base class for all modal dialogs.
Dialog for getting a single text value from the player.
Definition: prompt.hpp:34
virtual void post_show(window &window) override
Actions to be taken after the window has been shown.
Definition: prompt.cpp:40
std::string & value_
Definition: prompt.hpp:47
prompt(std::string &value)
Definition: prompt.cpp:27
virtual const std::string & window_id() const override
The ID of the window to build.
virtual void pre_show(window &window) override
The execute function.
Definition: prompt.cpp:34
base class of top level items, the only item which needs to store the final canvases to draw on.
Definition: window.hpp:63
#define DEFINE_SIMPLE_EXECUTE_WRAPPER(dialog)
Adds a bare-bonesstatic execute function to a dialog class that immediately invokes and return the re...
Various uncategorised dialogs.
Generic file dialog.