dropdown.cpp

Go to the documentation of this file.

/*
 * This file is part of OpenTTD.
 * 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.
 * 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.
 * 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/>.
 */
 
#include "stdafx.h"
#include "dropdown_type.h"
#include "dropdown_func.h"
#include "strings_func.h"
#include "timer/timer.h"
#include "timer/timer_window.h"
#include "window_gui.h"
#include "window_func.h"
#include "zoom_func.h"
 
#include "widgets/dropdown_widget.h"
 
#include "table/strings.h"
 
#include "dropdown_common_type.h"
 
#include "safeguards.h"
 
std::unique_ptr<DropDownListItem> MakeDropDownListDividerItem()
{
  return std::make_unique<DropDownListDividerItem>(-1);
}
 
std::unique_ptr<DropDownListItem> MakeDropDownListStringItem(StringID str, int value, bool masked, bool shaded)
{
  return MakeDropDownListStringItem(GetString(str), value, masked, shaded);
}
 
std::unique_ptr<DropDownListItem> MakeDropDownListStringItem(std::string &&str, int value, bool masked, bool shaded)
{
  return std::make_unique<DropDownListStringItem>(std::move(str), value, masked, shaded);
}
 
std::unique_ptr<DropDownListItem> MakeDropDownListIconItem(SpriteID sprite, PaletteID palette, StringID str, int value, bool masked, bool shaded)
{
  return std::make_unique<DropDownListIconItem>(sprite, palette, GetString(str), value, masked, shaded);
}
 
std::unique_ptr<DropDownListItem> MakeDropDownListIconItem(const Dimension &dim, SpriteID sprite, PaletteID palette, StringID str, int value, bool masked, bool shaded)
{
  return std::make_unique<DropDownListIconItem>(dim, sprite, palette, GetString(str), value, masked, shaded);
}
 
std::unique_ptr<DropDownListItem> MakeDropDownListCheckedItem(bool checked, StringID str, int value, bool masked, bool shaded, uint indent)
{
  return std::make_unique<DropDownListCheckedItem>(indent, checked, GetString(str), value, masked, shaded);
}
 
static constexpr NWidgetPart _nested_dropdown_menu_widgets[] = {
  NWidget(NWID_HORIZONTAL),
    NWidget(WWT_PANEL, COLOUR_END, WID_DM_ITEMS), SetScrollbar(WID_DM_SCROLL), EndContainer(),
    NWidget(NWID_SELECTION, INVALID_COLOUR, WID_DM_SHOW_SCROLL),
      NWidget(NWID_VSCROLLBAR, COLOUR_END, WID_DM_SCROLL),
    EndContainer(),
  EndContainer(),
};
 
static WindowDesc _dropdown_desc(
  WDP_MANUAL, {}, 0, 0,
  WC_DROPDOWN_MENU, WC_NONE,
  WindowDefaultFlag::NoFocus,
  _nested_dropdown_menu_widgets
);
 
struct DropdownWindow : Window {
  WidgetID parent_button{}; 
  Rect wi_rect{}; 
  DropDownList list{}; 
  int selected_result = 0; 
  int selected_click_result = -1; 
  uint8_t click_delay = 0; 
  bool drag_mode = true;
  bool instant_close = false; 
  bool persist = false; 
  int scrolling = 0; 
  Point position{}; 
  Scrollbar *vscroll = nullptr;
 
  Dimension items_dim{}; 
 
  DropdownWindow(Window *parent, DropDownList &&list, int selected, WidgetID button, const Rect wi_rect, bool instant_close, Colours wi_colour, bool persist)
      : Window(_dropdown_desc)
      , parent_button(button)
      , wi_rect(wi_rect)
      , list(std::move(list))
      , selected_result(selected)
      , instant_close(instant_close)
      , persist(persist)
  {
    assert(!this->list.empty());
 
    this->parent = parent;
 
    this->CreateNestedTree();
 
    this->GetWidget<NWidgetCore>(WID_DM_ITEMS)->colour = wi_colour;
    this->GetWidget<NWidgetCore>(WID_DM_SCROLL)->colour = wi_colour;
    this->vscroll = this->GetScrollbar(WID_DM_SCROLL);
    this->UpdateSizeAndPosition();
 
    this->FinishInitNested(0);
    this->flags.Reset(WindowFlag::WhiteBorder);
  }
  DropdownWindow(Window *parent, DropDownList &&list, int selected, WidgetID button, const Rect wi_rect, bool instant_close, Colours wi_colour, bool persist) {…}
 
  void Close([[maybe_unused]] int data = 0) override
  {
    /* Finish closing the dropdown, so it doesn't affect new window placement.
     * Also mark it dirty in case the callback deals with the screen. (e.g. screenshots). */
    this->Window::Close();
 
    Point pt = _cursor.pos;
    pt.x -= this->parent->left;
    pt.y -= this->parent->top;
    this->parent->OnDropdownClose(pt, this->parent_button, this->selected_result, this->selected_click_result, this->instant_close);
 
    /* Set flag on parent widget to indicate that we have just closed. */
    NWidgetCore *nwc = this->parent->GetWidget<NWidgetCore>(this->parent_button);
    if (nwc != nullptr) nwc->disp_flags.Set(NWidgetDisplayFlag::DropdownClosed);
  }
  void Close([[maybe_unused]] int data = 0) override {…}
 
  void OnFocusLost(bool closing) override
  {
    if (!closing) {
      this->instant_close = false;
      this->Close();
    }
  }
  void OnFocusLost(bool closing) override {…}
 
  void FitAvailableHeight(Dimension &desired, const Dimension &list, uint available_height)
  {
    if (desired.height < available_height) return;
 
    /* If the dropdown doesn't fully fit, we a need a dropdown. */
    uint avg_height = list.height / (uint)this->list.size();
    uint rows = std::max((available_height - WidgetDimensions::scaled.dropdownlist.Vertical()) / avg_height, 1U);
 
    desired.width = std::max(list.width, desired.width - NWidgetScrollbar::GetVerticalDimension().width);
    desired.height = rows * avg_height + WidgetDimensions::scaled.dropdownlist.Vertical();
  }
  void FitAvailableHeight(Dimension &desired, const Dimension &list, uint available_height) {…}
 
  void UpdateSizeAndPosition()
  {
    Rect button_rect = this->wi_rect.Translate(this->parent->left, this->parent->top);
 
    /* Get the dimensions required for the list. */
    Dimension list_dim = GetDropDownListDimension(this->list);
 
    /* Set up dimensions for the items widget. */
    Dimension widget_dim = list_dim;
    widget_dim.width += WidgetDimensions::scaled.dropdownlist.Horizontal();
    widget_dim.height += WidgetDimensions::scaled.dropdownlist.Vertical();
 
    /* Width should match at least the width of the parent widget. */
    widget_dim.width = std::max<uint>(widget_dim.width, button_rect.Width());
 
    /* Available height below (or above, if the dropdown is placed above the widget). */
    uint available_height_below = std::max(GetMainViewBottom() - button_rect.bottom - 1, 0);
    uint available_height_above = std::max(button_rect.top - 1 - GetMainViewTop(), 0);
 
    /* Is it better to place the dropdown above the widget? */
    if (widget_dim.height > available_height_below && available_height_above > available_height_below) {
      FitAvailableHeight(widget_dim, list_dim, available_height_above);
      this->position.y = button_rect.top - widget_dim.height;
    } else {
      FitAvailableHeight(widget_dim, list_dim, available_height_below);
      this->position.y = button_rect.bottom + 1;
    }
 
    if (_current_text_dir == TD_RTL) {
      /* In case the list is wider than the parent button, the list should be right aligned to the button and overflow to the left. */
      this->position.x = button_rect.right + 1 - (int)(widget_dim.width + (list_dim.height > widget_dim.height ? NWidgetScrollbar::GetVerticalDimension().width : 0));
    } else {
      this->position.x = button_rect.left;
    }
 
    this->items_dim = widget_dim;
    this->GetWidget<NWidgetStacked>(WID_DM_SHOW_SCROLL)->SetDisplayedPlane(list_dim.height > widget_dim.height ? 0 : SZSP_NONE);
 
    /* Capacity is the average number of items visible */
    this->vscroll->SetCapacity((widget_dim.height - WidgetDimensions::scaled.dropdownlist.Vertical()) * this->list.size() / list_dim.height);
    this->vscroll->SetCount(this->list.size());
 
    /* If the dropdown is positioned above the parent widget, start selection at the bottom. */
    if (this->position.y < button_rect.top && list_dim.height > widget_dim.height) this->vscroll->UpdatePosition(INT_MAX);
  }
  void UpdateSizeAndPosition() {…}
 
  void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
  {
    if (widget == WID_DM_ITEMS) size = this->items_dim;
  }
  void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override {…}
 
  Point OnInitialPosition([[maybe_unused]] int16_t sm_width, [[maybe_unused]] int16_t sm_height, [[maybe_unused]] int window_number) override
  {
    return this->position;
  }
  Point OnInitialPosition([[maybe_unused]] int16_t sm_width, [[maybe_unused]] int16_t sm_height, [[maybe_unused]] int window_number) override {…}
 
  bool GetDropDownItem(int &result, int &click_result)
  {
    if (GetWidgetFromPos(this, _cursor.pos.x - this->left, _cursor.pos.y - this->top) < 0) return false;
 
    const Rect &r = this->GetWidget<NWidgetBase>(WID_DM_ITEMS)->GetCurrentRect().Shrink(WidgetDimensions::scaled.dropdownlist).Shrink(WidgetDimensions::scaled.dropdowntext, RectPadding::zero);
    int y     = _cursor.pos.y - this->top - r.top;
    int pos   = this->vscroll->GetPosition();
 
    for (const auto &item : this->list) {
      /* Skip items that are scrolled up */
      if (--pos >= 0) continue;
 
      int item_height = item->Height();
 
      if (y < item_height) {
        if (item->masked || !item->Selectable()) return false;
        result = item->result;
        click_result = item->OnClick({r.left, 0, r.right, item_height - 1}, {_cursor.pos.x - this->left, y});
        return true;
      }
 
      y -= item_height;
    }
 
    return false;
  }
  bool GetDropDownItem(int &result, int &click_result) {…}
 
  void DrawWidget(const Rect &r, WidgetID widget) const override
  {
    if (widget != WID_DM_ITEMS) return;
 
    Colours colour = this->GetWidget<NWidgetCore>(widget)->colour;
 
    Rect ir = r.Shrink(WidgetDimensions::scaled.dropdownlist);
    int y = ir.top;
    int pos = this->vscroll->GetPosition();
    for (const auto &item : this->list) {
      int item_height = item->Height();
 
      /* Skip items that are scrolled up */
      if (--pos >= 0) continue;
 
      if (y + item_height - 1 <= ir.bottom) {
        Rect full{ir.left, y, ir.right, y + item_height - 1};
 
        bool selected = (this->selected_result == item->result) && item->Selectable();
        if (selected) GfxFillRect(full, PC_BLACK);
 
        item->Draw(full, full.Shrink(WidgetDimensions::scaled.dropdowntext, RectPadding::zero), selected, selected ? this->selected_click_result : -1, colour);
      }
      y += item_height;
    }
  }
  void DrawWidget(const Rect &r, WidgetID widget) const override {…}
 
  void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
  {
    if (widget != WID_DM_ITEMS) return;
    int result, click_result;
    if (this->GetDropDownItem(result, click_result)) {
      this->click_delay = 4;
      this->selected_result = result;
      this->selected_click_result = click_result;
      this->SetDirty();
    }
  }
  void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override {…}
 
  const IntervalTimer<TimerWindow> scroll_interval = {std::chrono::milliseconds(30), [this](auto) {
    if (this->scrolling == 0) return;
 
    if (this->vscroll->UpdatePosition(this->scrolling)) this->SetDirty();
 
    this->scrolling = 0;
  }};
  const IntervalTimer<TimerWindow> scroll_interval = {std::chrono::milliseconds(30), [this](auto) {…};
 
  void OnMouseLoop() override
  {
    if (this->click_delay != 0 && --this->click_delay == 0) {
      /* Close the dropdown, so it doesn't affect new window placement.
       * Also mark it dirty in case the callback deals with the screen. (e.g. screenshots). */
      if (!this->persist) this->Close();
      this->parent->OnDropdownSelect(this->parent_button, this->selected_result, this->selected_click_result);
      return;
    }
 
    if (this->drag_mode) {
      int result, click_result;
 
      if (!_left_button_clicked) {
        this->drag_mode = false;
        if (!this->GetDropDownItem(result, click_result)) {
          if (this->instant_close) this->Close();
          return;
        }
        this->click_delay = 2;
      } else {
        if (_cursor.pos.y <= this->top + WidgetDimensions::scaled.dropdownlist.top) {
          /* Cursor is above the list, set scroll up */
          this->scrolling = -1;
          return;
        } else if (_cursor.pos.y >= this->top + this->height - WidgetDimensions::scaled.dropdownlist.bottom) {
          /* Cursor is below list, set scroll down */
          this->scrolling = 1;
          return;
        }
 
        if (!this->GetDropDownItem(result, click_result)) return;
      }
 
      if (this->selected_result != result || this->selected_click_result != click_result) {
        this->selected_result = result;
        this->selected_click_result = click_result;
        this->SetDirty();
      }
    }
  }
  void OnMouseLoop() override {…}
 
  void ReplaceList(DropDownList &&list, std::optional<int> selected_result)
  {
    this->list = std::move(list);
    if (selected_result.has_value()) this->selected_result = *selected_result;
    this->UpdateSizeAndPosition();
    this->ReInit(0, 0);
    this->InitializePositionSize(this->position.x, this->position.y, this->nested_root->smallest_x, this->nested_root->smallest_y);
    this->FindWindowPlacementAndResize(this->window_desc.GetDefaultWidth(), this->window_desc.GetDefaultHeight(), true);
    this->SetDirty();
  }
};
struct DropdownWindow : Window {…};
 
void ReplaceDropDownList(Window *parent, DropDownList &&list, std::optional<int> selected_result)
{
  DropdownWindow *ddw = dynamic_cast<DropdownWindow *>(parent->FindChildWindow(WC_DROPDOWN_MENU));
  if (ddw != nullptr) ddw->ReplaceList(std::move(list), selected_result);
}
 
Dimension GetDropDownListDimension(const DropDownList &list)
{
  Dimension dim{};
  for (const auto &item : list) {
    dim.height += item->Height();
    dim.width = std::max(dim.width, item->Width());
  }
  dim.width += WidgetDimensions::scaled.dropdowntext.Horizontal();
  return dim;
}
Dimension GetDropDownListDimension(const DropDownList &list) {…}
 
void ShowDropDownListAt(Window *w, DropDownList &&list, int selected, WidgetID button, Rect wi_rect, Colours wi_colour, bool instant_close, bool persist)
{
  CloseWindowByClass(WC_DROPDOWN_MENU);
  new DropdownWindow(w, std::move(list), selected, button, wi_rect, instant_close, wi_colour, persist);
}
void ShowDropDownListAt(Window *w, DropDownList &&list, int selected, WidgetID button, Rect wi_rect, Colours wi_colour, bool instant_close, bool persist) {…}
 
void ShowDropDownList(Window *w, DropDownList &&list, int selected, WidgetID button, uint width, bool instant_close, bool persist)
{
  /* Our parent's button widget is used to determine where to place the drop
   * down list window. */
  NWidgetCore *nwi = w->GetWidget<NWidgetCore>(button);
  Rect wi_rect      = nwi->GetCurrentRect();
  Colours wi_colour = nwi->colour;
 
  if ((nwi->type & WWT_MASK) == NWID_BUTTON_DROPDOWN) {
    nwi->disp_flags.Set(NWidgetDisplayFlag::DropdownActive);
  } else {
    nwi->SetLowered(true);
  }
  nwi->SetDirty(w);
 
  if (width != 0) {
    if (_current_text_dir == TD_RTL) {
      wi_rect.left = wi_rect.right + 1 - ScaleGUITrad(width);
    } else {
      wi_rect.right = wi_rect.left + ScaleGUITrad(width) - 1;
    }
  }
 
  ShowDropDownListAt(w, std::move(list), selected, button, wi_rect, wi_colour, instant_close, persist);
}
void ShowDropDownList(Window *w, DropDownList &&list, int selected, WidgetID button, uint width, bool instant_close, bool persist) {…}
 
void ShowDropDownMenu(Window *w, std::span<const StringID> strings, int selected, WidgetID button, uint32_t disabled_mask, uint32_t hidden_mask, uint width)
{
  DropDownList list;
 
  uint i = 0;
  for (auto string : strings) {
    if (!HasBit(hidden_mask, i)) {
      list.push_back(MakeDropDownListStringItem(string, i, HasBit(disabled_mask, i)));
    }
    ++i;
  }
 
  if (!list.empty()) ShowDropDownList(w, std::move(list), selected, button, width);
}
void ShowDropDownMenu(Window *w, std::span<const StringID> strings, int selected, WidgetID button, uint32_t disabled_mask, uint32_t hidden_mask, uint width) {…}