api/_u_i_text_input_8h_source.html

#pragma once

#include "../Core/Core.h"

#include "../Input/KeyCode.h"

#include "UIRendererComponent.h"

#include <SDL3/SDL_rect.h>

#include <string>

#include <cstdint>


struct TTF_Font;


namespace Shit {


    class SHIT_API SHIT_REFLECT(BlackList) UITextInput : public UIRendererComponent {

        SHIT_REFLECT_BODY(UITextInput)

    public:

        UITextInput() = default;

        ~UITextInput() override;


        // --- 文本内容 ---

        const std::string& getText() const { return m_text; }

        virtual void setText(const std::string& text);


        // --- 占位符 ---

        const std::string& getPlaceholder() const { return m_placeholder; }

        void setPlaceholder(const std::string& placeholder) { m_placeholder = placeholder; }


        // --- 字体（与 UIText 接口一致，按 path+size 缓存）---

        const std::string& getFontPath() const { return m_fontPath; }

        void setFontPath(const std::string& fontPath) { m_fontPath = fontPath; m_isDirty = true; }


        float getFontSize() const { return m_fontSize; }

        void setFontSize(float fontSize) { m_fontSize = fontSize; m_isDirty = true; }


        float getFontHeight() const { return m_fontHeight; }


        const Color& getTextColor() const { return m_textColor; }

        void setTextColor(const Color& color) { m_textColor = color; m_isDirty = true; }


        const Color& getPlaceholderColor() const { return m_placeholderColor; }

        void setPlaceholderColor(const Color& color) { m_placeholderColor = color; }


        const Color& getCursorColor() const { return m_cursorColor; }

        void setCursorColor(const Color& color) { m_cursorColor = color; }


        const Color& getSelectionColor() const { return m_selectionColor; }

        void setSelectionColor(const Color& color) { m_selectionColor = color; }


        // --- 状态查询 ---

        bool isFocused() const { return m_isFocused; }

        bool isMultiline() const { return m_isMultiline; }


        // --- 由 TextInputGate 转发的 SDL 文本事件 ---

        void onTextInput(const char* utf8Text);

        void onTextEditing(const char* utf8Text, int start, int length);


        void setFocused(bool focused);


    protected:

        // 子类覆写：把当前"已提交文本 + 光标布局"画到给定矩形内

        void onRender(const SDL_FRect& screenRect) override = 0;


        virtual bool onKeyDown(KeyCode key, bool shift, bool ctrl);


        virtual void insertText(const std::string& utf8);


        virtual void insertNewline();


        size_t getCharacterCount() const;


        void markDirty() { m_isDirty = true; }


        TTF_Font* acquireFont();


        SHIT_META(Disable)

        bool m_isFocused = false;

        SHIT_META(Disable)

        bool m_isMultiline = false;

        SHIT_META(({.displayName = "Text", .tooltip = "文本内容"}))

        std::string m_text;

        SHIT_META(({.displayName = "Placeholder", .tooltip = "占位符文字"}))

        std::string m_placeholder;

        SHIT_META(({.displayName = "Font Path", .tooltip = "字体文件路径"}))

        std::string m_fontPath;

        SHIT_META(({.displayName = "Font Size", .tooltip = "字号", .range = {1, 300}}))

        float m_fontSize = 24.0f;

        SHIT_META(Disable)

        float m_fontHeight = 0.0f;

        SHIT_META(({.displayName = "Text Color", .tooltip = "文字颜色"}))

        Color m_textColor      { 30, 30, 30, 255 };

        SHIT_META(({.displayName = "Placeholder Color", .tooltip = "占位符颜色"}))

        Color m_placeholderColor { 140, 140, 140, 255 };

        SHIT_META(({.displayName = "Cursor Color", .tooltip = "光标颜色"}))

        Color m_cursorColor { 80, 140, 220, 255 };

        SHIT_META(({.displayName = "Selection Color", .tooltip = "选区颜色"}))

        Color m_selectionColor { 80, 140, 220, 120 };

        SHIT_META(Disable)

        bool m_isDirty = true;


        // 光标 / 选区（单位：UTF-8 字节偏移）

        SHIT_META(Disable)

        size_t m_cursor = 0;

        SHIT_META(Disable)

        size_t m_selectionAnchor = 0;


        // IME 组合（preedit）

        SHIT_META(Disable)

        std::string m_preedit;

        SHIT_META(Disable)

        int m_preeditStart = 0;

        SHIT_META(Disable)

        int m_preeditLength = 0;


        // SDL 文本事件编辑辅助

        void deleteSelection();

        void moveCursor(int deltaChars, bool selecting);

        void moveCursorToBoundary(bool toStart, bool selecting);

        void clampCursor();


        // 内部 UTF-8 工具（供子类渲染使用）

        static size_t charToByte(const std::string& s, size_t charIdx);

        static size_t byteToChar(const std::string& s, size_t byteOff);


    private:

        friend class TextInputGate;

        void onDetach() override;

        void onDestroy() override;

    };


}

Core.h

SHIT_API
#define SHIT_API
定义 Core.h:14

KeyCode.h

SHIT_REFLECT_BODY
#define SHIT_REFLECT_BODY(Type)
定义 Macros.h:62

SHIT_REFLECT
#define SHIT_REFLECT(Mode)
定义 Macros.h:59

SHIT_META
#define SHIT_META(...)
定义 Macros.h:68

UIRendererComponent.h

Shit::UIRendererComponent::UIRendererComponent
UIRendererComponent()

Shit::UITextInput::getFontSize
float getFontSize() const
定义 UITextInput.h:43

Shit::UITextInput::m_fontHeight
float m_fontHeight
定义 UITextInput.h:107

Shit::UITextInput::getCursorColor
const Color & getCursorColor() const
定义 UITextInput.h:54

Shit::UITextInput::m_textColor
Color m_textColor
定义 UITextInput.h:109

Shit::UITextInput::isMultiline
bool isMultiline() const
定义 UITextInput.h:62

Shit::UITextInput::m_isMultiline
bool m_isMultiline
定义 UITextInput.h:97

Shit::UITextInput::getTextColor
const Color & getTextColor() const
定义 UITextInput.h:48

Shit::UITextInput::m_cursorColor
Color m_cursorColor
定义 UITextInput.h:113

Shit::UITextInput::getText
const std::string & getText() const
定义 UITextInput.h:32

Shit::UITextInput::setTextColor
void setTextColor(const Color &color)
定义 UITextInput.h:49

Shit::UITextInput::onKeyDown
virtual bool onKeyDown(KeyCode key, bool shift, bool ctrl)
子类可覆写：处理键盘控制键（方向键、退格、删除、Home/End、回车）

Shit::UITextInput::onTextEditing
void onTextEditing(const char *utf8Text, int start, int length)

Shit::UITextInput::markDirty
void markDirty()
标记脏位（下一帧重建纹理/布局）
定义 UITextInput.h:89

Shit::UITextInput::UITextInput
UITextInput()=default

Shit::UITextInput::isFocused
bool isFocused() const
定义 UITextInput.h:61

Shit::UITextInput::setPlaceholderColor
void setPlaceholderColor(const Color &color)
定义 UITextInput.h:52

Shit::UITextInput::m_selectionAnchor
size_t m_selectionAnchor
定义 UITextInput.h:123

Shit::UITextInput::charToByte
static size_t charToByte(const std::string &s, size_t charIdx)

Shit::UITextInput::getFontPath
const std::string & getFontPath() const
定义 UITextInput.h:40

Shit::UITextInput::insertText
virtual void insertText(const std::string &utf8)
子类可覆写：向缓冲插入一段 UTF-8 文本

Shit::UITextInput::m_preeditLength
int m_preeditLength
定义 UITextInput.h:131

Shit::UITextInput::getSelectionColor
const Color & getSelectionColor() const
定义 UITextInput.h:57

Shit::UITextInput::onRender
void onRender(const SDL_FRect &screenRect) override=0
子类实现：在给定屏幕矩形内绘制自身（通过 Renderer 静态 API 绘制）

Shit::UITextInput::onTextInput
void onTextInput(const char *utf8Text)

Shit::UITextInput::insertNewline
virtual void insertNewline()
子类可覆写：当前选区是否被替换为换行（UITextBox 拒绝）

Shit::UITextInput::byteToChar
static size_t byteToChar(const std::string &s, size_t byteOff)

Shit::UITextInput::setFontPath
void setFontPath(const std::string &fontPath)
定义 UITextInput.h:41

Shit::UITextInput::setSelectionColor
void setSelectionColor(const Color &color)
定义 UITextInput.h:58

Shit::UITextInput::m_selectionColor
Color m_selectionColor
定义 UITextInput.h:115

Shit::UITextInput::m_preedit
std::string m_preedit
定义 UITextInput.h:127

Shit::UITextInput::clampCursor
void clampCursor()

Shit::UITextInput::m_fontSize
float m_fontSize
定义 UITextInput.h:105

Shit::UITextInput::moveCursor
void moveCursor(int deltaChars, bool selecting)

Shit::UITextInput::m_text
std::string m_text
定义 UITextInput.h:99

Shit::UITextInput::m_cursor
size_t m_cursor
定义 UITextInput.h:121

Shit::UITextInput::setFocused
void setFocused(bool focused)
由 UIRenderSystem 在命中时调用，切换聚焦

Shit::UITextInput::setCursorColor
void setCursorColor(const Color &color)
定义 UITextInput.h:55

Shit::UITextInput::getPlaceholderColor
const Color & getPlaceholderColor() const
定义 UITextInput.h:51

Shit::UITextInput::setFontSize
void setFontSize(float fontSize)
定义 UITextInput.h:44

Shit::UITextInput::getFontHeight
float getFontHeight() const
定义 UITextInput.h:46

Shit::UITextInput::acquireFont
TTF_Font * acquireFont()
获取或加载字体（进程级缓存，跨 UITextInput/UITextBox/UITextArea 共享）

Shit::UITextInput::getPlaceholder
const std::string & getPlaceholder() const
定义 UITextInput.h:36

Shit::UITextInput::setPlaceholder
void setPlaceholder(const std::string &placeholder)
定义 UITextInput.h:37

Shit::UITextInput::setText
virtual void setText(const std::string &text)

Shit::UITextInput::deleteSelection
void deleteSelection()

Shit::UITextInput::m_preeditStart
int m_preeditStart
定义 UITextInput.h:129

Shit::UITextInput::m_isFocused
bool m_isFocused
定义 UITextInput.h:95

Shit::UITextInput::TextInputGate
friend class TextInputGate
定义 UITextInput.h:144

Shit::UITextInput::moveCursorToBoundary
void moveCursorToBoundary(bool toStart, bool selecting)

Shit::UITextInput::~UITextInput
~UITextInput() override

Shit::UITextInput::m_placeholder
std::string m_placeholder
定义 UITextInput.h:101

Shit::UITextInput::m_placeholderColor
Color m_placeholderColor
定义 UITextInput.h:111

Shit::UITextInput::m_fontPath
std::string m_fontPath
定义 UITextInput.h:103

Shit::UITextInput::getCharacterCount
size_t getCharacterCount() const
以"字符"计算文本长度

Shit::UITextInput::m_isDirty
bool m_isDirty
定义 UITextInput.h:117

Shit
定义 AudioPlayer.h:10

Shit::KeyCode
KeyCode
定义 KeyCode.h:8

Shit::Color
RGBA 颜色（每通道 8 位）
定义 Core.h:26