PPGLayout.AddGroup operator

導入

v4.0

詳細

グループをレイアウトに追加します。グループを使用すると、関連のある複数の項目の周囲にボックスを描画したり、コントロールを列に並べたりできます。グループはネストすることが可能です。

レイアウトでは、グループは 2 つの特別な PPGItem オブジェクトを用いて表されます。片方のオブジェクトはグループの先頭を、もう片方のオブジェクトはグループの末尾を表します。したがって、グループのラベルを変更する場合は、PPGItem を列挙してグループの先頭に関連付けられている項目を探し、PPGItem.Label プロパティを修正します。

C#構文

PPGItem PPGLayout.AddGroup( String in_opt_Label, Boolean in_opt_ShowFrame, Int32 in_opt_width );

スクリプト構文

oReturn = PPGLayout.AddGroup( [Label], [ShowFrame], [WidthPercentage] );

戻り値

PPGItem

パラメータ

パラメータ タイプ 説明
Label String 指定された場合、ラベルは表示され、フレームはグループの周りに描画されます。
ShowFrame Boolean コントロールの項目の周囲にフレームを描画するかどうかを決定するフラグ。ラベルが指定されている場合はフレームは常に描画されます(siPPGItemAttribute の SiUIShowFrame を参照)。

デフォルト値:true

WidthPercentage Long このパラメータは、グループが 1 つの行内にある場合にのみ使用できます。このグループで使用する水平方向のスペースの大きさを指定します。指定しない場合は、Softimage独自のヒューリスティックを使用してグループのレイアウトが決定します。たとえば、1 つ目のグループと比べて2 つ目のグループのコントロールの幅が大きい場合は、2 つのグループのスペースを均等にせずに、30%と70%の割合で分割する方が見栄えがよくなります。

関連項目

PPGLayout.EndGroup PPGItem.Label PPGItem.WidthPercentage siPPGItemAttribute