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)

これはオーバーロードされた関数である。

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

カーソルを1語後ろに移動する。mark が真の場合、その単語も選択される。

cursorWordForward()も参照 。

void QLineEdit::cursorWordForward(bool mark)

カーソルを1語進める。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 *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 が真の場合、テキストは最後の位置に向かって選択される。そうでない場合、カーソルが移動すると、選択されているテキストはすべて非選択になります。

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 が真の場合、テキストは最初の位置に向かって選択される。そうでない場合、カーソルが移動すると、選択されているテキストはすべて非選択になります。

end()も参照 。

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

QLineEdit の値でoption を初期化する。このメソッドは、サブクラスが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 を返した場合などです。もう1つのケースは、行編集の最大長を超える文字を入力しようとした場合である。

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()

やり直しが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()

元に戻す がavailable の場合、直前の操作を元に戻す。現在の選択範囲の選択を解除し、選択範囲の開始位置を現在のカーソル位置に更新します。

const QValidator *QLineEdit::validator() const

現在の入力バリデータへのポインタを返します。 バリデータが設定されていない場合はnullptr を返します。

setValidator()も参照ください 。