QLineEdit Class

メンバー関数のドキュメント

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

テキストのないラインエディットを作成します。

テキストの最大長さは 32767 文字に設定されています。

parent 引数は、QWidget コンストラクタに渡されます。

setText() およびsetMaxLength()も参照してください 。

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

「contents 」というテキストを含むラインエディットを、parent の子要素として作成します。

カーソル位置は行の末尾に設定され、テキストの最大長は 32767 文字に設定されます。

text() およびsetMaxLength()も参照してください 。

[virtual noexcept] QLineEdit::~QLineEdit()

line edit を削除します。

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

position のアクション一覧に「action 」を追加します。

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

指定されたicon を使用して、position に新しいアクションを作成します。

void QLineEdit::backspace()

テキストが選択されていない場合は、テキストカーソルの左側にある文字を削除し、カーソルを1文字分左に移動します。テキストが選択されている場合は、カーソルを選択したテキストの先頭に移動し、選択したテキストを削除します。

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 が真の場合、移動した各文字が選択範囲に追加されます。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)

カーソルを1語分後ろに移動します。mark がtrueの場合、その語も選択されます。

cursorWordForward()も参照してください 。

void QLineEdit::cursorWordForward(bool mark)

カーソルを1語分前方へ移動します。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 （Qt::InputMethodQuery query）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) を再実装します。

指定されたキー押下イベント `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 」のアクセス関数を再実装します。

ラインエディットの最小サイズを返します。

返される幅は、通常、少なくとも 1 文字を表示するのに十分な幅です。

[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()も参照してください 。