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)

再リンプルメント: (QDragLeaveEvent *event)：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)

再リンプルメント: (QFocusEvent *event)：QWidget::focusOutEvent(QFocusEvent *event)。

void QLineEdit::home(bool mark)

テキストカーソルがすでに行頭にある場合を除き、テキストカーソルを行頭に移動します。mark が true の場合、テキストは最初の位置に向かって選択されます。そうでない場合、カーソルが移動すると、選択されているテキストはすべて非選択になります。

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)

Reimplements: (QMouseEvent *event)：QWidget::mouseMoveEvent(QMouseEvent *event)。

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

再リンプルメント: (QMouseEvent *event)QWidget::mousePressEvent(QMouseEvent *event).

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

再リンプルメント: (QMouseEvent *event)QWidget::mouseReleaseEvent(QMouseEvent *event).

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

再リンプルメント: (QMouseEvent *event)：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() で設定する。

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(QTimerEvent *event)。

[slot] void QLineEdit::undo()

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

const QValidator *QLineEdit::validator() const

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

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