(87) Small Basic v0.9～ API リファレンス : Controls
Controls オブジェクトは、テキストボックスやボタンなどのウィンドウの基本的なコントロールを、グラフィックウィンドウに追加します。
追加したコントロールは、ウィンドウ内で移動させたり操作やデータの読み書きができます。。
AddButton
オペレーション : AddButton ( caption , left , top )
グラフィックウィンドウにボタンコントロールを追加します。
表示座標が ( 0 , 0 ) 固定で幅・高さを指定してグラフィックウィンドウに追加する Shapes オブジェクトとは異なり、AddButton オペレーションではコントロールの左上座標を指定します。
幅・高さの初期値は、中に表示される文字列のフォントサイズと横幅によって自動的に決定されます。
| caption | 文字列 | ボタンコントロールに表示する文字列。 |
| left | 数値 | ボタンコントロールの横位置(X座標)。 |
| top | 数値 | ボタンコントロールの縦位置(Y座標)。 |
| 戻り値 | グラフィックウィンドウに追加したボタンコントロールの名前(自動的に命名されます)。 この名前を変数に受けておくと、後でそのコントロールの操作ができます。 |
|
| 対応バージョン | v0.9～ | |
AddMultiLineTextBox
オペレーション : AddMultiLineTextBox ( left , top )
グラフィックウィンドウに複数行の入力ができるテキストボックスコントロールを追加します。
表示座標が ( 0 , 0 ) 固定で幅・高さを指定してグラフィックウィンドウに追加する Shapes オブジェクトとは異なり、AddMultiLineTextBox オペレーションではコントロールの左上座標を指定します。
幅・高さの初期値は自動的に決定されます。
プログラムの実行中、Enter キーで入力文字列を改行させることができます。表示しきれない行数になると、自動的に縦方向のスクロールバーが表示されます。
| left | 数値 | テキストボックスコントロールの横位置(X座標)。 |
| top | 数値 | テキストボックスコントロールの縦位置(Y座標)。 |
| 戻り値 | グラフィックウィンドウに追加したテキストボックスコントロールの名前(自動的に命名されます)。 この名前を変数に受けておくと、後でそのコントロールの操作ができます。 |
|
| 対応バージョン | v0.9～ | |
AddTextBox
オペレーション : AddTextBox ( left , top )
グラフィックウィンドウに 1 行だけ入力ができるテキストボックスコントロールを追加します。
表示座標が ( 0 , 0 ) 固定で幅・高さを指定してグラフィックウィンドウに追加する Shapes オブジェクトとは異なり、AddTextBox オペレーションではコントロールの左上座標を指定します。
幅・高さの初期値は自動的に決定されます。
プログラムの実行中、表示しきれない文字数になると、カーソルに合わせて文字列全体が移動します。
| left | 数値 | テキストボックスコントロールの横位置(X座標)。 |
| top | 数値 | テキストボックスコントロールの縦位置(Y座標)。 |
| 戻り値 | グラフィックウィンドウに追加したテキストボックスコントロールの名前(自動的に命名されます)。 この名前を変数に受けておくと、後でそのコントロールの操作ができます。 |
|
| 対応バージョン | v0.9～ | |
ButtonClicked
イベント : ButtonClicked
ボタンコントロールをクリックした時に実行するサブルーチンを設定します。
| 対応バージョン | v0.9～ |
GetButtonCaption
オペレーション : GetButtonCaption ( buttonName )
指定したボタンコントロールに表示されている文字列を取得します。
| buttonName | 文字列 | 文字列を取得するボタンコントロールの名前。 |
| 戻り値 | 指定したボタンコントロールに表示されている文字列。 | |
| 対応バージョン | v0.9～ | |
GetTextBoxText
オペレーション : GetTextBoxText ( textBoxName )
指定したテキストボックスコントロールに入力されている文字列を取得します。
| textBoxName | 文字列 | 文字列を取得するテキストボックスコントロールの名前。 |
| 戻り値 | 指定したテキストボックスコントロールに入力されている文字列。 | |
| 対応バージョン | v0.9～ | |
オペレーション : HideControl ( controlName )
指定したコントロールを非表示にします。
| controlName | 文字列 | 非表示にするコントロールの名前。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.9～ | |
LastClickedButton
プロパティ : LastClickedButton
最後にクリックされたボタンコントロールの名前を取得します。
| 文字列 | 最後にクリックされたボタンコントロールの名前。 |
| 対応バージョン | v0.9～ |
LastTypedTextBox
プロパティ : LastTypedTextBox
最後に文字が入力されたテキストボックスコントロールの名前を取得します。
| 文字列 | 最後に文字が入力されたテキストボックスコントロールの名前。 |
| 対応バージョン | v0.9～ |
Move
オペレーション : Move ( control , x , y )
指定したコントロールを新しい位置に移動します。
| control | 文字列 | 移動するコントロールの名前。 |
| x | 数値 | 移動先の横位置(X座標)。 |
| y | 数値 | 移動先の縦位置(Y座標)。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.9～ | |
Remove
オペレーション : Remove ( control )
指定したコントロールをグラフィックウィンドウから削除します。
| control | 文字列 | 削除するコントロールの名前。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.9～ | |
SetButtonCaption
オペレーション : SetButtonCaption ( buttonName , caption )
指定したボタンコントロールに表示する文字列を設定します。
| buttonName | 文字列 | 表示する文字列を指定するボタンコントロールの名前。 |
| caption | 文字列 | ボタンコントロールに表示する文字列。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.9～ | |
SetSize
オペレーション : SetSize ( control , width , height )
指定したコントロールの幅・高さを設定します。
| control | 文字列 | 幅・高さを設定するコントロールの名前。 |
| width | 数値 | コントロールの幅。 |
| height | 数値 | コントロールの高さ。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.9～ | |
SetTextBoxText
オペレーション : SetTextBoxText ( textBoxName , text )
指定したテキストボックスコントロールに表示する文字列を設定します。
| textBoxName | 文字列 | 表示する文字列を指定するテキストボックスコントロールの名前。 |
| text | 文字列 | テキストボックスコントロールに表示する文字列。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.9～ | |
ShowControl
オペレーション : ShowControl ( controlName )
指定したコントロールを表示します。
| controlName | 文字列 | 表示するコントロールの名前。 |
| 戻り値 | (なし) | |
| 対応バージョン | v0.9～ | |
TextTyped
イベント : TextTyped
テキストボックスコントロールに文字を入力した時に実行するサブルーチンを設定します。
| 対応バージョン | v0.9～ |