Maplets[Elements][BoxRow] - ボックスレイアウト内の行の指定
使い方
BoxRow(opts, element_content)
パラメータ
opts - option=value の形の等式; ここで、option は background, border, caption, font, halign, hscroll, inset, spacing, valign, visible, vscroll のいずれか; BoxRow 要素のためのオプション指定
element_content - 任意の数の BoxCell, BoxColumn または BoxRow 要素
|
説明
|
|
•
|
BoxRow レイアウト要素は、ボックスレイアウト内の行を指定します。
|
•
|
BoxRow は、ボックスレイアウト内の水平方向の制御に使用します。
|
•
|
BoxRow 要素の特徴は、オプションを用いて修正が可能です。Maplets パッケージでのオプション指定を簡単にするために、等式を用いることなしにあるオプションと内容を設定することが可能です。次の表では、(左側の列に) 要素、記号、および型、そして (右側の列に) 型がデフォルトで割り当てられると入力を行う、対応するオプションまたは内容を一覧表示します。
|
Elements, Symbols, or Types Assumed Option or Content
always, as_needed, or never hscroll and vscroll options
left or right halign option
top or bottom valign option
•
|
BoxRow 要素は、任意の数の BoxCell, BoxColumn または BoxRow 要素を含むことが可能です。
|
•
|
BoxRow 要素は、BoxColumn, BoxLayout または BoxRow 要素の中に、含めることが可能です。
|
•
|
次の表に、BoxRow 要素のオプションの、制御および使用法について記述します。
|
|
I 列の x は、(要素の定義を行う) 呼び出し手順で指定される、初期化が可能なオプションを示す。
|
|
R 列の x は、呼び出し手順で必要となるオプションを示す。
|
|
G 列の x は、オプションが Get ツールを用いて取得できる、すなわち読み込み可能であることを示す。
|
|
S 列の x は、 SetOption 要素あるいは Set ツールを用いて設定される、書き出し可能なオプションを示す。
|
Option I R G S
background x
border x
caption x
font x
halign x
hscroll x
inset x
spacing x
valign x
visible x
vscroll x
•
|
opts 引数は、Maplet のオプションを設定する、1 つまたは複数の以下の等式を含みます。
|
|
ボックス行をハイライト表示する色。色の名前、RGBの色構造、または "#RRGGBB" という形の文字列(ここで各文字の組は 2 桁の 16 進数) を、認識することができます。
|
|
ボックスがボーダーを持つかどうかの指定。デフォルトの値は、false です。
|
|
ボックス行の上に現れるテキスト。表題は、オプション border が true に設定されている場合にのみ、見えるようになります。
|
|
font = Font 要素、または、Font 要素に対する参照 (name または string)
|
|
halign = left, center, right, または none
|
|
行の内容の、水平方向の配置。 デフォルトの値は、center です。
|
|
ボックス列内の要素の水平方向の整列は、HorizontalGlue スペース要素の追加により行われます。: left による整列は、その要素の後に、HorizontalGlue を加えることにより得られます。right による列は、その要素の前に HorizontalGlue を加えることにより得られます。center による整列は、その要素の前後両方に HorizontalGlue を加えることにより得られます。none を選択することにより、すべてのHorizontalGlue 要素をマニュアルで指定することができ、より微細な制御が可能になります (詳細は、examples/AdvancedMapletsLayout を参照)。
|
|
hscroll = never, as_needed, または always
|
|
このオプションは、水平方向のスクロールバーをボックス行内に表示するタイミングを決定します。デフォルトの値は、never です。
|
|
ボックス行内の要素を囲む隙間の量。デフォルトで挿入される隙間は、5 ピクセルです。
|
|
ボックス行内の個々の要素を区切る隙間の量。デフォルトで挿入される隙間は、5 ピクセルです。
|
|
valign = top, center, または bottom
|
|
行内に含まれる各 BoxColumn レイアウトオブジェクト に対して、デフォルトの 垂直方向の配置を指定します。デフォルトの値は、center です。none オプションにより、VerticalGlue と組み合わせて使用される場合、コンテンツの整列をより微細に制御することができます。(詳細は、BoxColumn を参照)。
|
|
注意: valign オプションは、ボックス行内のオブジェクトに直接的には影響しませんが、指定された valign の値は、それが含む各 BoxColumn 要素に対するデフォルトの垂直方向の配置として継承されます。
|
|
ユーザが見ることのできるボックスかどうかの設定。デフォルトの値は、true です。
|
|
vscroll = never, as_needed, または always
|
|
このオプションは、垂直方向のスクロールバーをボックス行内に表示するタイミングを決定します。デフォルトの値は、never です。
|
|
|
例
|
|
>
|
with(Maplets[Elements]):
maplet := Maplet(
Window('layout' = 'BL1'),
BoxLayout['BL1'](
BoxColumn(
BoxRow("Enter text:", TextField['TF1']()),
Button("OK", Shutdown(['TF1']))
)
)
):
Maplets[Display](maplet);
|
この Maplet は以下の例と同じになります:
>
|
maplet := Maplet([
["Enter text:", TextField['TF1']()],
Button("OK", Shutdown(['TF1']))
]):
Maplets[Display](maplet);
|
HorizontalGlue を使用してマニュアルで取り扱われる配置をもつボタンの行。
>
|
maplet := Maplet(
BoxLayout(
BoxColumn(
BoxRow(
Label("This is a long line of text to force usage of the alignment for the buttons below")
),
BoxRow('halign'='none',
Button("Left", Shutdown([])),
Button("NxtLeft", Shutdown([])),
HorizontalGlue(),
Button("Mid", Shutdown([])),
HorizontalGlue(),
Button("Right", Shutdown([]))
)
)
)
):
Maplets[Display](maplet);
|
|
|
参照
|
|
examples/AdvancedMapletsLayout, Maplets, Maplets[Display], Maplets[Elements], Maplets[Elements][BoxCell], Maplets[Elements][BoxColumn], Maplets[Elements][BoxLayout], Maplets[Elements][Button], Maplets[Elements][Font], Maplets[Elements][HorizontalGlue], Maplets[Elements][Maplet], Maplets[Elements][SetOption], Maplets[Elements][Shutdown], Maplets[Elements][TextField], Maplets[Elements][VerticalGlue], Maplets[Elements][Window], Maplets/LayoutElements, Maplets[Tools][Get], Maplets[Tools][Set], plot[color]
|
|