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 に対応する行の項目が表示されている場合は真を返し、そうでない場合は偽を返します。

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

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

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

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

この関数は 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 （列）に対応する、指定された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 が true の場合は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 が真であれば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()も参照してください 。