HSP ver2 (Hot Soup Processor)

HSP : Hot Soup Processor ver2.61 / onion software 1997-2004(c)

objsend命令リファレンスマニュアル ver1.0

はじめに

objsend命令の概要

	objsend p1,p2,p3,p4,p5		オブジェクトにメッセージを送る

	p1=0～(0) : オブジェクトID指定 
	p2=0～(0) : オブジェクトに送るWin32メッセージの種類 
	p3=0～65535(0) : オブジェクトに送るパラメータ(wParam) 
	p4=変数 : パラメータの受け渡しに使用する変数名(lParam) 
	p5=0～(0) : lParamパラメータのタイプ

		メッセージコード
		パラメータ1(wParam)
		パラメータ2(lParam)
		       ↓
		指定したオブジェクト
		       ↓
		システム変数statに結果が返る

objsend命令の制約・注意

リファレンスの形式

win32name   Win32APIでの名称
Code        メッセージコード
wParam      パラメータ1
lParam      パラメータ2
Type        lParamタイプの値
Result      実行後に返される値

	「 objsend オブジェクトID , Code , wParam , lParam , Type 」

メッセージボックスへ送るメッセージ

win32name   EM_GETSEL
Code        $b0
wParam      0にする
lParam      現在位置を取得する変数
Type        0
Result      上位16bitに選択スタート位置、下位16bitに選択終了位置

説明
メッセージボックス内のカーソル(キャレット)の位置を取得します。カーソル位置は、全体のテキストの中で0から数えて何byte目(何文字目) かという単位で返されます。
```
win32name   EM_SETSEL
Code        $b1
wParam      選択スタート位置
lParam      選択終了位置
Type        1
Result      なし
```
説明
メッセージボックス内のカーソル(キャレット)の位置を設定します。選択スタートと、選択終了位置を指定すると、その範囲が反転して選択された状態になります。単にカーソル位置を移動したい場合は、選択スタートと終了位置に同じ値を指定します。指定する値は、EM_GETSELと同じく全体のテキストの中で0から数えて何byte目(何文字目)かという単位になります。このメッセージでカーソル位置を変更しても、ウインドゥ内の状態は変化しません。実際にカーソルが移動した場所に表示をずらすには EM_SCROLLCARETのメッセージを送る必要があります。
```
win32name   EM_LINESCROLL
Code        $b6
wParam      左右にスクロールさせる文字数
lParam      上下にスクロールさせる行数
Type        1
Result      なし
```
説明
メッセージボックス内の表示をスクロールさせます。 wParamで左右へのスクロール、lParamで上下のスクロールする数を指定します。スクロールの方向は、マイナスの値か、プラスの値かで決まります。
```
win32name   EM_SCROLLCARET
Code        $b7
wParam      0にする
lParam      0にする
Type        1
Result      なし
```

説明
現在カーソル(キャレット)がある位置を画面内にもってくるようにする。

win32name   EM_LINEINDEX
Code        $bb
wParam      行の指定
lParam      0にする
Type        1
Result      ポジション

説明
wParamで指定した行を、全体のテキストの中で0から数えて何byte目(何文字目)かという単位に変換して値を返す。行の指定は、一番上の行は0から始まって何番目かという単位で指定する。
```
win32name   EM_LINELENGTH
Code        $c1
wParam      行の指定
lParam      0にする
Type        1
Result      指定された行の長さ
```

説明
wParamで指定した行インデックス(0から始まる)にある文字(byte)数を返す。

win32name   EM_UNDO
Code        $c7
wParam      0にする
lParam      0にする
Type        1
Result      なし

説明
UNDOをする。前に行なったカットやペースト、入力などを1回戻す。

win32name   EM_LINEFROMCHAR
Code        $c9
wParam      ポジション
lParam      0にする
Type        1
Result      行インデックス

説明
wParamで指定したポジション(テキスト全体の何byte目か)を、行インデックスに変換して値を返す。

win32name   EM_SETREADONLY
Code        $cf
wParam      -1で書き込み禁止、0で解除
lParam      0にする
Type        1
Result      正常に終了すると0以外が返る

説明
メッセージボックスの書き込み禁止属性の設定をする。 wParamで書き込み禁止のon/offを指定します。

win32name   EM_SETMARGINS
Code        $d3
wParam      3にする
lParam      上位16bitで右マージン、下位16bitで左マージン設定
Type        1
Result      なし

説明
メッセージボックスの左マージンおよび右マージンの設定をする。 (現在のHSPのバージョンでは、マージンの設定をすると文字がウインドゥからはみ出ます)
```
win32name   EM_GETMARGINS
Code        $d4
wParam      0にする
lParam      0にする
Type        1
Result      上位16bitに右マージン、下位16bitに左マージンが返る
```

説明
EM_SETMARGINSで設定したマージンの値を調べて返す。

win32name   EM_SETLIMITTEXT
Code        $c5
wParam      テキストのリミット指定
lParam      0にする
Type        1
Result      なし

説明
メッセージボックスが扱うことができるテキスト量の限界を設定する。 wParamで何byteまでのテキストを扱うかを指定する。wParamに0を指定すると、そのOSでの最大サイズが割り当てられる。 (Windows95では、最大65535までのテキストしか扱うことができません)
```
win32name   EM_GETLIMITTEXT
Code        $d5
wParam      0にする
lParam      0にする
Type        1
Result      テキストのリミット値
```
説明
EM_SETLIMITTEXTで指定したテキスト量の限界値を調べて返す。

ボタンへ送るメッセージ

win32name   BM_GETCHECK
Code        $f0
wParam      0にする
lParam      0にする
Type        1
Result      ボタンのチェックステータス

説明
チェックボックスのON/OFFステータスを返します。チェックされていれば１が、されていなければ０が返ります。 3STATEのチェックボックスで、非表示(グレイ)であれば２が返ります。
```
win32name   BM_SETCHECK
Code        $f1
wParam      チェックステータス
lParam      0にする
Type        1
Result      なし
```
説明
チェックボックスのON/OFFステータスを強制的に設定します。 wParamに設定値を指定します。０ならOFF、１ならばONになります。 3STATEのチェックボックスで、非表示(グレイ)にするには２を指定します。
```
win32name   BM_SETSTYLE
Code        $f4
wParam      スタイル設定
lParam      -1にする
Type        1
Result      なし
```
説明
ボタンのスタイルを変更します。wParamで変更するスタイルを指定します。
```
win32name          wParam     スタイル
----------------------------------------------------------------------
BS_PUSHBUTTON       $00       通常のボタン
BS_DEFPUSHBUTTON    $01       デフォルトボタン(枠が太い)
BS_CHECKBOX         $02       チェックボックス
BS_AUTOCHECKBOX     $03       チェックボックス(auto)
BS_RADIOBUTTON      $04       ラジオボタン
BS_3STATE           $05       ３ステートチェックボックス
BS_AUTO3STATE       $06       ３ステートチェックボックス(auto)
BS_GROUPBOX         $07       グループボックス
BS_AUTORADIOBUTTON  $09       ラジオボタン(auto)
BS_OWNERDRAW        $0b       非描画ボタン
```
button命令は通常、ボタンが押されると指定されたラベルにジャンプします。 BM_SETSTYLEによってボタンスタイルが変更されても基本的には、同じ動作をします。ただし、BS_GROUPBOXはボタンとして機能しなくなります。
それ以外のチェックボックスやラジオボタンは、ON/OFFのためにクリックした時点でラベルにジャンプします。その際、(auto)がついているスタイルの場合は自動的にチェックのON/OFFを行ないます。(auto)がないスタイルでは、ジャンプした先でON/OFFをさせる処理を自前で行なう必要があります。
ラジオボタンは、２つ以上の選択ボックスから１つだけをチェックするためのオブジェクトです。これは、(auto)であっても選択したラジオボタンがONになるだけなので、他の選択肢をOFFにする処理はスクリプト側で行ないます。
BS_OWNERDRAW(非描画ボタン)は、ボタンとしては絵が描かれませんが、そのエリアでボタンをクリックすれば反応します。このスタイルに変更した後で、上から好きな絵(ボタンの絵など)を描画して使うことができます。

[Back]