GroveEngine/modules/UIModule/Core/UIContext.h
StillHammer 579cadeae8 feat: Complete UIModule Phase 7 - ScrollPanel & Tooltips
This commit implements Phase 7 of the UIModule, adding advanced features
that make the UI system production-ready.

## Phase 7.1 - UIScrollPanel

New scrollable container widget with:
- Vertical and horizontal scrolling (configurable)
- Mouse wheel support with smooth scrolling
- Drag-to-scroll functionality (drag content or scrollbar)
- Interactive scrollbar with proportional thumb
- Automatic content size calculation
- Visibility culling for performance
- Full styling support (colors, borders, scrollbar)

Files added:
- modules/UIModule/Widgets/UIScrollPanel.h
- modules/UIModule/Widgets/UIScrollPanel.cpp
- modules/UIModule/Core/UIContext.h (added mouseWheelDelta)
- modules/UIModule/UIModule.cpp (mouse wheel event routing)

## Phase 7.2 - Tooltips

Smart tooltip system with:
- Hover delay (500ms default)
- Automatic positioning with edge avoidance
- Semi-transparent background with border
- Per-widget tooltip text via JSON
- Tooltip property on all UIWidget types
- Renders on top of all UI elements

Files added:
- modules/UIModule/Core/UITooltip.h
- modules/UIModule/Core/UITooltip.cpp
- modules/UIModule/Core/UIWidget.h (added tooltip property)
- modules/UIModule/Core/UITree.cpp (tooltip parsing)

## Tests

Added comprehensive visual tests:
- test_28_ui_scroll.cpp - ScrollPanel with 35+ items
- test_29_ui_advanced.cpp - Tooltips on various widgets
- assets/ui/test_scroll.json - ScrollPanel layout
- assets/ui/test_tooltips.json - Tooltips layout

## Documentation

- docs/UI_MODULE_PHASE7_COMPLETE.md - Complete Phase 7 docs
- docs/PROMPT_UI_MODULE_PHASE6.md - Phase 6 & 7 prompt
- Updated CMakeLists.txt for new files and tests

## UIModule Status

UIModule is now feature-complete with:
 9 widget types (Panel, Label, Button, Image, Slider, Checkbox,
   ProgressBar, TextInput, ScrollPanel)
 Flexible layout system (vertical, horizontal, stack, absolute)
 Theme and style system
 Complete event system
 Tooltips with smart positioning
 Hot-reload support
 Comprehensive tests (Phases 1-7)

🚀 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-29 07:13:13 +08:00

119 lines
2.9 KiB
C++

#pragma once
#include <string>
#include <cstdint>
namespace grove {
/**
* @brief Global UI state for input handling and focus management
*
* Tracks mouse position, button states, keyboard focus, and
* provides hit-testing utilities for widgets.
*/
class UIContext {
public:
// Mouse state
float mouseX = 0.0f;
float mouseY = 0.0f;
bool mouseDown = false;
bool mousePressed = false; // Just pressed this frame
bool mouseReleased = false; // Just released this frame
// Keyboard state
bool keyPressed = false;
int keyCode = 0;
char keyChar = 0;
// Mouse wheel state
float mouseWheelDelta = 0.0f;
// Focus/hover tracking
std::string hoveredWidgetId;
std::string focusedWidgetId;
std::string activeWidgetId; // Currently being interacted with (e.g., dragging)
// Screen size for coordinate normalization
float screenWidth = 1280.0f;
float screenHeight = 720.0f;
/**
* @brief Reset per-frame state
* Call at the start of each frame before processing input
*/
void beginFrame() {
mousePressed = false;
mouseReleased = false;
keyPressed = false;
keyCode = 0;
keyChar = 0;
mouseWheelDelta = 0.0f;
hoveredWidgetId.clear();
}
/**
* @brief Check if a point is inside a rectangle
*/
static bool pointInRect(float px, float py, float rx, float ry, float rw, float rh) {
return px >= rx && px < rx + rw && py >= ry && py < ry + rh;
}
/**
* @brief Check if mouse is inside a rectangle
*/
bool isMouseInRect(float rx, float ry, float rw, float rh) const {
return pointInRect(mouseX, mouseY, rx, ry, rw, rh);
}
/**
* @brief Set hover state for a widget
*/
void setHovered(const std::string& widgetId) {
hoveredWidgetId = widgetId;
}
/**
* @brief Check if widget is hovered
*/
bool isHovered(const std::string& widgetId) const {
return hoveredWidgetId == widgetId;
}
/**
* @brief Check if widget is focused
*/
bool isFocused(const std::string& widgetId) const {
return focusedWidgetId == widgetId;
}
/**
* @brief Check if widget is active (being interacted with)
*/
bool isActive(const std::string& widgetId) const {
return activeWidgetId == widgetId;
}
/**
* @brief Set focus to a widget
*/
void setFocus(const std::string& widgetId) {
focusedWidgetId = widgetId;
}
/**
* @brief Set active widget
*/
void setActive(const std::string& widgetId) {
activeWidgetId = widgetId;
}
/**
* @brief Clear active widget
*/
void clearActive() {
activeWidgetId.clear();
}
};
} // namespace grove