2014-02-10 01:10:30 +00:00
|
|
|
/*************************************************************************/
|
|
|
|
/* scroll_container.h */
|
|
|
|
/*************************************************************************/
|
|
|
|
/* This file is part of: */
|
|
|
|
/* GODOT ENGINE */
|
2017-08-27 12:16:55 +00:00
|
|
|
/* https://godotengine.org */
|
2014-02-10 01:10:30 +00:00
|
|
|
/*************************************************************************/
|
2022-01-03 20:27:34 +00:00
|
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
2014-02-10 01:10:30 +00:00
|
|
|
/* */
|
|
|
|
/* 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-04 23:50:27 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
#ifndef SCROLL_CONTAINER_H
|
|
|
|
#define SCROLL_CONTAINER_H
|
|
|
|
|
|
|
|
#include "container.h"
|
|
|
|
|
|
|
|
#include "scroll_bar.h"
|
|
|
|
|
|
|
|
class ScrollContainer : public Container {
|
2017-01-03 02:03:46 +00:00
|
|
|
GDCLASS(ScrollContainer, Container);
|
2014-02-10 01:10:30 +00:00
|
|
|
|
2021-12-07 16:15:18 +00:00
|
|
|
public:
|
|
|
|
enum ScrollMode {
|
|
|
|
SCROLL_MODE_DISABLED = 0,
|
|
|
|
SCROLL_MODE_AUTO,
|
|
|
|
SCROLL_MODE_SHOW_ALWAYS,
|
|
|
|
SCROLL_MODE_SHOW_NEVER,
|
|
|
|
};
|
|
|
|
|
|
|
|
private:
|
2022-04-04 13:06:57 +00:00
|
|
|
HScrollBar *h_scroll = nullptr;
|
|
|
|
VScrollBar *v_scroll = nullptr;
|
2014-02-10 01:10:30 +00:00
|
|
|
|
|
|
|
Size2 child_max_size;
|
|
|
|
|
|
|
|
void update_scrollbars();
|
|
|
|
|
|
|
|
Vector2 drag_speed;
|
|
|
|
Vector2 drag_accum;
|
|
|
|
Vector2 drag_from;
|
|
|
|
Vector2 last_drag_accum;
|
2021-04-18 20:38:44 +00:00
|
|
|
float time_since_motion = 0.0f;
|
2021-02-09 17:24:36 +00:00
|
|
|
bool drag_touching = false;
|
|
|
|
bool drag_touching_deaccel = false;
|
|
|
|
bool beyond_deadzone = false;
|
|
|
|
|
2021-12-07 16:15:18 +00:00
|
|
|
ScrollMode horizontal_scroll_mode = SCROLL_MODE_AUTO;
|
|
|
|
ScrollMode vertical_scroll_mode = SCROLL_MODE_AUTO;
|
2021-04-18 20:38:44 +00:00
|
|
|
|
2021-02-09 17:24:36 +00:00
|
|
|
int deadzone = 0;
|
|
|
|
bool follow_focus = false;
|
2018-02-27 15:37:20 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
void _cancel_drag();
|
|
|
|
|
|
|
|
protected:
|
2020-07-10 10:34:39 +00:00
|
|
|
Size2 get_minimum_size() const override;
|
2014-02-10 01:10:30 +00:00
|
|
|
|
2021-05-15 03:19:23 +00:00
|
|
|
void _gui_focus_changed(Control *p_control);
|
2020-12-29 02:51:38 +00:00
|
|
|
void _update_dimensions();
|
2014-02-10 01:10:30 +00:00
|
|
|
void _notification(int p_what);
|
|
|
|
|
|
|
|
void _scroll_moved(float);
|
|
|
|
static void _bind_methods();
|
|
|
|
|
2020-09-03 11:22:16 +00:00
|
|
|
bool _updating_scrollbars = false;
|
2020-01-16 03:36:31 +00:00
|
|
|
void _update_scrollbar_position();
|
2014-02-10 01:10:30 +00:00
|
|
|
|
2017-03-05 15:44:50 +00:00
|
|
|
public:
|
2021-12-02 14:57:53 +00:00
|
|
|
virtual void gui_input(const Ref<InputEvent> &p_gui_input) override;
|
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
void set_h_scroll(int p_pos);
|
2021-04-18 20:38:44 +00:00
|
|
|
int get_h_scroll() const;
|
|
|
|
|
|
|
|
void set_v_scroll(int p_pos);
|
|
|
|
int get_v_scroll() const;
|
2014-02-10 01:10:30 +00:00
|
|
|
|
2021-12-07 16:15:18 +00:00
|
|
|
void set_horizontal_scroll_mode(ScrollMode p_mode);
|
|
|
|
ScrollMode get_horizontal_scroll_mode() const;
|
2014-02-10 01:10:30 +00:00
|
|
|
|
2021-12-07 16:15:18 +00:00
|
|
|
void set_vertical_scroll_mode(ScrollMode p_mode);
|
|
|
|
ScrollMode get_vertical_scroll_mode() const;
|
2021-04-18 20:38:44 +00:00
|
|
|
|
2018-02-27 15:37:20 +00:00
|
|
|
int get_deadzone() const;
|
|
|
|
void set_deadzone(int p_deadzone);
|
|
|
|
|
2019-12-23 23:03:24 +00:00
|
|
|
bool is_following_focus() const;
|
2019-12-30 22:42:39 +00:00
|
|
|
void set_follow_focus(bool p_follow);
|
2019-12-23 23:03:24 +00:00
|
|
|
|
2021-11-30 16:46:36 +00:00
|
|
|
HScrollBar *get_h_scroll_bar();
|
|
|
|
VScrollBar *get_v_scroll_bar();
|
2021-05-15 03:19:23 +00:00
|
|
|
void ensure_control_visible(Control *p_control);
|
2018-06-07 15:46:14 +00:00
|
|
|
|
2020-10-29 10:01:28 +00:00
|
|
|
TypedArray<String> get_configuration_warnings() const override;
|
2017-01-09 18:50:08 +00:00
|
|
|
|
2014-02-10 01:10:30 +00:00
|
|
|
ScrollContainer();
|
|
|
|
};
|
|
|
|
|
2021-12-07 16:15:18 +00:00
|
|
|
VARIANT_ENUM_CAST(ScrollContainer::ScrollMode);
|
|
|
|
|
2022-07-23 21:41:51 +00:00
|
|
|
#endif // SCROLL_CONTAINER_H
|