Dreamine.UI.WinForms.Controls.DreamineTextBox에 대한 상속 다이어그램 :

Dreamine.UI.WinForms.Controls.DreamineTextBox에 대한 협력 다이어그램:

Public 멤버 함수
void	InsertText (string text)
void	ReplaceTextTail (int replaceCount, string text)
void	Backspace ()
string	GetTextBeforeCaret ()
	DreamineTextBox ()

Protected 멤버 함수
override void	OnLayout (LayoutEventArgs e)
override void	OnPaint (PaintEventArgs e)

속성
new string	Text `[get, set]`
string	Hint `[get, set]`
bool	IsReadOnly `[get, set]`
int	SelectionStart `[get, set]`
int	SelectionLength `[get, set]`
IntPtr	TextBoxHandle `[get]`
override Color	ForeColor `[get, set]`
new Font	Font `[get, set]`
override Padding	DefaultPadding `[get]`
override Size	DefaultSize `[get]`

이벤트
new? EventHandler	TextChanged

Private 멤버 함수
static IntPtr	SendMessage (IntPtr hWnd, int msg, IntPtr wParam, string lParam)

Private 속성
readonly TextBox	_inner
bool	_isFocused
string	_hint = string.Empty

정적 Private 속성
const int	EM_SETCUEBANNER = 0x1501

상세한 설명

힌트, 읽기 전용 상태, 선택 범위 편집 및 포커스 테두리를 제공하는 WinForms 텍스트 입력 래퍼입니다.

DreamineTextBox.cs 파일의 15 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

◆ DreamineTextBox()

Dreamine.UI.WinForms.Controls.DreamineTextBox.DreamineTextBox ( )

inline

내부 텍스트 상자, 힌트 처리, 이벤트 전달 및 Dreamine 테마 기본값을 구성합니다.

DreamineTextBox.cs 파일의 365 번째 라인에서 정의되었습니다.

    {
        // _inner must be created first — SetStyle and property setters below
        // can trigger OnLayout / ForeColor / Font overrides before the field is set.
        _inner = new TextBox
        {
            BorderStyle = BorderStyle.None,
            BackColor   = DreamineTheme.InputBackground,
            ForeColor   = DreamineTheme.TextPrimary,
            Font        = new Font("Segoe UI", 10f, FontStyle.Regular, GraphicsUnit.Point),
            Dock        = DockStyle.Fill,
            Margin      = Padding.Empty,
        };
 
        _inner.GotFocus  += (_, _) => { _isFocused = true;  Invalidate(); };
        _inner.LostFocus += (_, _) => { _isFocused = false; Invalidate(); };
        _inner.TextChanged += (s, e) => TextChanged?.Invoke(this, e);
        _inner.HandleCreated += (_, _) =>
        {
            if (!string.IsNullOrEmpty(_hint))
                SendMessage(_inner.Handle, EM_SETCUEBANNER, (IntPtr)1, _hint);
        };
 
        SetStyle(
            ControlStyles.AllPaintingInWmPaint |
            ControlStyles.UserPaint |
            ControlStyles.DoubleBuffer |
            ControlStyles.ResizeRedraw, true);
 
        BackColor = DreamineTheme.InputBackground;
        ForeColor = DreamineTheme.TextPrimary;
        Font      = _inner.Font;
        Height    = 36;
        Padding   = new Padding(2);
 
        Controls.Add(_inner);
    }

다음을 참조함 : _hint, _inner, _isFocused, EM_SETCUEBANNER, Font, ForeColor, Dreamine.UI.WinForms.DreamineTheme.InputBackground, SendMessage(), TextChanged, Dreamine.UI.WinForms.DreamineTheme.TextPrimary.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

멤버 함수 문서화

◆ Backspace()

void Dreamine.UI.WinForms.Controls.DreamineTextBox.Backspace ( )

inline

선택 영역 또는 캐럿 앞의 문자 하나를 삭제합니다.

DreamineTextBox.cs 파일의 311 번째 라인에서 정의되었습니다.

    {
        if (_inner.ReadOnly)
            return;
 
        var currentText = _inner.Text ?? string.Empty;
        var selectionStart = Math.Clamp(_inner.SelectionStart, 0, currentText.Length);
        var selectionLength = Math.Clamp(_inner.SelectionLength, 0, currentText.Length - selectionStart);
 
        if (selectionLength > 0)
        {
            _inner.SelectedText = string.Empty;
        }
        else if (selectionStart > 0)
        {
            _inner.Text = currentText.Remove(selectionStart - 1, 1);
            _inner.SelectionStart = selectionStart - 1;
        }
 
        _inner.Focus();
    }

다음을 참조함 : _inner.

◆ GetTextBeforeCaret()

string Dreamine.UI.WinForms.Controls.DreamineTextBox.GetTextBeforeCaret ( )

inline

내부 텍스트 상자에서 캐럿 앞의 텍스트를 가져옵니다.

반환값: 캐럿 앞의 텍스트입니다.

DreamineTextBox.cs 파일의 349 번째 라인에서 정의되었습니다.

    {
        var currentText = _inner.Text ?? string.Empty;
        var caret = Math.Clamp(_inner.SelectionStart, 0, currentText.Length);
        return currentText[..caret];
    }

다음을 참조함 : _inner.

◆ InsertText()

void Dreamine.UI.WinForms.Controls.DreamineTextBox.InsertText ( string text )

inline

읽기 전용이 아니면 현재 선택 위치에 텍스트를 삽입하고 입력 포커스를 복원합니다.

매개변수

text	삽입할 텍스트입니다.

DreamineTextBox.cs 파일의 245 번째 라인에서 정의되었습니다.

    {
        if (_inner.ReadOnly)
            return;
 
        _inner.SelectedText = text;
        _inner.Focus();
    }

다음을 참조함 : _inner.

◆ OnLayout()

override void Dreamine.UI.WinForms.Controls.DreamineTextBox.OnLayout ( LayoutEventArgs e )

inlineprotected

내부 텍스트 상자를 래퍼의 현재 크기에 맞춰 배치합니다.

매개변수

e	레이아웃 이벤트 인수입니다.

DreamineTextBox.cs 파일의 429 번째 라인에서 정의되었습니다.

    {
        base.OnLayout(e);
        if (_inner == null) return;
        _inner.SetBounds(6, (Height - _inner.PreferredHeight) / 2,
            Width - 12, _inner.PreferredHeight);
    }

다음을 참조함 : _inner.

◆ OnPaint()

override void Dreamine.UI.WinForms.Controls.DreamineTextBox.OnPaint ( PaintEventArgs e )

inlineprotected

현재 포커스와 활성 상태에 맞게 둥근 배경과 테두리를 그립니다.

매개변수

e	컨트롤 그리기 이벤트 인수입니다.

DreamineTextBox.cs 파일의 453 번째 라인에서 정의되었습니다.

    {
        var g    = e.Graphics;
        var rect = new Rectangle(0, 0, Width - 1, Height - 1);
 
        using var bgBrush = new SolidBrush(BackColor);
        var borderColor = _isFocused ? DreamineTheme.BorderFocus : DreamineTheme.BorderNormal;
        if (!Enabled) borderColor = Color.FromArgb(80, borderColor);
        using var pen = new Pen(borderColor, 1.5f);
        DreamineDrawHelper.FillRoundedRect(g, bgBrush, pen, rect, DreamineTheme.CornerRadiusSmall);
    }

다음을 참조함 : _isFocused, Dreamine.UI.WinForms.DreamineTheme.BorderFocus, Dreamine.UI.WinForms.DreamineTheme.BorderNormal, Dreamine.UI.WinForms.DreamineTheme.CornerRadiusSmall, Dreamine.UI.WinForms.DreamineDrawHelper.FillRoundedRect().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ ReplaceTextTail()

void Dreamine.UI.WinForms.Controls.DreamineTextBox.ReplaceTextTail	(	int	replaceCount,
		string	text )

inline

선택 영역을 교체하거나 캐럿 앞의 지정 문자 수를 새 텍스트로 교체합니다.

매개변수

replaceCount	선택 영역이 없을 때 캐럿 앞에서 교체할 문자 수입니다.
text	교체 위치에 삽입할 텍스트입니다.

DreamineTextBox.cs 파일의 278 번째 라인에서 정의되었습니다.

    {
        if (_inner.ReadOnly)
            return;
 
        var currentText = _inner.Text ?? string.Empty;
        var selectionStart = Math.Clamp(_inner.SelectionStart, 0, currentText.Length);
        var selectionLength = Math.Clamp(_inner.SelectionLength, 0, currentText.Length - selectionStart);
 
        if (selectionLength > 0)
        {
            _inner.SelectedText = text;
        }
        else
        {
            var removeStart = Math.Max(0, selectionStart - replaceCount);
            removeStart = Math.Min(removeStart, currentText.Length);
            var removeLength = Math.Clamp(selectionStart - removeStart, 0, currentText.Length - removeStart);
            _inner.Text = currentText.Remove(removeStart, removeLength).Insert(removeStart, text);
            _inner.SelectionStart = removeStart + text.Length;
        }
 
        _inner.Focus();
    }

다음을 참조함 : _inner.

◆ SendMessage()

IntPtr Dreamine.UI.WinForms.Controls.DreamineTextBox.SendMessage	(	IntPtr	hWnd,
		int	msg,
		IntPtr	wParam,
		string	lParam )

private

Win32 메시지를 내부 텍스트 상자에 보내 힌트 배너를 설정합니다.

매개변수

hWnd	대상 창 핸들입니다.
msg	전송할 Win32 메시지 식별자입니다.
wParam	메시지의 정수 포인터 매개변수입니다.
lParam	메시지에 전달할 문자열입니다.

반환값: 메시지 처리 결과입니다.

다음에 의해서 참조됨 : DreamineTextBox().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ _hint

string Dreamine.UI.WinForms.Controls.DreamineTextBox._hint = string.Empty

private

hint 값을 보관합니다.

DreamineTextBox.cs 파일의 119 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DreamineTextBox().

◆ _inner

readonly TextBox Dreamine.UI.WinForms.Controls.DreamineTextBox._inner

private

inner 값을 보관합니다.

DreamineTextBox.cs 파일의 85 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Backspace(), DreamineTextBox(), GetTextBeforeCaret(), InsertText(), OnLayout(), ReplaceTextTail().

◆ _isFocused

bool Dreamine.UI.WinForms.Controls.DreamineTextBox._isFocused

private

is Focused 값을 보관합니다.

DreamineTextBox.cs 파일의 94 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DreamineTextBox(), OnPaint().

◆ EM_SETCUEBANNER

const int Dreamine.UI.WinForms.Controls.DreamineTextBox.EM_SETCUEBANNER = 0x1501

staticprivate

EM SETCUEBANNER 값을 보관합니다.

DreamineTextBox.cs 파일의 25 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DreamineTextBox().

속성 문서화

◆ DefaultPadding

override Padding Dreamine.UI.WinForms.Controls.DreamineTextBox.DefaultPadding

getprotected

텍스트 입력 래퍼의 기본 내부 여백을 가져옵니다.

DreamineTextBox.cs 파일의 411 번째 라인에서 정의되었습니다.

◆ DefaultSize

override Size Dreamine.UI.WinForms.Controls.DreamineTextBox.DefaultSize

getprotected

텍스트 입력 래퍼의 기본 크기를 가져옵니다.

DreamineTextBox.cs 파일의 473 번째 라인에서 정의되었습니다.

◆ Font

new Font Dreamine.UI.WinForms.Controls.DreamineTextBox.Font

getset

래퍼와 내부 텍스트 상자의 글꼴을 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 213 번째 라인에서 정의되었습니다.

    {
        get => base.Font;
        set { base.Font = value; if (_inner != null) _inner.Font = value; }
    }

다음에 의해서 참조됨 : DreamineTextBox().

◆ ForeColor

override Color Dreamine.UI.WinForms.Controls.DreamineTextBox.ForeColor

getset

래퍼와 내부 텍스트 상자의 전경색을 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 199 번째 라인에서 정의되었습니다.

    {
        get => base.ForeColor;
        set { base.ForeColor = value; if (_inner != null) _inner.ForeColor = value; }
    }

다음에 의해서 참조됨 : DreamineTextBox().

◆ Hint

string Dreamine.UI.WinForms.Controls.DreamineTextBox.Hint

getset

입력 전 표시할 네이티브 힌트 배너를 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 128 번째 라인에서 정의되었습니다.

    {
        get => _hint;
        set
        {
            _hint = value;
            if (_inner.IsHandleCreated)
                SendMessage(_inner.Handle, EM_SETCUEBANNER, (IntPtr)1, _hint);
        }
    }

◆ IsReadOnly

bool Dreamine.UI.WinForms.Controls.DreamineTextBox.IsReadOnly

getset

사용자가 텍스트를 편집할 수 없는지 여부를 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 147 번째 라인에서 정의되었습니다.

    {
        get => _inner.ReadOnly;
        set { _inner.ReadOnly = value; Invalidate(); }
    }

◆ SelectionLength

int Dreamine.UI.WinForms.Controls.DreamineTextBox.SelectionLength

getset

선택된 문자 수를 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 175 번째 라인에서 정의되었습니다.

    {
        get => _inner.SelectionLength;
        set => _inner.SelectionLength = Math.Clamp(value, 0, _inner.TextLength - _inner.SelectionStart);
    }

◆ SelectionStart

int Dreamine.UI.WinForms.Controls.DreamineTextBox.SelectionStart

getset

선택 범위 또는 캐럿의 시작 인덱스를 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 161 번째 라인에서 정의되었습니다.

    {
        get => _inner.SelectionStart;
        set => _inner.SelectionStart = Math.Clamp(value, 0, _inner.TextLength);
    }

◆ Text

new string Dreamine.UI.WinForms.Controls.DreamineTextBox.Text

getset

내부 텍스트 상자의 현재 텍스트를 가져오거나 설정합니다.

DreamineTextBox.cs 파일의 105 번째 라인에서 정의되었습니다.

    {
        get => _inner.Text;
        set => _inner.Text = value;
    }

◆ TextBoxHandle

IntPtr Dreamine.UI.WinForms.Controls.DreamineTextBox.TextBoxHandle

get

내부 네이티브 텍스트 상자 창 핸들을 가져옵니다.

DreamineTextBox.cs 파일의 189 번째 라인에서 정의되었습니다.

이벤트 문서화

◆ TextChanged

new? EventHandler Dreamine.UI.WinForms.Controls.DreamineTextBox.TextChanged

내부 텍스트가 변경될 때 발생합니다.

DreamineTextBox.cs 파일의 227 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : DreamineTextBox().

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

DreamineTextBox.cs

Public 멤버 함수

Protected 멤버 함수

속성

이벤트

Private 멤버 함수

Private 속성

정적 Private 속성

상세한 설명

생성자 & 소멸자 문서화

◆ DreamineTextBox()

멤버 함수 문서화

◆ Backspace()

◆ GetTextBeforeCaret()

◆ InsertText()

◆ OnLayout()

◆ OnPaint()

◆ ReplaceTextTail()

◆ SendMessage()

멤버 데이터 문서화

◆ _hint

◆ _inner

◆ _isFocused

◆ EM_SETCUEBANNER

속성 문서화

◆ DefaultPadding

◆ DefaultSize

◆ Font

◆ ForeColor

◆ Hint

◆ IsReadOnly

◆ SelectionLength

◆ SelectionStart

◆ Text

◆ TextBoxHandle

이벤트 문서화

◆ TextChanged