QLineEdit Class

멤버 함수 설명서

[explicit] QLineEdit::QLineEdit(QWidget *parent = nullptr)

텍스트가 없는 라인 편집 필드를 생성합니다.

최대 텍스트 길이는 32767자로 설정됩니다.

parent 인수는 QWidget 생성자에 전달됩니다.

setText() 및 setMaxLength()도 참조하십시오 .

[explicit] QLineEdit::QLineEdit(const QString &contents, QWidget *parent = nullptr)

parent 의 자식 요소로, “ contents ”라는 텍스트를 포함하는 라인 편집 필드를 생성합니다.

커서 위치는 줄 끝으로 설정되며, 최대 텍스트 길이는 32767자로 설정됩니다.

text() 및 setMaxLength()도 참조하십시오 .

[virtual noexcept] QLineEdit::~QLineEdit()

라인 편집 내용을 삭제합니다.

void QLineEdit::addAction(QAction *action, QLineEdit::ActionPosition position)

position 의 작업 목록에 ‘ action ’을 추가합니다.

QAction *QLineEdit::addAction(const QIcon &icon, QLineEdit::ActionPosition position)

position 에 지정된 icon 를 사용하여 새로운 액션을 생성합니다.

void QLineEdit::backspace()

텍스트가 선택되어 있지 않으면 텍스트 커서 왼쪽의 문자를 삭제하고, 커서를 한 칸 왼쪽으로 이동합니다. 텍스트가 선택되어 있으면 커서가 선택된 텍스트의 시작 부분으로 이동하고, 선택된 텍스트가 삭제됩니다.

del()도 참조하십시오 .

[override virtual protected] void QLineEdit::changeEvent(QEvent *ev)

QWidget::changeEvent(QEvent *event)를 재구현합니다.

[slot] void QLineEdit::clear()

라인 편집 상자의 내용을 지웁니다.

setText() 및 insert()도 참조하십시오 .

QCompleter *QLineEdit::completer() const

완성 기능을 제공하는 현재 QCompleter 객체를 반환합니다.

setCompleter()도 참조하십시오 .

[override virtual protected] void QLineEdit::contextMenuEvent(QContextMenuEvent *event)

QWidget::contextMenuEvent(QContextMenuEvent *event)를 재구현합니다.

createStandardContextMenu() 함수로 생성된 표준 컨텍스트 메뉴를 표시합니다.

라인 편집 상자에 컨텍스트 메뉴를 표시하지 않으려면, 해당 상자의 contextMenuPolicy 를 Qt::NoContextMenu 로 설정하면 됩니다. 컨텍스트 메뉴를 사용자 정의하려면 이 함수를 재구현하십시오. 표준 컨텍스트 메뉴를 확장하려면 이 함수를 재구현하고, createStandardContextMenu()를 호출한 다음 반환된 메뉴를 확장하십시오.

void LineEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

event 매개변수는 이벤트가 발생했을 때 마우스 커서가 있던 위치를 파악하는 데 사용됩니다.

setContextMenuPolicy()도 참조하십시오 .

[slot] void QLineEdit::copy() const

선택한 텍스트를 클립보드에 복사합니다(선택한 텍스트가 있는 경우). 단, ` echoMode()`의 결과가 ` Normal`인 경우에만 적용됩니다.

cut() 및 paste()도 참조하십시오 .

QMenu *QLineEdit::createStandardContextMenu()

사용자가 라인 편집 상자를 마우스 오른쪽 버튼으로 클릭하면 표시되는 표준 컨텍스트 메뉴를 생성합니다. 이 메뉴는 기본 ` contextMenuEvent()` 핸들러에서 호출됩니다. 팝업 메뉴의 소유권은 호출자에게 이전됩니다.

void QLineEdit::cursorBackward(bool mark, int steps = 1)

커서를 steps 개의 문자만큼 뒤로 이동합니다. mark 가 true인 경우, 이동한 각 문자가 선택 영역에 추가됩니다. mark 가 false인 경우, 선택 영역이 지워집니다.

cursorForward()도 참조하십시오 .

void QLineEdit::cursorForward(bool mark, int steps = 1)

커서를 steps 개의 문자만큼 앞으로 이동합니다. mark 가 true인 경우, 이동한 각 문자가 선택 영역에 추가됩니다. mark 가 false인 경우, 선택 영역이 지워집니다.

cursorBackward()도 참조하십시오 .

int QLineEdit::cursorPositionAt(const QPoint &pos)

pos 지점 바로 아래의 커서 위치를 반환합니다.

[signal] void QLineEdit::cursorPositionChanged(int oldPos, int newPos)

이 신호는 커서가 움직일 때마다 발생합니다. 이전 위치는 oldPos 에서, 새로운 위치는 newPos 에서 확인할 수 있습니다.

setCursorPosition() 및 cursorPosition()도 참조하십시오 .

[protected] QRect QLineEdit::cursorRect() const

라인 에디트 커서를 포함하는 사각형을 반환합니다.

void QLineEdit::cursorWordBackward(bool mark)

커서를 한 단어 뒤로 이동합니다. mark 가 true인 경우, 해당 단어도 선택됩니다.

cursorWordForward()도 참조하십시오 .

void QLineEdit::cursorWordForward(bool mark)

커서를 한 단어 앞으로 이동합니다. mark 가 true인 경우, 해당 단어도 선택됩니다.

cursorWordBackward()도 참조하십시오 .

[slot] void QLineEdit::cut()

선택한 텍스트를 클립보드에 복사하고, 클립보드에 내용이 있는 경우 이를 삭제하며, ` echoMode()`의 반환값이 ` Normal`인 경우에만 수행됩니다.

현재 유효성 검사기가 선택한 텍스트의 삭제를 허용하지 않는 경우, cut()은 삭제하지 않고 복사만 수행합니다.

copy(), paste() 및 setValidator()도 참조하십시오 .

void QLineEdit::del()

텍스트가 선택되어 있지 않으면, 텍스트 커서 오른쪽에 있는 문자를 삭제합니다. 텍스트가 선택되어 있으면, 커서가 선택된 텍스트의 시작 부분으로 이동하고, 선택된 텍스트가 삭제됩니다.

backspace()도 참조하십시오 .

void QLineEdit::deselect()

선택된 텍스트를 모두 선택 해제합니다.

setSelection() 및 selectAll()도 참조하십시오 .

[override virtual protected] void QLineEdit::dragEnterEvent(QDragEnterEvent *e)

QWidget::dragEnterEvent(QDragEnterEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::dragLeaveEvent(QDragLeaveEvent *e)

QWidget::dragLeaveEvent(QDragLeaveEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::dragMoveEvent(QDragMoveEvent *e)

QWidget::dragMoveEvent(QDragMoveEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::dropEvent(QDropEvent *e)

QWidget::dropEvent(QDropEvent *event)를 재구현합니다.

[signal] void QLineEdit::editingFinished()

이 신호는 Return 키나 Enter 키를 누르거나, 라인 편집 상자의 포커스가 해제되었을 때 이 신호가 마지막으로 발생했을 때 이후로 내용이 변경된 경우 발생합니다.

void QLineEdit::end(bool mark)

텍스트 커서가 이미 줄 끝 위치에 있지 않은 경우, 커서를 줄 끝으로 이동합니다. ` mark `가 true인 경우, 텍스트는 마지막 위치 쪽으로 선택됩니다. 그렇지 않은 경우, 커서가 이동하면 선택된 텍스트는 모두 선택 해제됩니다.

home()도 참조하십시오 .

[override virtual] bool QLineEdit::event(QEvent *e)

QWidget::event(QEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::focusInEvent(QFocusEvent *e)

QWidget::focusInEvent(QFocusEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::focusOutEvent(QFocusEvent *e)

QWidget::focusOutEvent(QFocusEvent *event)를 재구현합니다.

void QLineEdit::home(bool mark)

텍스트 커서가 이미 줄의 맨 앞에 있지 않은 경우, 커서를 줄의 맨 앞으로 이동합니다. ` mark `가 true인 경우, 텍스트는 맨 앞 위치 쪽으로 선택됩니다. 그렇지 않은 경우, 커서가 이동하면 선택된 텍스트가 모두 선택 해제됩니다.

end()도 참조하십시오 .

[virtual protected] void QLineEdit::initStyleOption(QStyleOptionFrame *option) const

option 를 QLineEdit 에 있는 값들로 초기화합니다. 이 메서드는 하위 클래스가 QStyleOptionFrame 가 필요하지만 모든 정보를 직접 입력하고 싶지 않을 때 유용합니다.

QStyleOption::initFrom()도 참조하십시오 .

[override virtual protected] void QLineEdit::inputMethodEvent(QInputMethodEvent *e)

QWidget::inputMethodEvent(QInputMethodEvent *event)를 재구현합니다.

[override virtual] QVariant QLineEdit::inputMethodQuery(Qt::InputMethodQuery property) const

QWidget::inputMethodQuery(const Qt::InputMethodQuery query)를 재구현합니다.

[signal] void QLineEdit::inputRejected()

이 신호는 사용자가 유효한 입력으로 간주되지 않는 키를 사용할 때 발생합니다. 예를 들어, 특정 키를 사용했을 때 유효성 검사기의 ` validate()` 호출 결과가 ` Invalid`을 반환하는 경우입니다. 또 다른 예로는 라인 편집기의 최대 길이를 초과하여 문자를 입력하려고 시도할 때입니다.

void QLineEdit::insert(const QString &newText)

선택된 텍스트를 모두 삭제하고, newText 를 삽입한 뒤, 그 결과를 유효성 검사합니다. 결과가 유효한 경우, 새로운 텍스트를 라인 편집기의 새 내용으로 설정합니다.

setText() 및 clear()도 참조하십시오 .

[override virtual protected] void QLineEdit::keyPressEvent(QKeyEvent *event)

QWidget::keyPressEvent(QKeyEvent *event)를 재구현합니다.

주어진 키 입력 event 를 라인 편집 액션으로 변환합니다.

Return 또는 Enter 키가 사용되고 현재 텍스트가 유효한 경우(또는 유효성 검사기에 의해 made valid 로 처리될 수 있는 경우), returnPressed() 신호가 발송됩니다.

Default Key Bindings도 참조하십시오 .

[override virtual protected] void QLineEdit::keyReleaseEvent(QKeyEvent *e)

QWidget::keyReleaseEvent(QKeyEvent *event)를 재구현합니다.

[override virtual] QSize QLineEdit::minimumSizeHint() const

QWidget::minimumSizeHint 속성에 대한 액세스 함수를 재구현합니다.

라인 에디트의 최소 크기를 반환합니다.

반환되는 너비는 일반적으로 적어도 한 글자를 표시하기에 충분합니다.

[override virtual protected] void QLineEdit::mouseDoubleClickEvent(QMouseEvent *e)

QWidget::mouseDoubleClickEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::mouseMoveEvent(QMouseEvent *e)

QWidget::mouseMoveEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::mousePressEvent(QMouseEvent *e)

QWidget::mousePressEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::mouseReleaseEvent(QMouseEvent *e)

QWidget::mouseReleaseEvent(QMouseEvent *event)를 재구현합니다.

[override virtual protected] void QLineEdit::paintEvent(QPaintEvent *)

QWidget::paintEvent(QPaintEvent *event)를 재구현합니다.

[slot] void QLineEdit::paste()

라인 편집 상자가 ‘ read-only ’ 상태가 아닌 경우, 선택된 텍스트를 삭제하고 클립보드의 텍스트를 커서 위치에 삽입합니다.

최종 결과가 현재 validator 에 대해 유효하지 않은 경우, 아무 작업도 수행되지 않습니다.

copy() 및 cut()도 참조하십시오 .

[slot] void QLineEdit::redo()

`redo`가 ` available`인 경우 마지막 작업을 다시 수행합니다.

[signal] void QLineEdit::returnPressed()

이 신호는 Return 또는 Enter 키가 눌릴 때 발생합니다.

[slot] void QLineEdit::selectAll()

모든 텍스트를 선택(하이라이트)하고 커서를 끝으로 이동합니다.

setSelection() 및 deselect()도 참조하십시오 .

[signal] void QLineEdit::selectionChanged()

이 신호는 선택 항목이 변경될 때마다 발생합니다.

hasSelectedText() 및 selectedText()도 참조하십시오 .

int QLineEdit::selectionEnd() const

라인 편집 상자에서 선택 영역 바로 뒤의 문자의 인덱스를 반환합니다(텍스트가 선택되지 않은 경우 -1을 반환합니다).

selectedText(), selectionStart(), selectionLength()도 참조하십시오 .

int QLineEdit::selectionLength() const

선택 영역의 길이를 반환합니다.

selectedText(), selectionStart(), selectionEnd()도 참조하십시오 .

int QLineEdit::selectionStart() const

라인 편집 상자에서 선택된 첫 번째 문자의 인덱스를 반환합니다(텍스트가 선택되지 않은 경우 -1을 반환합니다).

selectedText(), selectionEnd(), selectionLength()도 참조하십시오 .

void QLineEdit::setCompleter(QCompleter *c)

이 라인 편집 필드가 자동 완성 도구( c)에서 자동 완성 기능을 제공하도록 설정합니다. 자동 완성 모드는 QCompleter::setCompletionMode()를 사용하여 설정합니다.

QCompleter 를 QValidator 또는 QLineEdit::inputMask 와 함께 사용하려면, QCompleter 에 전달된 모델에 유효한 항목이 포함되어 있는지 확인해야 합니다. QSortFilterProxyModel 를 사용하여 QCompleter 의 모델에 유효한 항목만 포함되어 있는지 확인할 수 있습니다.

완성 기능을 제거하고 자동 완성 기능을 비활성화하려면 ` nullptr`를 전달하십시오.

completer() 및 QCompleter도 참조하십시오 .

void QLineEdit::setSelection(int start, int length)

start 위치부터 시작하여 length 개 문자를 선택합니다. 음수 길이를 사용할 수 있습니다.

deselect(), selectAll(), selectedText()도 참조하십시오 .

void QLineEdit::setTextMargins(const QMargins &margins)

프레임 내부의 텍스트를 둘러싸는 margins 을 설정합니다.

textMargins()도 참조하십시오 .

void QLineEdit::setTextMargins(int left, int top, int right, int bottom)

프레임 내 텍스트 주변의 여백 크기를 left, top, right, bottom 로 설정합니다.

textMargins()도 참조하십시오 .

void QLineEdit::setValidator(const QValidator *v)

라인 편집기의 값에 대한 유효성 검사기를 v 로 설정합니다.

라인 에디트의 ` returnPressed()` 및 ` editingFinished()` 신호는 ` v `가 라인 에디트의 내용을 ` Acceptable`로 유효성 검사할 때만 발생합니다. 사용자는 편집 중에 내용을 ` Intermediate ` 값으로 자유롭게 변경할 수 있지만, ` v `가 ` Invalid`로 유효성 검사하는 값으로 텍스트를 편집하는 것은 차단됩니다.

이를 통해 편집이 완료되었을 때 저장될 텍스트를 제한하는 동시에, 사용자가 한 유효한 상태에서 다른 유효한 상태로 텍스트를 편집할 수 있는 충분한 자유를 보장할 수 있습니다.

현재 입력 유효성 검사기를 제거하려면 nullptr 를 전달하십시오. 초기 설정은 입력 유효성 검사기가 없는 상태입니다( maxLength()까지 모든 입력이 허용됨).

validator(), hasAcceptableInput(), QIntValidator, QDoubleValidator 및 QRegularExpressionValidator도 참조하십시오 .

[override virtual] QSize QLineEdit::sizeHint() const

QWidget::sizeHint 속성에 대한 액세스 함수를 재구현합니다.

위젯에 권장되는 크기를 반환합니다.

반환되는 너비(픽셀 단위)는 대개 15~20자 정도를 표시하기에 충분합니다.

[signal] void QLineEdit::textChanged(const QString &text)

이 신호는 텍스트가 변경될 때마다 발생합니다. text 인수는 새로운 텍스트입니다.

textEdited()와 달리, 이 신호는 예를 들어 setText()를 호출하는 등 프로그래밍 방식으로 텍스트가 변경될 때도 발생합니다.

[signal] void QLineEdit::textEdited(const QString &text)

이 신호는 텍스트가 편집될 때마다 발생합니다. text 인수는 새로운 텍스트입니다.

textChanged()와 달리, 이 신호는 예를 들어 setText()를 호출하는 등 프로그래밍 방식으로 텍스트가 변경될 때는 발생하지 않습니다.

QMargins QLineEdit::textMargins() const

위젯의 텍스트 여백을 반환합니다.

setTextMargins()도 참조하십시오 .

[override virtual] void QLineEdit::timerEvent(QTimerEvent *e)

QObject::timerEvent(QTimerEvent *event)를 재구현합니다.

[slot] void QLineEdit::undo()

`undo`가 ` available`인 경우 마지막 작업을 취소합니다. 현재 선택된 항목을 모두 선택 해제하고, 선택 시작 위치를 현재 커서 위치로 업데이트합니다.

const QValidator *QLineEdit::validator() const

현재 입력 유효성 검사기에 대한 포인터를 반환하며, 유효성 검사기가 설정되어 있지 않은 경우에는 ` nullptr `를 반환합니다.

setValidator()도 참조하십시오 .