HIGHLIGHT RECORDS
HIGHLIGHT RECORDS ( {aTable }{;}{ setName {; *}} )
引数 | 型 | 説明 | |
---|---|---|---|
aTable | Table | → | レコードをハイライトするテーブル 省略時、カレントフォームのテーブル |
setName | Text | → | ハイライトさせるレコードのセット、または 省略時、Userset |
* | 演算子 | → | リストの自動スクロールを無効 |
このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。
説明
HIGHLIGHT RECORDS コマンドは、出力フォーム内で指定されたレコードをハイライトします。この動作は、クリックまたはShift+クリック、Ctrl+クリック (Windows) やCommand+クリック (Mac OS) キーコンビネーションを使用し、リストモードでレコードを手動で選択する場合と同じです。カレントセレクションは変更されません。
Note: "選択"されたレコードのセットは、再描画後に更新されます。つまりメソッド全体が実行終了した後であり、HIGHLIGHT RECORDSを実行した直後ではありません。
aTable引数を使用し、“ハイライト表示”されるレコードが属するテーブルを指定します。この引数は、特にカレントテーブルに属していない組み込みサブフォ-ムのレコードをハイライト表示するために使用することができます (後述参照)。
- setNameに有効なセット名を渡すと、コマンドは定義されたテーブルの、そのセット内のレコードに適用されます。
- setNameを省略すると、コマンドは現在のUserSetのレコードをハイライト表示します。このセットはユーザーモードとMODIFY SELECTION / DISPLAY SELECTIONを呼び出したときにのみ管理されます。サブフォームに対してレコードのハイライトを行いたい場合、テーブル名とセット名を指定する必要があります。UserSetセットについてはセットの節を参照してください。
* 引数を渡すと、ハイライト表示されたレコードが表示されていない場合に、そのリストの自動スクロール機能が無効になります。このメカニズムにより、OBJECT SET SCROLL POSITIONコマンドを使用して、独自のスクロール管理を行えるようになります。
Note: 組み込みサブフォームの場合、サブフォームの選択モードプロパティで複数が選択されていない場合、HIGHLIGHT RECORDS コマンドは何も行いません。この場合、行をハイライトするにはGOTO SELECTED RECORD コマンドを使用します。
例題
MODIFY SELECTIONコマンドによって表示される出力フォーム内で、カレントセレクションを変更することなく、ユーザが検索を実行できるようにしたいとします。これを実行するには、フォーム内に検索ボタンを置いて、押された時に下記のメソッドを実行します:
SET QUERY DESTINATION(Into set;"UserSet")
QUERY
SET QUERY DESTINATION(Into current selection)
HIGHLIGHT RECORDS
ユーザがボタンをクリックすると標準の検索ダイアログボックスが表示され、検索が実行された後、カレントセレクションを変更することなく、見つかったレコードを反転表示されます。