QFormLayout Class

メンバ関数ドキュメント

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

与えられたparent ウィジェットで新しいフォームレイアウトを構築します。

レイアウトはparent のトップレベルレイアウトとして直接設定されます。1つのウィジェットのトップ・レベル・レイアウトは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)

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

このオーバーロードは、labelText をテキストとするQLabel を裏で自動的に作成します。

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

指定されたrole (column) を持つ、指定されたrow 内のレイアウト項目を返します。そのような項目がない場合は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)

与えられたrole に対する与えられたrow のサブレイアウトを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 が真の場合、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()も参照してください 。