QFormLayout Class

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

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

指定されたparent ウィジェットを使用して、新しいフォームレイアウトを構築します。

このレイアウトは、parent の最上位レイアウトとして直接設定されます。ウィジェットには、最上位レイアウトは1つしか存在できません。これはQWidget::layout()によって返されます。

QWidget::setLayout()も参照してください 。

[virtual noexcept] QFormLayout::~QFormLayout()

フォームのレイアウトを破壊します。

[override virtual] void QFormLayout::addItem(QLayoutItem *item)

QLayout::addItem(QLayoutItem *item) の再実装です。

void QFormLayout::addRow(QWidget *label, QWidget *field)

このフォームレイアウトの最下部に、指定されたlabel およびfield を持つ新しい行を追加します。

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

void QFormLayout::addRow(QLayout *layout)

指定されたlayout を、このフォームレイアウトの最後に追加します。layout は両方の列にまたがります。

void QFormLayout::addRow(QWidget *widget)

指定されたwidget を、このフォームレイアウトの最後に追加します。widget は両方の列にまたがります。

void QFormLayout::addRow(QWidget *label, QLayout *field)

void QFormLayout::addRow(const QString &labelText, QLayout *field)

このオーバーロードは、内部で自動的にQLabel を生成し、そのテキストとしてlabelText を設定します。

void QFormLayout::addRow(const QString &labelText, QWidget *field)

このオーバーロードは、内部で自動的にテキストが「labelText 」であるQLabel を作成します。field は、新しいQLabel のbuddy として設定されます。

[override virtual] int QFormLayout::count() const

QLayout::count() const を再実装します。

[override virtual] Qt::Orientations QFormLayout::expandingDirections() const

QLayout::expandingDirections() const を再実装します。

void QFormLayout::getItemPosition(int index, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

指定されたindex にある項目の行番号とロール（列）を取得します。index が範囲外の場合、*rowPtr には-1が設定されます。それ以外の場合は、行番号が*rowPtr に、ロールが*rolePtr に格納されます。

itemAt()、count()、getLayoutPosition()、およびgetWidgetPosition()も参照してください 。

void QFormLayout::getLayoutPosition(QLayout *layout, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

指定された子要素 `layout` の行とロール（列）を取得します。`layout ` がフォームレイアウトに含まれていない場合、`*rowPtr ` には -1 が設定されます。それ以外の場合は、行が `*rowPtr ` に、ロールが `*rolePtr` に格納されます。

void QFormLayout::getWidgetPosition(QWidget *widget, int *rowPtr, QFormLayout::ItemRole *rolePtr) const

レイアウト内の指定されたwidget の行とロール（列）を取得します。widget がレイアウト内に存在しない場合、*rowPtr には-1が設定されます。それ以外の場合は、行が*rowPtr に、ロールが*rolePtr に格納されます。

getItemPosition() およびitemAt()も参照してください 。

[override virtual] bool QFormLayout::hasHeightForWidth() const

QLayoutItem::hasHeightForWidth() const を再実装します。

[override virtual] int QFormLayout::heightForWidth(int width) const

QLayoutItem::heightForWidth(int) const を再実装します。

void QFormLayout::insertRow(int row, QWidget *label, QWidget *field)

このフォームレイアウトのrow の位置に、指定されたlabel およびfield を用いて新しい行を挿入します。row が範囲外の場合、新しい行は末尾に追加されます。

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

void QFormLayout::insertRow(int row, QLayout *layout)

このフォームレイアウトのrow の位置に、指定されたlayout を挿入します。layout は両方の列にまたがります。row が範囲外の場合、ウィジェットは末尾に追加されます。

void QFormLayout::insertRow(int row, QWidget *widget)

このフォームレイアウトのrow の位置に、指定されたwidget を挿入します。widget は両方の列にまたがります。row が範囲外の場合、ウィジェットは末尾に追加されます。

void QFormLayout::insertRow(int row, QWidget *label, QLayout *field)

void QFormLayout::insertRow(int row, const QString &labelText, QLayout *field)

このオーバーロードは、内部で自動的にテキストが「labelText 」であるQLabel を作成します。

void QFormLayout::insertRow(int row, const QString &labelText, QWidget *field)

このオーバーロードは、内部で自動的にテキストが「labelText 」であるQLabel を作成します。field は、新しいQLabel のbuddy として設定されます。

[override virtual] void QFormLayout::invalidate()

QLayout::invalidate() の再実装です。

[since 6.4] bool QFormLayout::isRowVisible(int row) const

行row 内のいずれかの項目が表示されている場合はtrueを返し、そうでない場合はfalseを返します。

この関数は Qt 6.4 で導入されました。

[since 6.4] bool QFormLayout::isRowVisible(QLayout *layout) const

layout に対応する行内のいずれかのアイテムが表示されている場合は true を返し、そうでない場合は false を返します。

この関数は Qt 6.4 で導入されました。

[since 6.4] bool QFormLayout::isRowVisible(QWidget *widget) const

widget に対応する行内のいずれかの項目が表示されている場合は true を返し、そうでない場合は false を返します。

この関数は Qt 6.4 で導入されました。

[override virtual] QLayoutItem *QFormLayout::itemAt(int index) const

QLayout::itemAt(int index) const を再実装しています。

QLayoutItem *QFormLayout::itemAt(int row, QFormLayout::ItemRole role) const

指定されたrow 内の、指定されたrole （列）に対応するレイアウト項目を返します。該当する項目がない場合は、nullptr を返します。

QLayout::itemAt() およびsetItem()も参照してください 。

QWidget *QFormLayout::labelForField(QWidget *field) const

指定されたfield に関連付けられたラベルを返します。

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

QWidget *QFormLayout::labelForField(QLayout *field) const

[override virtual] QSize QFormLayout::minimumSize() const

QLayout::minimumSize() const を再実装します。

void QFormLayout::removeRow(int row)

このフォームレイアウトから行row を削除します。

row 引数は非負かつrowCount() 未満でなければなりません。

この呼び出し後、rowCount() は 1 減算されます。この行を占有していたすべてのウィジェットおよびネストされたレイアウトが削除されます。これには、フィールドウィジェットおよび（存在する場合）ラベルの両方が含まれます。後続のすべての行は 1 行上にずらされ、解放された垂直方向のスペースは残りの行に再配分されます。

この関数を使用すると、以前に呼び出されたaddRow()やinsertRow()の操作を元に戻すことができます:

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
flay->removeRow(2); // le == nullptr at this point

ウィジェットを削除せずにレイアウトから行を削除したい場合は、代わりに `takeRow()` を使用してください。

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

void QFormLayout::removeRow(QLayout *layout)

このフォームレイアウトから、layout に対応する行を削除します。

この呼び出し後、rowCount() の値が 1 減少します。この行を占有していたすべてのウィジェットおよびネストされたレイアウトが削除されます。これには、フィールドウィジェットと、存在する場合のラベルの両方が含まれます。その後のすべての行が 1 行分上にずらされ、解放された垂直方向のスペースは残りの行に再配分されます。

この関数を使用すると、以前に実行された `addRow()` または `insertRow()` を元に戻すことができます:

QFormLayout *flay = ...;
QPointer<QVBoxLayout> vbl = new QVBoxLayout;
flay->insertRow(2, "User:", vbl);
// later:
flay->removeRow(layout); // vbl == nullptr at this point

挿入されたレイアウトを削除せずに、フォームレイアウトから行を削除したい場合は、代わりにtakeRow()を使用してください。

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

void QFormLayout::removeRow(QWidget *widget)

このフォームレイアウトから、widget に対応する行を削除します。

この呼び出し後、rowCount() の値が 1 減少します。この行を占めていたすべてのウィジェットおよびネストされたレイアウトが削除されます。これには、フィールドウィジェットおよび（存在する場合）ラベルの両方が含まれます。後続のすべての行が 1 行分上にずらされ、解放された縦方向のスペースは残りの行に再配分されます。

この関数を使用すると、以前に実行された `addRow()` または `insertRow()` の操作を元に戻すことができます:

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
flay->removeRow(le); // le == nullptr at this point

ウィジェットを削除せずにレイアウトから行を削除したい場合は、代わりにtakeRow()を使用してください。

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

int QFormLayout::rowCount() const

フォーム内の行数を返します。

QLayout::count()も参照してください 。

[override virtual] void QFormLayout::setGeometry(const QRect &rect)

QLayout::setGeometry(const QRect &r) の再実装です。

void QFormLayout::setItem(int row, QFormLayout::ItemRole role, QLayoutItem *item)

指定されたrole に対して、指定されたrow 内の項目をitem に設定し、必要に応じてレイアウトを空の行で拡張します。

セルがすでに使用されている場合、item は挿入されず、コンソールにエラーメッセージが出力されます。item は両方の列にまたがります。

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

void QFormLayout::setLayout(int row, QFormLayout::ItemRole role, QLayout *layout)

指定された「row 」内の、指定された「role 」に対するサブレイアウトを「layout 」に設定し、必要に応じてフォームのレイアウトを空の行で拡張します。

セルがすでに使用されている場合、layout は挿入されず、コンソールにエラーメッセージが出力されます。

注：ほとんどのアプリケーションでは、setLayout() の代わりにaddRow() またはinsertRow() を使用する必要があります。

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

[since 6.4] void QFormLayout::setRowVisible(int row, bool on)

on が真の場合、行row を表示し、そうでない場合はその行を非表示にします。

row 値は非負であり、かつrowCount() より小さくなければなりません。

この関数は Qt 6.4 で導入されました。

isRowVisible()、removeRow()、およびtakeRow()も参照してください 。

[since 6.4] void QFormLayout::setRowVisible(QLayout *layout, bool on)

on がtrueの場合、layout に対応する行を表示し、そうでない場合はその行を非表示にします。

この関数は Qt 6.4 で導入されました。

removeRow() およびtakeRow()も参照してください 。

[since 6.4] void QFormLayout::setRowVisible(QWidget *widget, bool on)

on がtrueの場合、widget に対応する行を表示し、そうでない場合はその行を非表示にします。

この関数は Qt 6.4 で導入されました。

removeRow() およびtakeRow()も参照してください 。

[override virtual] void QFormLayout::setSpacing(int spacing)

プロパティ「QLayout::spacing 」のアクセス関数を再実装します。

この関数は、垂直方向および水平方向の間隔の両方を `spacing` に設定します。

spacing()、setVerticalSpacing()、およびsetHorizontalSpacing()も参照してください 。

void QFormLayout::setWidget(int row, QFormLayout::ItemRole role, QWidget *widget)

指定されたrole に対して、指定されたrow 内のウィジェットをwidget に設定し、必要に応じてレイアウトを空の行で拡張します。

セルがすでに占有されている場合、widget は挿入されず、コンソールにエラーメッセージが出力されます。

注：ほとんどのアプリケーションでは、setWidget() の代わりにaddRow() またはinsertRow() を使用する必要があります。

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

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

QLayoutItem::sizeHint() const を再実装します。

[override virtual] int QFormLayout::spacing() const

プロパティ `QLayout::spacing` のアクセス関数を再実装します。

垂直方向の間隔が水平方向の間隔と等しい場合、この関数はその値を返します。それ以外の場合は -1 を返します。

setSpacing()、verticalSpacing()、およびhorizontalSpacing()も参照してください 。

[override virtual] QLayoutItem *QFormLayout::takeAt(int index)

QLayout::takeAt(int index) を再実装します。

QFormLayout::TakeRowResult QFormLayout::takeRow(int row)

このフォームレイアウトから、指定されたrow を削除します。

row 値は非負であり、かつrowCount() 未満でなければなりません。

この呼び出し後、rowCount() は 1 減算されます。それ以降のすべての行が 1 行分上にシフトされ、解放された縦方向のスペースは残りの行に再配分されます。

この関数を使用すると、以前に実行された `addRow()` または `insertRow()` を元に戻すことができます。

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(2);

レイアウトから行を削除し、ウィジェットも削除したい場合は、代わりに `removeRow()` を使用してください。

ウィジェットとそれに対応するラベルのレイアウト項目の両方を含む構造体を返します

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

QFormLayout::TakeRowResult QFormLayout::takeRow(QLayout *layout)

指定されたlayout をこのフォームレイアウトから削除します。

この呼び出し後、rowCount() の値が 1 減少します。それ以降のすべての行が 1 行分上にずらされ、空いた縦方向のスペースは残りの行に再配分されます。

QFormLayout *flay = ...;
QPointer<QVBoxLayout> vbl = new QVBoxLayout;
flay->insertRow(2, "User:", vbl);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(widget);

フォームレイアウトから行を削除し、挿入されたレイアウトを削除したい場合は、代わりにremoveRow() を使用してください。

戻り値 ウィジェットと対応するラベルのレイアウト項目の両方を含む構造体

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

QFormLayout::TakeRowResult QFormLayout::takeRow(QWidget *widget)

指定したwidget をこのフォームレイアウトから削除します。

この呼び出し後、rowCount() の値が 1 減算されます。それ以降のすべての行が 1 行分上にずらされ、解放された縦方向のスペースは残りの行に再配分されます。

QFormLayout *flay = ...;
QPointer<QLineEdit> le = new QLineEdit;
flay->insertRow(2, "User:", le);
// later:
QFormLayout::TakeRowResult result = flay->takeRow(widget);

レイアウトから行を削除し、ウィジェットも削除したい場合は、代わりに `removeRow()` を使用してください。

戻り値：ウィジェットとそれに対応するラベルのレイアウト項目の両方を含む構造体

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