215 lines
8.2 KiB
C
215 lines
8.2 KiB
C
// dvxWidgetPlugin.h -- Plugin API for DVX widget DXE modules
|
|
//
|
|
// Included by widget .c files to access core infrastructure.
|
|
// Provides: widget allocation, tree ops, class table, shared
|
|
// interaction state, scrollbar helpers, layout helpers, and
|
|
// common utility functions.
|
|
//
|
|
// Does NOT contain any per-widget prototypes. Each widget's
|
|
// internal functions (paint, onMouse, onKey, calcMinSize, etc.)
|
|
// are private to its own .c file and referenced only through
|
|
// the WidgetClassT vtable.
|
|
#ifndef DVX_WIDGET_PLUGIN_H
|
|
#define DVX_WIDGET_PLUGIN_H
|
|
|
|
#include "dvxWidget.h"
|
|
#include "dvxApp.h"
|
|
#include "dvxDraw.h"
|
|
#include "dvxWm.h"
|
|
#include "dvxVideo.h"
|
|
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
#include <stdio.h>
|
|
|
|
// ============================================================
|
|
// Widget class table
|
|
// ============================================================
|
|
|
|
// stb_ds dynamic array. Each widget DXE appends its class(es)
|
|
// via wgtRegisterClass() during wgtRegister().
|
|
extern const WidgetClassT **widgetClassTable;
|
|
|
|
// ============================================================
|
|
// Validation macros
|
|
// ============================================================
|
|
|
|
#define VALIDATE_WIDGET(w, wtype, retval) \
|
|
do { if (!(w) || (w)->type != (wtype)) { return (retval); } } while (0)
|
|
|
|
#define VALIDATE_WIDGET_VOID(w, wtype) \
|
|
do { if (!(w) || (w)->type != (wtype)) { return; } } while (0)
|
|
|
|
// ============================================================
|
|
// Cursor shape IDs (mirrors dvxCursor.h defines)
|
|
// ============================================================
|
|
|
|
#define CURSOR_ARROW 0
|
|
#define CURSOR_RESIZE_H 1
|
|
#define CURSOR_RESIZE_V 2
|
|
#define CURSOR_RESIZE_DIAG_NWSE 3
|
|
#define CURSOR_RESIZE_DIAG_NESW 4
|
|
#define CURSOR_BUSY 5
|
|
|
|
// ============================================================
|
|
// Keyboard modifier flags
|
|
// ============================================================
|
|
|
|
#define KEY_MOD_SHIFT 0x03
|
|
#define KEY_MOD_CTRL 0x04
|
|
#define KEY_MOD_ALT 0x08
|
|
|
|
// ============================================================
|
|
// Core layout constants
|
|
// ============================================================
|
|
|
|
#define DEFAULT_SPACING 4
|
|
#define DEFAULT_PADDING 4
|
|
#define SB_MIN_THUMB 14
|
|
#define WGT_SB_W 14
|
|
|
|
// ============================================================
|
|
// Inline helpers
|
|
// ============================================================
|
|
|
|
static inline int32_t clampInt(int32_t val, int32_t lo, int32_t hi) {
|
|
if (val < lo) { return lo; }
|
|
if (val > hi) { return hi; }
|
|
return val;
|
|
}
|
|
|
|
|
|
static inline void drawTextEmbossed(DisplayT *d, const BlitOpsT *ops, const BitmapFontT *font, int32_t x, int32_t y, const char *text, const ColorSchemeT *colors) {
|
|
drawText(d, ops, font, x + 1, y + 1, text, colors->windowHighlight, 0, false);
|
|
drawText(d, ops, font, x, y, text, colors->windowShadow, 0, false);
|
|
}
|
|
|
|
|
|
static inline void drawTextAccelEmbossed(DisplayT *d, const BlitOpsT *ops, const BitmapFontT *font, int32_t x, int32_t y, const char *text, const ColorSchemeT *colors) {
|
|
drawTextAccel(d, ops, font, x + 1, y + 1, text, colors->windowHighlight, 0, false);
|
|
drawTextAccel(d, ops, font, x, y, text, colors->windowShadow, 0, false);
|
|
}
|
|
|
|
// ============================================================
|
|
// Shared interaction state (defined in widgetCore.c)
|
|
// ============================================================
|
|
|
|
extern bool sCursorBlinkOn;
|
|
extern clock_t sDblClickTicks;
|
|
extern bool sDebugLayout;
|
|
extern WidgetT *sClosedPopup;
|
|
extern WidgetT *sFocusedWidget;
|
|
extern WidgetT *sKeyPressedBtn;
|
|
extern WidgetT *sOpenPopup;
|
|
extern WidgetT *sPressedButton;
|
|
extern WidgetT *sDragSlider;
|
|
extern WidgetT *sDrawingCanvas;
|
|
extern WidgetT *sDragTextSelect;
|
|
extern int32_t sDragOffset;
|
|
extern WidgetT *sResizeListView;
|
|
extern WidgetT *sDragSplitter;
|
|
extern int32_t sDragSplitStart;
|
|
extern WidgetT *sDragReorder;
|
|
extern WidgetT *sDragScrollbar;
|
|
extern int32_t sDragScrollbarOff;
|
|
extern int32_t sDragScrollbarOrient;
|
|
extern void (*sCursorBlinkFn)(void);
|
|
|
|
// ============================================================
|
|
// Core widget functions (widgetCore.c)
|
|
// ============================================================
|
|
|
|
// Tree manipulation
|
|
void widgetAddChild(WidgetT *parent, WidgetT *child);
|
|
void widgetRemoveChild(WidgetT *parent, WidgetT *child);
|
|
void widgetDestroyChildren(WidgetT *w);
|
|
|
|
// Allocation
|
|
WidgetT *widgetAlloc(WidgetT *parent, int32_t type);
|
|
|
|
// Focus management
|
|
void widgetClearFocus(WidgetT *root);
|
|
WidgetT *widgetFindNextFocusable(WidgetT *root, WidgetT *after);
|
|
WidgetT *widgetFindPrevFocusable(WidgetT *root, WidgetT *before);
|
|
WidgetT *widgetFindByAccel(WidgetT *root, char key);
|
|
|
|
// Utility queries
|
|
int32_t widgetCountVisibleChildren(const WidgetT *w);
|
|
int32_t widgetFrameBorderWidth(const WidgetT *w);
|
|
bool widgetIsFocusable(int32_t type);
|
|
bool widgetIsBoxContainer(int32_t type);
|
|
bool widgetIsHorizContainer(int32_t type);
|
|
int32_t multiClickDetect(int32_t vx, int32_t vy);
|
|
|
|
// Clipboard
|
|
void clipboardCopy(const char *text, int32_t len);
|
|
const char *clipboardGet(int32_t *outLen);
|
|
int32_t clipboardMaxLen(void);
|
|
|
|
// Hit testing
|
|
WidgetT *widgetHitTest(WidgetT *w, int32_t x, int32_t y);
|
|
|
|
// Scrollbar helpers
|
|
void widgetScrollbarThumb(int32_t trackLen, int32_t totalSize, int32_t visibleSize, int32_t scrollPos, int32_t *thumbPos, int32_t *thumbSize);
|
|
|
|
// ============================================================
|
|
// Scrollbar drawing and hit testing (widgetScrollbar.c)
|
|
// ============================================================
|
|
|
|
typedef enum {
|
|
ScrollHitNoneE,
|
|
ScrollHitArrowDecE,
|
|
ScrollHitArrowIncE,
|
|
ScrollHitPageDecE,
|
|
ScrollHitPageIncE,
|
|
ScrollHitThumbE
|
|
} ScrollHitE;
|
|
|
|
void widgetDrawScrollbarH(DisplayT *d, const BlitOpsT *ops, const ColorSchemeT *colors, int32_t sbX, int32_t sbY, int32_t sbW, int32_t totalSize, int32_t visibleSize, int32_t scrollPos);
|
|
void widgetDrawScrollbarV(DisplayT *d, const BlitOpsT *ops, const ColorSchemeT *colors, int32_t sbX, int32_t sbY, int32_t sbH, int32_t totalSize, int32_t visibleSize, int32_t scrollPos);
|
|
void widgetScrollbarDragUpdate(WidgetT *w, int32_t orient, int32_t dragOff, int32_t mouseX, int32_t mouseY);
|
|
ScrollHitE widgetScrollbarHitTest(int32_t sbLen, int32_t relPos, int32_t totalSize, int32_t visibleSize, int32_t scrollPos);
|
|
|
|
// ============================================================
|
|
// Layout functions (widgetLayout.c)
|
|
// ============================================================
|
|
|
|
void widgetCalcMinSizeBox(WidgetT *w, const BitmapFontT *font);
|
|
void widgetCalcMinSizeTree(WidgetT *w, const BitmapFontT *font);
|
|
void widgetLayoutBox(WidgetT *w, const BitmapFontT *font);
|
|
void widgetLayoutChildren(WidgetT *w, const BitmapFontT *font);
|
|
|
|
// ============================================================
|
|
// Event dispatch (widgetEvent.c)
|
|
// ============================================================
|
|
|
|
void widgetManageScrollbars(WindowT *win, AppContextT *ctx);
|
|
void widgetOnKey(WindowT *win, int32_t key, int32_t mod);
|
|
void widgetOnMouse(WindowT *win, int32_t x, int32_t y, int32_t buttons);
|
|
void widgetOnPaint(WindowT *win, RectT *dirtyArea);
|
|
void widgetOnResize(WindowT *win, int32_t newW, int32_t newH);
|
|
void widgetOnScroll(WindowT *win, ScrollbarOrientE orient, int32_t value);
|
|
|
|
// ============================================================
|
|
// Paint helpers (widgetOps.c)
|
|
// ============================================================
|
|
|
|
void widgetPaintOne(WidgetT *w, DisplayT *d, const BlitOpsT *ops, const BitmapFontT *font, const ColorSchemeT *colors);
|
|
void widgetPaintOverlays(WidgetT *root, DisplayT *d, const BlitOpsT *ops, const BitmapFontT *font, const ColorSchemeT *colors);
|
|
|
|
// Shared helper libraries:
|
|
// texthelp/textHelp.h -- clipboard, text editing, word boundaries
|
|
// listhelp/listHelp.h -- dropdown arrow, popup list, keyboard nav
|
|
// Widget DXEs that use these include the headers directly.
|
|
|
|
// widgetTextDragUpdate stays in core (widgetCore.c)
|
|
void widgetTextDragUpdate(WidgetT *w, WidgetT *root, int32_t vx, int32_t vy);
|
|
|
|
// ============================================================
|
|
// Drag-reorder helpers (widgetEvent.c)
|
|
// ============================================================
|
|
|
|
void widgetReorderUpdate(WidgetT *w, WidgetT *root, int32_t x, int32_t y);
|
|
void widgetReorderDrop(WidgetT *w);
|
|
|
|
#endif // DVX_WIDGET_PLUGIN_H
|