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 * 이벤트).

[slot] void QLineEdit::clear()

줄 편집 내용을 지웁니다.

setText() 및 insert()도 참조하세요 .

QCompleter *QLineEdit::completer() const

완료를 제공하는 현재 QCompleter 를 반환합니다.

setCompleter()도 참조하세요 .

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

다시 구현합니다: QWidget::contextMenuEvent(QContextMenuEvent * 이벤트).

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 이 참이면 이동한 각 문자가 선택 영역에 추가됩니다. mark 이 거짓이면 선택 영역이 지워집니다.

cursorForward()도 참조하세요 .

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

커서를 steps 문자 앞으로 이동합니다. mark 이 참이면 이동한 각 문자가 선택 영역에 추가됩니다. mark 이 거짓이면 선택 영역이 지워집니다.

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 이 참이면 해당 단어도 선택됩니다.

cursorWordForward()도 참조하세요 .

void QLineEdit::cursorWordForward(bool mark)

커서를 한 단어 앞으로 이동합니다. mark 이 참이면 해당 단어도 선택됩니다.

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 * 이벤트).

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

다시 구현합니다: QWidget::dragLeaveEvent(QDragLeaveEvent * 이벤트).

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

다시 구현합니다: QWidget::dragMoveEvent(QDragMoveEvent * 이벤트).

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

다시 구현합니다: QWidget::dropEvent(QDropEvent * 이벤트).

[signal] void QLineEdit::editingFinished()

이 신호는 리턴 또는 엔터 키를 사용하거나 줄 편집이 초점을 잃고 마지막으로 이 신호가 발생한 이후 내용이 변경된 경우 발생합니다.

void QLineEdit::end(bool mark)

텍스트 커서가 이미 있지 않은 경우 텍스트 커서를 줄의 끝으로 이동합니다. mark 이 참이면 텍스트가 마지막 위치로 선택됩니다. 그렇지 않으면 커서를 이동하면 선택된 텍스트가 선택 취소됩니다.

home()도 참조하세요 .

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

다시 구현합니다: QWidget::event(QEvent * 이벤트).

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

다시 구현합니다: QWidget::focusInEvent(QFocusEvent * 이벤트).

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

다시 구현합니다: QWidget::focusOutEvent(QFocusEvent * 이벤트).

void QLineEdit::home(bool mark)

텍스트 커서가 이미 있지 않은 경우 텍스트 커서를 줄의 시작 부분으로 이동합니다. mark 이 참이면 텍스트가 첫 번째 위치로 선택됩니다. 그렇지 않으면 커서를 이동하면 선택된 텍스트가 선택 취소됩니다.

end()도 참조하세요 .

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

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

QStyleOption::initFrom()도 참조하세요 .

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

다시 구현합니다: QWidget::inputMethodEvent(Q입력메소드이벤트 *이벤트).

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

재구현합니다: QWidget::inputMethodQuery(Qt::InputMethodQuery 쿼리) const.

[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 를 줄 편집 액션으로 변환합니다.

Return 또는 Enter가 사용되었고 현재 텍스트가 유효하면(또는 유효성 검사기에 의해 made valid 일 수 있음) returnPressed() 신호가 방출됩니다.

Default Key Bindings 를참조하세요 .

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

다시 구현합니다: QWidget::keyReleaseEvent(QKeyEvent * 이벤트).

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

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

줄 편집을 위한 최소 크기를 반환합니다.

반환되는 너비는 일반적으로 최소 한 글자 이상에 충분합니다.

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

다시 구현합니다: QWidget::mouseDoubleClickEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::mouseMoveEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::mousePressEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::mouseReleaseEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QWidget::paintEvent(QPaintEvent * 이벤트).

[slot] void QLineEdit::paste()

커서 위치에 클립보드의 텍스트를 삽입하여 선택한 텍스트를 삭제하고 줄 편집이 read-only 이 아닌 경우 삭제합니다.

최종 결과가 현재 validator 에 유효하지 않은 경우 아무 일도 일어나지 않습니다.

copy() 및 cut()도 참조하세요 .

[slot] void QLineEdit::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()를 사용하여 설정합니다.

QValidator 또는 QLineEdit::inputMask 와 함께 QCompleter 를 사용하려면 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(Q타이머이벤트 *이벤트).

[slot] void QLineEdit::undo()

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

const QValidator *QLineEdit::validator() const

현재 입력 유효성 검사기에 대한 포인터를 반환하거나 유효성 검사기가 설정되지 않은 경우 nullptr 을 반환합니다.

setValidator()도 참조하세요 .