|目次|前ページ|次ページ| ───────────────────────────────────── 44.バリューリストエディタ(TValueListEditor)の使い方 ───────────────────────────────────── [1]バリューリストエディタ(TValueListEditor)オブジェクトの作成 →共通ルーチン【ZVCMVLS】【ZVCMVLS2】【ZVCMVLS3】 ───────────────────────────────────── TValueListEditorクラスを使うとユーザーはName=Valueという形式の文字列から 構成される文字列リストを編集できるようになります。 デフォルトでは,「Key」という見出しの列に名前が, 「Value」という見出しの列に値が表示されます。 ただし,これらのラベルはカスタマイズ可能です。 プログラマは,ユーザーが Key 列の文字列を選択,追加, または編集できるかどうかを制御できます。 Value 列の各エントリでは,ユーザーは文字列の編集や, 値を選択するためのドロップダウンリストの指定, あるいは値を編集可能なダイアログの提供を行うことができます。 ───────────────────────────────────── @予期しない値がセットされていないようにローカル変数を削除します[D KILL^ZVCMSUB] Aイベントマスクを設定します、例では[V2EVENT^ZVCMVLS]ですが->適切に設定 Brectパラメタを作成します。[D SETRECT^ZVCMVLS] (x,y,w,h):位置サイズ情報(行桁サイズモードに設定後) (color):コントロールの色番号(Colorプロパティ) -->指定なしの場合デフォルトの色 (font):コントロールのフオント番号(Fontプロパティ) -->指定なしの場合(null)[font=498]のフオントをセット[SETRECTにおいて] -->0:指定の場合デフォルトのフオント (keycode):キーボードイベントを発生させる終了キーコードのセット -->0を指定した場合0番のキーセットを指定した意味 ※イベントマスク設定でキーボードイベントを有効に設定しないとキーボードイベントは発生しません (その他のプロパティ):(zorder,TabOrder,TabStop)...は必要があれば設定します。 ※[D SETRECT^ZVCMVLS -> rectstrが作成される [C-1]グリッド作成情報-1をeditパラメタに設定します。[editstr] -->ローカル変数を削除します[D KILLEDIT^ZVCMVLS] ※[S defwidth=(明示的にサイズ変更されていない全ての列の幅(桁数)小数点可)] ※[S width=(各Columnの幅(;でColumn数分指定)] <- vcomライン数で指定(小数点可) --> インデックス(0)の幅;インデックス(1)の幅;...; ※[S height=(デフォルトのRowの高さ)] <- vcomライン数で指定(小数点可) ※[S scroll=スクロールバーの指定] --> 1:無し 2:水平方向 3:垂直方向 4:両方(デフォルト) ※[S Lindex=左端に表示されるスクロールするColumnのインデックス(0,1,2,...)](LeftCol) ※[S Tindex=上端に表示されるスクロールするRowのインデックス(0,1,2,...)](TopRow) ※[S Fcolor=スクロールしない固定部の色](FixedColor) --> 色コード参照 ※[S editmode=エデットモードの指定](Options<<goEditing) --> 1:エデットモード null:参照のみ ※[S options=オプションの指定(付加)(;で区切って複数指定)](Options) --> オプション;オプション;オプション;... 1:固定列を分ける垂直線が描画される(goFixedVertLine) 2:固定行を分ける水平線が描画される(goFixedHorzLine) 3:スクロール可能列を分ける垂直線が描画される(goVertLine) 4:スクロール可能行を分ける水平線が描画される(goHorzLine) 5:各セルの範囲を一度に選択できる(goRangeSelect) 6:入力フォーカスのあるセルは特別な背景色で描画(goDrawFocusSelected) 7:スクロール可能列は個別にサイズ変更できる(goRowSizing) 8:スクロール可能行は個別にサイズ変更できる(goColSizing) 9:スクロール可能列は個別にマウスで移動できる(goRowMoving) 10:スクロール可能行は個別にマウスで移動できる(goColMoving) 11:セルの内容を変更できる(goEditing) 12:[Tab]および[Shift]+[Tab]キーで各セル間を移動できる(goTabs) 13:各セルではなく行全体を選択する(goRowSelect) 14:グリッドは編集モードにロックされる(goAlwaysShowEditor) 15:スクロールボックスをドラグ中グリッドイメージが更新される(goThumbTracking) ※[S delopts=オプションの指定(削除)(;で区切って複数指定) --> オプション;オプション;オプション;... ※[S respkeys=各行の左からのキーの個数(1)] ※[D SETEDIT^ZVCMVLS]グリッド作成情報を作成 ※[S editstr=EDITSTR] [C-2]グリッド作成情報-2をpm1パラメタに設定します。[pm1str] ※[S DisplayOptions=(バリューリストエディタの概観の属性(1;2;3)の様に複数指定可)] --> 1:先頭行はキャプションを表示する固定行(非スクロール)(doColumnTitle) --> 2:エディタをサイズ変更すると列幅に完全に収まる様に自動調整(doAutoColResize) --> 3:キー列は固定されている(サイズ変更すると値列のみ変更)(doKeyColFixed) ※[S DropDownRows=(選択リストを備えた値に表示されるドロップダウンリストの長さ)] -->デフォルト値=8 ※[S KeyOptions=(ユーザのキーストロークに応答する方法(1;2;3)の様に複数指定可)] --> 1:キー列の値を編集出来る(<<keyEdit) --> 2:新しいキー/値の列を追加出来る(<<keyadd) --> 3:<delete>キーでキー/値の列を削除出来る(<<keyDelete) --> 4:重複名の名前キー/値の列を作成出来ない(例外発生)(<<keyUnique) ※[S KeyCaption=(キー列に表示タイトルを指定する)(TitleCaptions->Strings[0])] ※[S ValueCaption=(値列に表示タイトルを指定する)(TitleCaptions->Strings[1])] ※[D SETPM1^ZVCMVLS]グリッド作成情報を作成 ※[S pm1str=PM1STR] D[D CREATE^ZVCMGRD]で使用されるパラメタを設定する ※[S cid=(1〜1023の一意の番号)] ※[S form=(1〜1023の親フォームのフォーム番号)] ※[S parent=(1〜1023の親コントロールのcid番号)] ※[S group=(0〜32767のグループ番号)] ※[S editstr=(バリューリストエディタ作成パラメタ-1)] ※[S pm1str=(バリューリストエディタ作成パラメタ-2)] ※[D CREATE^ZVCMVLS]コントロールオブジェクトの作成 E作成後バリューリストエディタコントロールの中に表示する表データを追加する。 ※[S cid=(1〜1023の一意の番号)] ※[S start=開始rowインデックス(0,1,2,3,...)] ※[D APPEND^ZVCMVLS2]コントロールの中に表示するデータを追加 ※[W "キー文字列-0=値文字列-0"_$C(13)_$C(10)] ※[W "..."] ※[W "キー文字列-n=値文字列-n"_$C(13)_$C(10)] ※[W $C(26) Fイベント応答メッセージからコントロールの中に選択されているセルを取得する ※イベント種別=セルが選択イベントと編集されるイベントで処理します ※イベント応答メッセージを読み込む[S RESP=$$ReadMsg^ZVCMSUB(Rtail) ※読み込んだ(受信)イベント応答メッセージを分解する[D VCMRESP^ZVCMSUB] ※(Revent2):イベント種別 ※(Rselno):カレントカラム(桁)【最新の選択情報】 ※(Rselcnt):カレントロー(行)【最新の選択情報】 ※(Rmain):カレントセルの文字列 ※[Rsub]:null ※[Roption]:選択セルの矩形(左端;上端;右端;下端;Col数;Row数)(0,1,2...の値) --->グリッドのセルが選択されたイベント応答時[選択矩形情報は選択される前の情報] --->Col数;Row数は固定部とスクロール可能なものを含みます ※(Rkeycode):キーボードイベント時仮想キーコード ※(Rshift):シフト状態 0:無し 1:シフト 2:コントロール 4:<ALT>の組み合わせ ※【(61)左上端のセルが変更されたイベント】の場合は ※[Rselno] = 左端カラム(桁) ※[Rselcnt] = 上端ロー(行) ※[Rmain] = 左上端セルの文字列 G【留意点】コマンドに対する【アンサー応答メッセージ】が送信されてくるものがあります ※D STRINGLIST^ZVCMVLS3->選択リストに表示する項目リストをストリングリストから設定 ※D LOADFILE^ZVCMVLS3->テキストファイルから項目リストを取得する ※D SAVEFILE^ZVCMVLS3->項目リストをテキストファイルに保存する ※D LOADSTREAM^ZVCMVLS3->選択リストをストリームから読み込み ※D SAVESTREAM^ZVCMVLS3->選択リストをストリームに保存 HPickList[選択肢リスト]を表示するには以下のようにします S cid=xxx,editstr="$3$$",pos=nnn D ITEMPROP^ZVCMVLS2->[選択肢リストを表示出来る] S cid=xxx,editstr="選択肢-1$選択肢-2$選択肢-3$",pos=nnn D PICKLIST^ZVCMVLS2 またはストリングリストオブジェクトを作成しておき S cid=xxx,srccid=yyy,pos=nnn D STRINGLIST^ZVCMVLS3 ───────────────────────────────────── [2]バリューリストエディタ(TValueListEditor)オブジェクトのイベント →共通ルーチン【ZVCMEVENT】 →共通ルーチン【ZVCMEVENT7】応答イベントコード定数 ───────────────────────────────────── ◆ イベントマスクを設定(応答を可にする) ※イベント設定変数を初期化→ D CLEAR^ZVCMEVENT ───────────────────────────────────── mask0= 2 : (1)マウス左クリックイベント応答(ビット1) ※イベント設定変数を設定 → D CLICK^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2Click],[Revent1=EV1Click] ───────────────────────────────────── mask0= 4 : (2)マウス右クリック(ポップアップ)イベント応答(ビット2) ※イベント設定変数を設定 → D POPUP^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2RClick],[Revent1=EV1Popup] ───────────────────────────────────── mask0= 8 : (3)キーボードイベント応答(ビット3) ※イベント設定変数を設定 → D KEYBORD^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2Keybord],[Revent1=EV1Keybord] ───────────────────────────────────── mask0= 128 : (7)グリッドのセルが選択された(ビット7)[選択矩形情報は選択される前の情報] ※イベント設定変数を設定 → D SELECTCELL^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2SelCell],[Revent1=EV1SellCell] ───────────────────────────────────── mask1= 8 : (11)フォーカスを失う時応答(ビット3) ※イベント設定変数を設定 → D KILLFOCUS^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2Exit],[Revent1=EV1Exit] ───────────────────────────────────── mask1= 16 : (12)フォーカスを得る時応答(ビット4) ※イベント設定変数を設定 → D SETFOCUS^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2Enter],[Revent1=EV1Enter] ───────────────────────────────────── mask2= 64 : (22)マウス左ダブルクリック応答(ビット6) ※イベント設定変数を設定 → D LEFTDBL^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2DblClick],[Revent1=EV1DblClick] ───────────────────────────────────── mask7= 1 : (56)文字列が変更された(ValueList)(ビット0)(StringsChange) --> 文字列リスト内の名前または値が変更された直後【発生しない】 ※イベント設定変数を設定 → D STRINGCHANGE^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2StringsCng],[Revent1=EV1Other] ───────────────────────────────────── mask7= 2 : (57)編集される(ValueList)(ビット1)(SetEditText)【頻繁に発生】 --> ユーザがセルの値を編集した時(または値セルのカレント位置を変更した) --> [セルが選択されたイベント]の後に選択される前の編集されたセルのイベントが発生します ※イベント設定変数を設定 → D SETEDITTEXT^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2SetEdit],[Revent1=EV1Other] ───────────────────────────────────── mask7= 4 : (58)ローが移動(ValueList)(ビット2)(RowMoved) --> グリッド内の行の位置が変更された時(Optionプロパティで可能設定) ※イベント設定変数を設定 → D ROWMOVED^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2RowMoved],[Revent1=EV1Other] ───────────────────────────────────── mask7= 32 : (61)左上端のセルが変更された(ValueList)(ビット5)(TopLeftChanged) --> グリッド内の非固定セルがスクロールされた時 ※イベント設定変数を設定 → D TOPLEFTCHANGE^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2TopLeftCng],[Revent1=EV1Other] ───────────────────────────────────── mask7= 64 : (62)編集ボタンがクリック(ValueList)(ビット6)(EditButtonClick) --> ユーザがセル上の省略符号ボタンをクリックか 省略符号ボタン付きの値セルにフォーカスがある時[ctrl]+[Enter]を押す ※イベント設定変数を設定 → D EDITBTNCLICK^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2EditBtnClc],[Revent1=EV1Other] ───────────────────────────────────── mask7= 128 : (63)セルの編集を終了した(ValueList)(ビット7)(Validate) --> フォーカスがセルから離れると発生【編集完了時に発生】 ※イベント設定変数を設定 → D VALIDATE^ZVCMEVENT ※リスポンス応答メッセージ中のイベントコード→ [Revent2=EV2Validate],[Revent1=EV1Other] ───────────────────────────────────── ※イベントマスクを設定 → D SETEVENT^ZVCMEVENT ─────────────────────────────────── 44-1 |目次|前ページ|次ページ|