src/widgets/dropdown_type.h

   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
   8 /** @file dropdown_type.h Types related to the drop down widget. */
   9
  10 #ifndef WIDGETS_DROPDOWN_TYPE_H
  11 #define WIDGETS_DROPDOWN_TYPE_H
  12
  13 #include "../window_type.h"
  14 #include "../gfx_func.h"
  15 #include "../core/smallvec_type.hpp"
  16 #include "table/strings.h"
  17
  18 /**
  19  * Base list item class from which others are derived. If placed in a list it
  20  * will appear as a horizontal line in the menu.
  21  */
  22 class DropDownListItem {
  23 public:
  24         int result;  ///< Result code to return to window on selection
  25         bool masked; ///< Masked and unselectable item
  26
  27         DropDownListItem(int result, bool masked) : result(result), masked(masked) {}
  28         virtual ~DropDownListItem() {}
  29
  30         virtual bool Selectable() const { return false; }
  31         virtual uint Height(uint width) const { return FONT_HEIGHT_NORMAL; }
  32         virtual uint Width() const { return 0; }
  33         virtual void Draw(int left, int right, int top, int bottom, bool sel, Colours bg_colour) const;
  34 };
  35
  36 /**
  37  * Common string list item.
  38  */
  39 class DropDownListStringItem : public DropDownListItem {
  40 public:
  41         StringID string; ///< String ID of item
  42
  43         DropDownListStringItem(StringID string, int result, bool masked) : DropDownListItem(result, masked), string(string) {}
  44
  45         bool Selectable() const override { return true; }
  46         uint Width() const override;
  47         void Draw(int left, int right, int top, int bottom, bool sel, Colours bg_colour) const override;
  48         virtual StringID String() const { return this->string; }
  49
  50         static bool NatSortFunc(std::unique_ptr<const DropDownListItem> const &first, std::unique_ptr<const DropDownListItem> const &second);
  51 };
  52
  53 /**
  54  * String list item with parameters.
  55  */
  56 class DropDownListParamStringItem : public DropDownListStringItem {
  57 public:
  58         uint64 decode_params[10]; ///< Parameters of the string
  59
  60         DropDownListParamStringItem(StringID string, int result, bool masked) : DropDownListStringItem(string, result, masked) {}
  61
  62         StringID String() const override;
  63         void SetParam(uint index, uint64 value) { decode_params[index] = value; }
  64         void SetParamStr(uint index, const char *str) { this->SetParam(index, (uint64)(size_t)str); }
  65 };
  66
  67 /**
  68  * List item containing a C char string.
  69  */
  70 class DropDownListCharStringItem : public DropDownListStringItem {
  71 public:
  72         std::string raw_string;
  73
  74         DropDownListCharStringItem(const std::string &raw_string, int result, bool masked) : DropDownListStringItem(STR_JUST_RAW_STRING, result, masked), raw_string(raw_string) {}
  75
  76         StringID String() const override;
  77 };
  78
  79 /**
  80  * List item with icon and string.
  81  */
  82 class DropDownListIconItem : public DropDownListParamStringItem {
  83         SpriteID sprite;
  84         PaletteID pal;
  85         Dimension dim;
  86         uint sprite_y;
  87 public:
  88         DropDownListIconItem(SpriteID sprite, PaletteID pal, StringID string, int result, bool masked);
  89
  90         uint Height(uint width) const override;
  91         uint Width() const override;
  92         void Draw(int left, int right, int top, int bottom, bool sel, Colours bg_colour) const override;
  93         void SetDimension(Dimension d);
  94 };
  95
  96 /**
  97  * A drop down list is a collection of drop down list items.
  98  */
  99 typedef std::vector<std::unique_ptr<const DropDownListItem>> DropDownList;
 100
 101 void ShowDropDownListAt(Window *w, DropDownList &&list, int selected, int button, Rect wi_rect, Colours wi_colour, bool auto_width = false, bool instant_close = false);
 102
 103 void ShowDropDownList(Window *w, DropDownList &&list, int selected, int button, uint width = 0, bool auto_width = false, bool instant_close = false);
 104
 105 #endif /* WIDGETS_DROPDOWN_TYPE_H */