2023-01-05 13:25:55 +01:00
|
|
|
/**************************************************************************/
|
|
|
|
/* tab_container.h */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
|
|
|
/* https://godotengine.org */
|
|
|
|
/**************************************************************************/
|
|
|
|
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
|
|
|
|
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* */
|
|
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
|
|
/* a copy of this software and associated documentation files (the */
|
|
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
|
|
/* the following conditions: */
|
|
|
|
/* */
|
|
|
|
/* The above copyright notice and this permission notice shall be */
|
|
|
|
/* included in all copies or substantial portions of the Software. */
|
|
|
|
/* */
|
|
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
|
|
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
|
|
/**************************************************************************/
|
2018-01-05 00:50:27 +01:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
#ifndef TAB_CONTAINER_H
|
|
|
|
#define TAB_CONTAINER_H
|
|
|
|
|
2018-06-11 00:10:32 +02:00
|
|
|
#include "scene/gui/container.h"
|
2015-06-14 03:12:53 +02:00
|
|
|
#include "scene/gui/popup.h"
|
2022-03-02 15:37:10 +01:00
|
|
|
#include "scene/gui/tab_bar.h"
|
2020-09-03 13:22:16 +02:00
|
|
|
|
2018-06-11 00:10:32 +02:00
|
|
|
class TabContainer : public Container {
|
|
|
|
GDCLASS(TabContainer, Container);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2023-09-27 23:23:22 +02:00
|
|
|
public:
|
|
|
|
enum TabPosition {
|
|
|
|
POSITION_TOP,
|
|
|
|
POSITION_BOTTOM,
|
|
|
|
POSITION_MAX,
|
|
|
|
};
|
|
|
|
|
|
|
|
private:
|
2022-04-04 15:06:57 +02:00
|
|
|
TabBar *tab_bar = nullptr;
|
2021-02-09 18:24:36 +01:00
|
|
|
bool tabs_visible = true;
|
|
|
|
bool all_tabs_in_front = false;
|
2023-09-27 23:23:22 +02:00
|
|
|
TabPosition tabs_position = POSITION_TOP;
|
2021-02-09 18:24:36 +01:00
|
|
|
bool menu_hovered = false;
|
2020-06-24 19:14:20 +02:00
|
|
|
mutable ObjectID popup_obj_id;
|
2021-02-09 18:24:36 +01:00
|
|
|
bool use_hidden_tabs_for_min_size = false;
|
2022-03-02 15:37:10 +01:00
|
|
|
bool theme_changing = false;
|
2022-10-27 06:22:06 +02:00
|
|
|
Vector<Control *> children_removing;
|
2023-10-25 22:15:56 +02:00
|
|
|
bool drag_to_rearrange_enabled = false;
|
2024-01-15 00:39:47 +01:00
|
|
|
// Set the default setup current tab to be an invalid index.
|
|
|
|
int setup_current_tab = -2;
|
|
|
|
bool updating_visibility = false;
|
2015-06-14 03:12:53 +02:00
|
|
|
|
2022-08-31 14:02:40 +02:00
|
|
|
struct ThemeCache {
|
|
|
|
int side_margin = 0;
|
|
|
|
|
|
|
|
Ref<StyleBox> panel_style;
|
|
|
|
Ref<StyleBox> tabbar_style;
|
|
|
|
|
|
|
|
Ref<Texture2D> menu_icon;
|
|
|
|
Ref<Texture2D> menu_hl_icon;
|
|
|
|
|
|
|
|
// TabBar overrides.
|
|
|
|
int icon_separation = 0;
|
2023-03-31 21:17:59 +02:00
|
|
|
int icon_max_width = 0;
|
2022-08-31 14:02:40 +02:00
|
|
|
int outline_size = 0;
|
|
|
|
|
|
|
|
Ref<StyleBox> tab_unselected_style;
|
2023-03-09 03:52:57 +01:00
|
|
|
Ref<StyleBox> tab_hovered_style;
|
2022-08-31 14:02:40 +02:00
|
|
|
Ref<StyleBox> tab_selected_style;
|
|
|
|
Ref<StyleBox> tab_disabled_style;
|
2023-06-25 17:56:52 +02:00
|
|
|
Ref<StyleBox> tab_focus_style;
|
2022-08-31 14:02:40 +02:00
|
|
|
|
|
|
|
Ref<Texture2D> increment_icon;
|
|
|
|
Ref<Texture2D> increment_hl_icon;
|
|
|
|
Ref<Texture2D> decrement_icon;
|
|
|
|
Ref<Texture2D> decrement_hl_icon;
|
|
|
|
Ref<Texture2D> drop_mark_icon;
|
|
|
|
Color drop_mark_color;
|
|
|
|
|
|
|
|
Color font_selected_color;
|
2023-08-27 14:28:24 +02:00
|
|
|
Color font_hovered_color;
|
2022-08-31 14:02:40 +02:00
|
|
|
Color font_unselected_color;
|
|
|
|
Color font_disabled_color;
|
|
|
|
Color font_outline_color;
|
|
|
|
|
|
|
|
Ref<Font> tab_font;
|
|
|
|
int tab_font_size;
|
|
|
|
} theme_cache;
|
|
|
|
|
2023-09-27 23:23:22 +02:00
|
|
|
int _get_tab_height() const;
|
2022-03-02 15:37:10 +01:00
|
|
|
Vector<Control *> _get_tab_controls() const;
|
2017-12-11 12:46:33 +01:00
|
|
|
void _on_theme_changed();
|
2020-06-14 00:15:47 +02:00
|
|
|
void _repaint();
|
2024-04-09 07:02:05 +02:00
|
|
|
void _refresh_tab_indices();
|
2022-03-04 16:09:02 +01:00
|
|
|
void _refresh_tab_names();
|
2022-03-02 15:37:10 +01:00
|
|
|
void _update_margins();
|
2019-09-23 04:07:00 +02:00
|
|
|
void _on_mouse_exited();
|
2022-03-02 15:37:10 +01:00
|
|
|
void _on_tab_changed(int p_tab);
|
2023-04-23 17:50:35 +02:00
|
|
|
void _on_tab_clicked(int p_tab);
|
|
|
|
void _on_tab_hovered(int p_tab);
|
2022-03-02 15:37:10 +01:00
|
|
|
void _on_tab_selected(int p_tab);
|
2022-03-17 00:24:47 +01:00
|
|
|
void _on_tab_button_pressed(int p_tab);
|
2023-10-19 04:12:50 +02:00
|
|
|
void _on_active_tab_rearranged(int p_tab);
|
2024-01-15 00:39:47 +01:00
|
|
|
void _on_tab_visibility_changed(Control *p_child);
|
2022-03-02 15:37:10 +01:00
|
|
|
|
|
|
|
Variant _get_drag_data_fw(const Point2 &p_point, Control *p_from_control);
|
|
|
|
bool _can_drop_data_fw(const Point2 &p_point, const Variant &p_data, Control *p_from_control) const;
|
|
|
|
void _drop_data_fw(const Point2 &p_point, const Variant &p_data, Control *p_from_control);
|
2023-10-19 04:12:50 +02:00
|
|
|
void _drag_move_tab(int p_from_index, int p_to_index);
|
|
|
|
void _drag_move_tab_from(TabBar *p_from_tabbar, int p_from_index, int p_to_index);
|
2014-02-10 02:10:30 +01:00
|
|
|
|
|
|
|
protected:
|
2021-08-22 17:37:22 +02:00
|
|
|
virtual void gui_input(const Ref<InputEvent> &p_event) override;
|
2022-08-31 14:02:40 +02:00
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
void _notification(int p_what);
|
2020-07-10 12:34:39 +02:00
|
|
|
virtual void add_child_notify(Node *p_child) override;
|
2020-12-12 17:41:51 +01:00
|
|
|
virtual void move_child_notify(Node *p_child) override;
|
2020-07-10 12:34:39 +02:00
|
|
|
virtual void remove_child_notify(Node *p_child) override;
|
2022-03-02 15:37:10 +01:00
|
|
|
static void _bind_methods();
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2022-03-02 15:37:10 +01:00
|
|
|
public:
|
2023-08-03 20:53:49 +02:00
|
|
|
TabBar *get_tab_bar() const;
|
|
|
|
|
2018-02-07 14:01:45 +01:00
|
|
|
int get_tab_idx_at_point(const Point2 &p_point) const;
|
2022-03-02 15:37:10 +01:00
|
|
|
int get_tab_idx_from_control(Control *p_child) const;
|
2018-02-07 14:01:45 +01:00
|
|
|
|
2022-03-02 15:37:10 +01:00
|
|
|
void set_tab_alignment(TabBar::AlignmentMode p_alignment);
|
|
|
|
TabBar::AlignmentMode get_tab_alignment() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2023-09-27 23:23:22 +02:00
|
|
|
void set_tabs_position(TabPosition p_tab_position);
|
|
|
|
TabPosition get_tabs_position() const;
|
|
|
|
|
2023-06-25 17:56:52 +02:00
|
|
|
void set_tab_focus_mode(FocusMode p_focus_mode);
|
|
|
|
FocusMode get_tab_focus_mode() const;
|
|
|
|
|
2022-03-02 15:37:10 +01:00
|
|
|
void set_clip_tabs(bool p_clip_tabs);
|
|
|
|
bool get_clip_tabs() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2020-01-25 01:34:47 +01:00
|
|
|
void set_tabs_visible(bool p_visible);
|
2014-02-10 02:10:30 +01:00
|
|
|
bool are_tabs_visible() const;
|
|
|
|
|
2020-12-05 19:12:24 +01:00
|
|
|
void set_all_tabs_in_front(bool p_is_front);
|
|
|
|
bool is_all_tabs_in_front() const;
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
void set_tab_title(int p_tab, const String &p_title);
|
2014-02-10 02:10:30 +01:00
|
|
|
String get_tab_title(int p_tab) const;
|
|
|
|
|
2019-06-11 20:43:37 +02:00
|
|
|
void set_tab_icon(int p_tab, const Ref<Texture2D> &p_icon);
|
|
|
|
Ref<Texture2D> get_tab_icon(int p_tab) const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2017-02-27 19:07:50 +01:00
|
|
|
void set_tab_disabled(int p_tab, bool p_disabled);
|
2022-03-02 15:37:10 +01:00
|
|
|
bool is_tab_disabled(int p_tab) const;
|
2017-02-27 19:07:50 +01:00
|
|
|
|
2019-04-09 00:18:03 +02:00
|
|
|
void set_tab_hidden(int p_tab, bool p_hidden);
|
2022-03-02 15:37:10 +01:00
|
|
|
bool is_tab_hidden(int p_tab) const;
|
2019-04-09 00:18:03 +02:00
|
|
|
|
2023-04-11 18:48:47 +02:00
|
|
|
void set_tab_metadata(int p_tab, const Variant &p_metadata);
|
|
|
|
Variant get_tab_metadata(int p_tab) const;
|
|
|
|
|
2022-03-17 00:24:47 +01:00
|
|
|
void set_tab_button_icon(int p_tab, const Ref<Texture2D> &p_icon);
|
|
|
|
Ref<Texture2D> get_tab_button_icon(int p_tab) const;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
int get_tab_count() const;
|
|
|
|
void set_current_tab(int p_current);
|
|
|
|
int get_current_tab() const;
|
2017-03-01 18:23:19 +01:00
|
|
|
int get_previous_tab() const;
|
2014-02-10 02:10:30 +01:00
|
|
|
|
2023-06-25 17:56:52 +02:00
|
|
|
bool select_previous_available();
|
|
|
|
bool select_next_available();
|
|
|
|
|
2024-01-15 00:39:47 +01:00
|
|
|
void set_deselect_enabled(bool p_enabled);
|
|
|
|
bool get_deselect_enabled() const;
|
|
|
|
|
2017-03-05 16:44:50 +01:00
|
|
|
Control *get_tab_control(int p_idx) const;
|
|
|
|
Control *get_current_tab_control() const;
|
2015-06-14 03:12:53 +02:00
|
|
|
|
2020-07-10 12:34:39 +02:00
|
|
|
virtual Size2 get_minimum_size() const override;
|
2015-01-03 02:34:22 +01:00
|
|
|
|
2015-06-14 03:12:53 +02:00
|
|
|
void set_popup(Node *p_popup);
|
2017-03-05 16:44:50 +01:00
|
|
|
Popup *get_popup() const;
|
2015-06-14 03:12:53 +02:00
|
|
|
|
2023-10-19 04:12:50 +02:00
|
|
|
void move_tab_from_tab_container(TabContainer *p_from, int p_from_index, int p_to_index = -1);
|
|
|
|
|
2018-02-07 14:01:45 +01:00
|
|
|
void set_drag_to_rearrange_enabled(bool p_enabled);
|
|
|
|
bool get_drag_to_rearrange_enabled() const;
|
|
|
|
void set_tabs_rearrange_group(int p_group_id);
|
|
|
|
int get_tabs_rearrange_group() const;
|
2019-01-26 19:41:36 +01:00
|
|
|
void set_use_hidden_tabs_for_min_size(bool p_use_hidden_tabs);
|
|
|
|
bool get_use_hidden_tabs_for_min_size() const;
|
2018-02-07 14:01:45 +01:00
|
|
|
|
2021-11-08 21:53:41 +01:00
|
|
|
virtual Vector<int> get_allowed_size_flags_horizontal() const override;
|
|
|
|
virtual Vector<int> get_allowed_size_flags_vertical() const override;
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
TabContainer();
|
|
|
|
};
|
|
|
|
|
2023-09-27 23:23:22 +02:00
|
|
|
VARIANT_ENUM_CAST(TabContainer::TabPosition);
|
|
|
|
|
2014-02-10 02:10:30 +01:00
|
|
|
#endif // TAB_CONTAINER_H
|