QSplitter Class

メンバ関数ドキュメント

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

QFrame コンストラクタに渡されたparent 引数で水平スプリッタを構築します。

setOrientation()も参照 。

[explicit] QSplitter::QSplitter(Qt::Orientation orientation, QWidget *parent = nullptr)

与えられたorientation とparent でスプリッタを構築します。

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

[virtual noexcept] QSplitter::~QSplitter()

スプリッタを破壊する。すべての子が削除される。

void QSplitter::addWidget(QWidget *widget)

指定 さ れたwidget を、 ス プ リ ッ タ の レ イ ア ウ ト に、 他のすべての項目の後に追加 し ます。

widget がすでにスプリッタ内にある場合は、新しい位置に移動されます。

insertWidget(),widget(),indexOf()も参照 。

[override virtual protected] void QSplitter::changeEvent(QEvent *ev)

再インプリメント：QFrame::changeEvent(QEvent *ev).

[override virtual protected] void QSplitter::childEvent(QChildEvent *c)

再実装：QObject::childEvent(QChildEvent *event)。

c で記述された子ウィジェットが挿入または削除されたことをスプリッタに伝えます。

このメソッドは、スプリッタを親としてウィジェットが作成されたが、insertWidget() やaddWidget() で明示的に追加されなかった場合の処理にも使用されます。これは互換性のためであり、新しいコードでスプリッタにウィジェットを追加する推奨の方法ではありません。新しいコードでは、insertWidget() またはaddWidget() を使用してください。

addWidget() およびinsertWidget()も参照して ください。

[protected] int QSplitter::closestLegalPosition(int pos, int index)

index のウィジェットのpos に最も近い法的位置を返します。

アラビア語やヘブライ語のような右から左への言語では、水平スプリッタのレイアウトは逆になります。その場合、位置はウィジェットの右端から計測されます。

getRange()も参照 。

int QSplitter::count() const

スプリッタのレイアウトに含まれるウィジェットの数を返します。

widget() およびhandle()も参照 ください。

[virtual protected] QSplitterHandle *QSplitter::createHandle()

このスプリッタの子ウィジェットとして新しいスプリッタハンドルを返します。この関数は、カスタムハンドルのサポートを提供するためにサブクラスで再実装することができます。

handle() およびindexOf()も参照して ください。

[override virtual protected] bool QSplitter::event(QEvent *e)

再インプリメント：QFrame::event(QEvent *e).

void QSplitter::getRange(int index, int *min, int *max) const

min とmax が 0 でない場合、*min と *max のindex におけるスプリッタの有効範囲を返す。

QSplitterHandle *QSplitter::handle(int index) const

ス プ リ ッ タ の レ イ ア ウ ト 内で、 与えられたindex にある項目の左 （または上） のハン ドルを返 し 、 その よ う な項目がない と きはnullptr を返 し ます。インデックス 0 のハンドルは常に非表示です。

アラビア語やヘブライ語のような右から左への言語の場合、 水平スプリッタのレイアウトは逆になります。ハンドルはindex のウィジェットの右側になります。

count(),widget(),indexOf(),createHandle(),setHandleWidth()も参照のこと 。

int QSplitter::indexOf(QWidget *widget) const

指定されたwidget のスプリッタのレイアウト内のインデックスを返します。widget が見つからない場合は -1 を返します。これはハンドルに対しても動作します。

子ウィジェットの数だけハンドルがありますが、位置 0 のハンドルは常に非表示になります。

count() およびwidget()も参照のこと 。

void QSplitter::insertWidget(int index, QWidget *widget)

指定 さ れたwidget を、 ス プ リ ッ タ の レ イ ア ウ ト に、 与えられたindex に挿入 し ます。

widget がすでにスプリッタ内にある場合は、新しい位置に移動されます。

index が無効なインデックスの場合、ウィジェットは最後に挿入されます。

addWidget()、indexOf()、widget()も参照のこと 。

bool QSplitter::isCollapsible(int index) const

index のウィジェットが折りたたみ可能であればtrue を返し、そうでなければfalse を返す。

[override virtual] QSize QSplitter::minimumSizeHint() const

QWidget::minimumSizeHint 。

[protected] void QSplitter::moveSplitter(int pos, int index)

index にあるスプリッタハンドルの左端または上端を、 ウィジェットの左端または上端からの距離である位置pos にできるだけ近づける。

アラビア語やヘブライ語のような右から左への言語の場合、水平スプリッタのレイアウトは逆になります。その場合、pos はウィジェットの右端からの距離になります。

splitterMoved(),closestLegalPosition(),getRange()も参照のこと 。

void QSplitter::refresh()

スプリッターの状態を更新する。この関数を呼び出す必要はありません。

QWidget *QSplitter::replaceWidget(int index, QWidget *widget)

与えられたindex にあるスプリッタのレイアウトのウィジェットをwidget で置き換えます。

index が有効でwidget がまだスプリッタの子でない場合、置き換えられたウィジェットを返します。そうでない場合は null を返し、置き換えや追加は行われません。

新しく挿入されたウィジェットのジオメトリは、置き換えられたウィジェットと同じになります。その可視状態と折りたたみ状態も継承されます。

insertWidget() とindexOf()も参照してください 。

[override virtual protected] void QSplitter::resizeEvent(QResizeEvent *)

再実装：QWidget::resizeEvent(QResizeEvent *event)。

bool QSplitter::restoreState(const QByteArray &state)

ス プ リ ッ タ の レ イ ア ウ ト を、 指定 し たstate に戻 し ます。状態が復元された場合はtrue を返し、そうでない場合はfalse を返します。

通常、これはQSettings と組み合わせて、過去のセッションのサイズを復元するために使われます。以下はその例です：

スプリッタの状態を復元する：

    QSettings settings;
    splitter->restoreState(settings.value("splitterSizes").toByteArray());

スプリッタの状態を復元する: スプリッタのレイアウトの復元に失敗した場合、 与えられたバイト配列のデータが無効であったり、古かったりすることが 原因である可能性があります。

saveState()も参照 。

QByteArray QSplitter::saveState() const

スプリッタのレイアウトの状態を保存する。

通常これはQSettings と組み合わせて、 将来のセッションのためにサイズを覚えておくために使われます。バージョン番号がデータの一部として保存されます。以下に例を示す：

    QSettings settings;
    settings.setValue("splitterSizes", splitter->saveState());

restoreState()も参照 。

void QSplitter::setCollapsible(int index, bool collapse)

index の子ウィジェットが折りたたみ可能かどうかをcollapse に設定します。

デフォルトでは、子ウィジェットは折りたたみ可能です。つまり、minimumSize() やminimumSizeHint() がゼロでなくても、ユーザは子ウィジェットのサイズを 0 に変更できます。この動作は、この関数を呼び出すことでウィジェットごとに変更することができます。また、childrenCollapsible プロパティを設定することで、スプリッタ内のすべてのウィジェットに対してグローバルに変更することもできます。

isCollapsible() およびchildrenCollapsibleも参照してください 。

[protected] void QSplitter::setRubberBand(int pos)

pos の位置に輪ゴムを表示する。pos が負の場合、輪ゴムは外される。

void QSplitter::setSizes(const QList<int> &list)

子ウィジェットのそれぞれのサイズをlist で与えられた値に設定します。

スプリッタが水平の場合、値は各ウィジェットの幅をピクセル単位で左から右に設定します。スプリッタが垂直の場合は、各ウィジェットの高さを上から下へ設定します。

list の余分な値は無視される。list に含まれる値が少なすぎる場合、結果は未定義になるが、それでもプログラムはうまく動作する。

スプリッターウィジェットの全体的なサイズは影響を受けません。その代わり、追加/不足スペースは、サイズの相対的な重みに従って、ウィジェット間で分配される。

0を指定すると、ウィジェットは見えなくなります。ウィジェットのサイズ・ポリシーは保持されます。つまり、それぞれのウィジェットの最小サイズのヒントより小さい値は、ヒントの値で置き換えられます。

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

void QSplitter::setStretchFactor(int index, int stretch)

位置index にあるウィジェットのサイズポリシーを更新し、stretch のストレッチファクターを持つようにする。

stretch 有効ストレッチファクターは、ウィジェットの初期サイズを取得し、それに を乗算することによって計算されます。stretch

この関数は便宜上提供されています。と等価です。

QWidget *widget = splitter->widget(index);
QSizePolicy policy = widget->sizePolicy();
policy.setHorizontalStretch(stretch);
policy.setVerticalStretch(stretch);
widget->setSizePolicy(policy);

setSizes() およびwidget()も参照してください 。

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

再実装：QFrame::sizeHint() const.

QList<int> QSplitter::sizes() const

このスプリッタのすべてのウィジェットのサイズパラメータのリストを返します。

スプリッタの向きが横向きの場合、リストには左から右へのウィジェットの幅がピクセル単位で含まれ、向きが縦向きの場合、リストには上から下へのウィジェットの高さがピクセル単位で含まれます。

この値を他のスプリッタのsetSizes() 関数に渡すと、このスプリッタと同じレイアウトのスプリッタが生成されます。

不可視ウィジェットのサイズは 0 であることに注意してください。

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

[signal] void QSplitter::splitterMoved(int pos, int index)

このシグナルは、特定のindex にあるスプリッタハンドルがpos の位置に移動したときに発せられる。

アラビア語やヘブライ語のような右から左への言語では、水平スプリッタのレイアウトは逆になります。pos は、ウィジェットの右端からの距離になります。

moveSplitter()も参照 。

QWidget *QSplitter::widget(int index) const

スプリッタのレイアウトで指定されたindex にあるウィジェット、 またはそのようなウィジェットがない場合はnullptr を返します。

count(),handle(),indexOf(),insertWidget()も参照 。