VerticalScrollbar

垂直スクロールバー (VerticalScrollbar) は、Windowsスタイルのスクロールバーを提供します。このウィンドウ要素は、自動的に他のいくつかのウィンドウコンポーネントを組み合わせたものです。

Summary

VerticalScrollbar	垂直スクロールバー (VerticalScrollbar) は、Windowsスタイルのスクロールバーを提供します。このウィンドウ要素は、自動的に他のいくつかのウィンドウコンポーネントを組み合わせたものです。
実装の詳細	垂直スクロールバーはスクロールバー機能を自動化する複合ウィンドウ要素です。スクロールバーは独立して使用することもできますが、 ListBox 、 ScrollWindow 、または LogDisplay などの他のスクロールウィンドウのコンポーネントとして使われることが大半です。
XML定義
XMLタグ
必須属性
up	UPボタンに使用されるボタン定義の名前。
down	DOWNボタンに使用するボタン定義の名前。
thumb	可変スクロールバーサムに使用する垂直リサイズイメージの名前。
gutter	スクロールエリアの背景に使用する垂直リサイズイメージの名前。
任意属性
UpOffset	スクロールバーウインドウ上部からのUPボタンのオフセット。
DownOffset	DOWNボタン用のスクロールバー左下角からのオフセット。
ThumbOffset	スクロールバーウィンドウの左上からのサム（つまみ）のオフセット。
ActiveZoneOffset	アクティブゾーンはスクロールバーの範囲外のエリアですが、（範囲内エリアでドラッグを始めた）スクロールバーをクリックしたままドラッグし続けられる部分です。
ウィンドウコールバック
コールバック
OnScrollPosChanged	スクロール位置が変化した時に呼び出されます。
関数
関数
VerticalScrollbarSetScrollPosition()	現在のスクロール位置を設定します。
VerticalScrollbarGetScrollPosition()	現在のスクロール位置を返します。
VerticalScrollbarSetMaxScrollPosition()	最大スクロール位置を設定します。
VerticalScrollbarGetMaxScrollPosition()	最大スクロール位置を返します。
VerticalScrollbarSetPageSize()	ページサイズを設定します。
VerticalScrollbarGetPageSize()	ページサイズを返します。
VerticalScrollbarSetLineSize()	ラインサイズを設定します。
VerticalScrollbarGetLineSize()	ラインサイズを返します。

実装の詳細

垂直スクロールバーはスクロールバー機能を自動化する複合ウィンドウ要素です。スクロールバーは独立して使用することもできますが、 ListBox 、 ScrollWindow 、または LogDisplay などの他のスクロールウィンドウのコンポーネントとして使われることが大半です。

コンポーネント

UP矢印用の Button 定義。
DOWN矢印用の Button 定義。
スクロールバー背景用の VerticalResizeImage 。
スクロールサム用の VerticalResizeImage 。

スクロールバーのサイズが決まると、それに合うように背景画像のサイズも変更されます。他のウィンドウ要素の一部として使用された場合、スクロールバーサムは自動的にサイズと位置を変更して親ウィンドウのデータを反映します。

Luaを通じて自作のスクロールバーを使用する場合、用いるデータに従って以下の値を設定する必要があります

lineSize	単体ラインの縦幅。 ( VerticalScrollbarSetLineSize() と VerticalScrollbarGetLineSize() を使用します)
pageSize	ページ全体の縦幅。 ( VerticalScrollbarSetPageSize() と VerticalScrollbarGetPageSize() を使用します)
maxScroll	スクロール範囲の最大値。 ( VerticalScrollbarSetMaxScrollPosition() と VerticalScrollbarGetMaxScrollPosition() を使用します)

XML定義

Summary

XMLタグ
必須属性
up	UPボタンに使用されるボタン定義の名前。
down	DOWNボタンに使用するボタン定義の名前。
thumb	可変スクロールバーサムに使用する垂直リサイズイメージの名前。
gutter	スクロールエリアの背景に使用する垂直リサイズイメージの名前。
任意属性
UpOffset	スクロールバーウインドウ上部からのUPボタンのオフセット。
DownOffset	DOWNボタン用のスクロールバー左下角からのオフセット。
ThumbOffset	スクロールバーウィンドウの左上からのサム（つまみ）のオフセット。
ActiveZoneOffset	アクティブゾーンはスクロールバーの範囲外のエリアですが、（範囲内エリアでドラッグを始めた）スクロールバーをクリックしたままドラッグし続けられる部分です。

XMLタグ

<VerticalScrollbar>
....
</VerticalScrollbar>

代替グループ

Window

必須属性

up

UPボタンに使用されるボタン定義の名前。

データ型

string

有効な Button の名前。

デフォルト値

””

down

DOWNボタンに使用するボタン定義の名前。

データ型

string

有効な Button の名前。

デフォルト値

””

thumb

可変スクロールバーサムに使用する垂直リサイズイメージの名前。

データ型

string

有効な VerticalResizeImage の名前。

デフォルト値

””

gutter

スクロールエリアの背景に使用する垂直リサイズイメージの名前。

データ型

string

有効な VerticalResizeImage の名前。

デフォルト値

””

任意属性

UpOffset

スクロールバーウインドウ上部からのUPボタンのオフセット。

構文

<UpOffset x="2" y="0" />

x	ウインドウ左上角からのXピクセルオフセット。
y	ウインドウ左上角からのYピクセルオフセット。

デフォルト値

x	0
y	0

DownOffset

DOWNボタン用のスクロールバー左下角からのオフセット。

構文

<DownOffset x="2" y="0" />

x	ウインドウ左下角からのXピクセルオフセット。
y	ウインドウ左上角からのYピクセルオフセット。

デフォルト値

x	0
y	0

ThumbOffset

スクロールバーウィンドウの左上からのサム（つまみ）のオフセット。

構文

<ThumbOffset x="2" y="0" />

x	ウインドウ左上角からのXピクセルオフセット。
y	ウインドウ左上角からのYピクセルオフセット。

デフォルト値

x	0
y	0

ActiveZoneOffset

アクティブゾーンはスクロールバーの範囲外のエリアですが、（範囲内エリアでドラッグを始めた）スクロールバーをクリックしたままドラッグし続けられる部分です。

Windowsはスクロールバーの両脇におよそ100ピクセルのアクティブゾーンを持っているようです。

構文

<ActiveZoneOffset x="100" y="0" />

x	スクロールバーの両側からのXピクセル距離。
y	スクロールバーの両側からのYピクセル距離。

デフォルト値

x	0
y	0

ウィンドウコールバック

Summary

コールバック
OnScrollPosChanged	スクロール位置が変化した時に呼び出されます。

コールバック

OnScrollPosChanged

スクロール位置が変化した時に呼び出されます。

構文

SomeVerticalScrollBar.OnScrollPosChanged( scrollPos )

scrollPos

(integer) 現在のスクロール位置 (1からスクロールサイズ／ページサイズまで)。

関数

Summary

関数
VerticalScrollbarSetScrollPosition()	現在のスクロール位置を設定します。
VerticalScrollbarGetScrollPosition()	現在のスクロール位置を返します。
VerticalScrollbarSetMaxScrollPosition()	最大スクロール位置を設定します。
VerticalScrollbarGetMaxScrollPosition()	最大スクロール位置を返します。
VerticalScrollbarSetPageSize()	ページサイズを設定します。
VerticalScrollbarGetPageSize()	ページサイズを返します。
VerticalScrollbarSetLineSize()	ラインサイズを設定します。
VerticalScrollbarGetLineSize()	ラインサイズを返します。

関数