mirror of
https://gitea.wildfiregames.com/0ad/0ad
synced 2026-06-17 22:03:56 -07:00
8c250568e7
This PR introduces a new ScrollPanel component with the following capabilities: - Scroll Orientation Support: Allows scrolling in horizontal, vertical, or both directions, providing flexibility for different use cases. - Partial Object Rendering: Supports partial rendering of objects that are only partially visible within the scroll boundaries, improving visual accuracy and performance. - Boundary-Constrained Mouse Interaction: Handles mouse events strictly within the panel's visible boundaries, preventing interaction with objects outside the scrollable area. - Minimum Internal Size (min_width, min_height): Introduces support for virtual space management, allowing the panel to maintain a minimum internal size independent of its actual on-screen dimensions. Even when the panel is resized, this ensures that the content respects a defined virtual space (with min_width and min_height), effectively simulating a larger internal canvas. This is particularly useful for large content or scenarios where a more extensive scrollable area is required than the current visible panel.
103 lines
2.9 KiB
C
103 lines
2.9 KiB
C
/* Copyright (C) 2024 Wildfire Games.
|
|
* This file is part of 0 A.D.
|
|
*
|
|
* 0 A.D. 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, either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* 0 A.D. 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 0 A.D. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef INCLUDED_SGUIMESSAGE
|
|
#define INCLUDED_SGUIMESSAGE
|
|
|
|
#include "ps/CStr.h"
|
|
|
|
/**
|
|
* Message types.
|
|
* @see SGUIMessage
|
|
*/
|
|
enum EGUIMessageType
|
|
{
|
|
GUIM_MOUSE_OVER,
|
|
GUIM_MOUSE_ENTER,
|
|
GUIM_MOUSE_LEAVE,
|
|
GUIM_MOUSE_PRESS_LEFT,
|
|
GUIM_MOUSE_PRESS_LEFT_ITEM,
|
|
GUIM_MOUSE_PRESS_RIGHT,
|
|
GUIM_MOUSE_DOWN_LEFT,
|
|
GUIM_MOUSE_DOWN_RIGHT,
|
|
GUIM_MOUSE_DBLCLICK_LEFT,
|
|
GUIM_MOUSE_DBLCLICK_LEFT_ITEM, // Triggered when doubleclicking on a list item.
|
|
GUIM_MOUSE_DBLCLICK_RIGHT,
|
|
GUIM_MOUSE_RELEASE_LEFT,
|
|
GUIM_MOUSE_RELEASE_RIGHT,
|
|
GUIM_MOUSE_WHEEL_UP,
|
|
GUIM_MOUSE_WHEEL_DOWN,
|
|
GUIM_MOUSE_WHEEL_LEFT,
|
|
GUIM_MOUSE_WHEEL_RIGHT,
|
|
GUIM_SETTINGS_UPDATED, // SGUIMessage.m_Value = name of setting.
|
|
GUIM_PRESSED,
|
|
GUIM_KEYDOWN,
|
|
GUIM_RELEASED,
|
|
GUIM_DOUBLE_PRESSED,
|
|
GUIM_MOUSE_MOTION,
|
|
GUIM_LOAD, // Called after all objects were added to the GUI.
|
|
GUIM_GOT_FOCUS,
|
|
GUIM_LOST_FOCUS,
|
|
GUIM_PRESSED_MOUSE_RIGHT,
|
|
GUIM_PRESSED_MOUSE_RIGHT_DISABLED,
|
|
GUIM_DOUBLE_PRESSED_MOUSE_RIGHT,
|
|
GUIM_PRESSED_MOUSE_RELEASE,
|
|
GUIM_PRESSED_MOUSE_RELEASE_RIGHT,
|
|
GUIM_TAB, // Used by CInput.
|
|
GUIM_TEXTEDIT,
|
|
GUIM_CHILD_RESIZED, // SGUIMessage.m_Value = name of the object that changed size, used for inform to parent.
|
|
GUIM_CHILD_TOGGLE_VISIBILITY, // SGUIMessage.m_Value = name of the object that changed visibility used for inform to parent.
|
|
};
|
|
|
|
/**
|
|
* Message send to IGUIObject::HandleMessage() in order
|
|
* to give life to Objects manually with
|
|
* a derived HandleMessage().
|
|
*/
|
|
struct SGUIMessage
|
|
{
|
|
// This should be passed as a const reference or pointer.
|
|
NONCOPYABLE(SGUIMessage);
|
|
|
|
SGUIMessage(EGUIMessageType _type) : type(_type), skipped(false) {}
|
|
SGUIMessage(EGUIMessageType _type, const CStr& _value) : type(_type), value(_value), skipped(false) {}
|
|
|
|
/**
|
|
* This method can be used to allow other event handlers to process this GUI event,
|
|
* by default an event is not skipped (only the first handler will process it).
|
|
*
|
|
* @param skip true to allow further event handling, false to prevent it
|
|
*/
|
|
void Skip(bool skip = true) { skipped = skip; }
|
|
|
|
/**
|
|
* Describes what the message regards
|
|
*/
|
|
EGUIMessageType type;
|
|
|
|
/**
|
|
* Optional data
|
|
*/
|
|
CStr value;
|
|
|
|
/**
|
|
* Flag that specifies if object skipped handling the event
|
|
*/
|
|
bool skipped;
|
|
};
|
|
|
|
#endif // INCLUDED_SGUIMESSAGE
|