The Battle for Wesnoth  1.19.0+dev
image.hpp
Go to the documentation of this file.
1 /*
2  Copyright (C) 2008 - 2024
3  by Mark de Wever <koraq@xs4all.nl>
4  Part of the Battle for Wesnoth Project https://www.wesnoth.org/
5 
6  This program is free software; you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation; either version 2 of the License, or
9  (at your option) any later version.
10  This program is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY.
12 
13  See the COPYING file for more details.
14 */
15 
16 #pragma once
17 
19 
22 
23 namespace gui2
24 {
25 namespace implementation
26 {
27  struct builder_image;
28 }
29 
30 // ------------ WIDGET -----------{
31 
32 class image : public styled_widget
33 {
34 public:
35  explicit image(const implementation::builder_image& builder);
36 
37  /**
38  * Wrapper for set_label.
39  *
40  * Some people considered this function missing and confusing so added
41  * this forward version.
42  *
43  * @param label The filename image to show.
44  */
45  void set_image(const t_string& label)
46  {
48  }
49 
50  /**
51  * Wrapper for label.
52  *
53  * Some people considered this function missing and confusing so added
54  * this forward version.
55  *
56  * @returns The filename of the image shown.
57  */
59  {
60  return get_label();
61  }
62 
63  virtual bool can_mouse_focus() const override { return !tooltip().empty(); }
64 
65  /***** ***** ***** ***** layout functions ***** ***** ***** *****/
66 
67 private:
68  /** See @ref widget::calculate_best_size. */
69  virtual point calculate_best_size() const override;
70 
71 public:
72  /***** ***** ***** ***** Inherited ***** ***** ***** *****/
73 
74  /** See @ref styled_widget::set_active. */
75  virtual void set_active(const bool active) override;
76 
77  /** See @ref styled_widget::get_active. */
78  virtual bool get_active() const override;
79 
80  /** See @ref styled_widget::get_state. */
81  virtual unsigned get_state() const override;
82 
83  /** See @ref widget::disable_click_dismiss. */
84  bool disable_click_dismiss() const override;
85 
86 private:
87  /**
88  * Possible states of the widget.
89  *
90  * Note the order of the states must be the same as defined in settings.hpp.
91  */
92  enum state_t {
94  };
95 
96 public:
97  /** Static type getter that does not rely on the widget being constructed. */
98  static const std::string& type();
99 
100 private:
101  /** Inherited from styled_widget, implemented by REGISTER_WIDGET. */
102  virtual const std::string& get_control_type() const override;
103 };
104 
105 // }---------- DEFINITION ---------{
106 
108 {
109  explicit image_definition(const config& cfg);
110 
112  {
113  explicit resolution(const config& cfg);
114  };
115 };
116 
117 // }---------- BUILDER -----------{
118 
119 namespace implementation
120 {
121 
123 {
124  explicit builder_image(const config& cfg);
125 
127 
128  virtual std::unique_ptr<widget> build() const override;
129 };
130 
131 } // namespace implementation
132 
133 // }------------ END --------------
134 
135 } // namespace gui2
A config object defines a single node in a WML file, with access to child nodes.
Definition: config.hpp:159
t_string get_image() const
Wrapper for label.
Definition: image.hpp:58
virtual void set_active(const bool active) override
See styled_widget::set_active.
Definition: image.cpp:77
virtual bool get_active() const override
See styled_widget::get_active.
Definition: image.cpp:82
virtual point calculate_best_size() const override
See widget::calculate_best_size.
Definition: image.cpp:43
bool disable_click_dismiss() const override
See widget::disable_click_dismiss.
Definition: image.cpp:92
image(const implementation::builder_image &builder)
Definition: image.cpp:38
virtual unsigned get_state() const override
See styled_widget::get_state.
Definition: image.cpp:87
virtual const std::string & get_control_type() const override
Inherited from styled_widget, implemented by REGISTER_WIDGET.
state_t
Possible states of the widget.
Definition: image.hpp:92
void set_image(const t_string &label)
Wrapper for set_label.
Definition: image.hpp:45
static const std::string & type()
Static type getter that does not rely on the widget being constructed.
virtual bool can_mouse_focus() const override
Whether the mouse move/click event go 'through' this widget.
Definition: image.hpp:63
const t_string & get_label() const
const t_string & tooltip() const
virtual void set_label(const t_string &text)
bool empty() const
Definition: tstring.hpp:186
Generic file dialog.
Functions to load and save images from/to disk.
Contains the implementation details for lexical_cast and shouldn't be used directly.
resolution(const config &cfg)
Definition: image.cpp:107
image_definition(const config &cfg)
Definition: image.cpp:99
virtual std::unique_ptr< widget > build() const override
Definition: image.cpp:123
builder_image(const config &cfg)
Definition: image.cpp:119
virtual std::unique_ptr< widget > build() const=0
Holds a 2D point.
Definition: point.hpp:25