SET HELP MENU

SET HELP MENU ( menuCol )

引数	型		説明
menuCol	Collection	→	メニュー項目のコレクション

このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。

説明

SET HELP MENU コマンドを使用すると、アプリケーションモードにおいてデフォルトの4D ヘルプメニューの内容を、 menuCol 引数に渡したコレクションで置き換えることができます。

このコマンドはアプリケーションモードでのデフォルトのヘルプメニューを、以下の全ての4D 環境において置き換えます: インタープリターモード、コンパイルモード、組み込みアプリ、シングルユーザーおよびクライアント/サーバー

注意:

• "ヘルプ"というラベル自体はシステムによって管理されており、このコマンドでカスタマイズすることはできません。
• カスタマイズされたヘルプメニューでは、サブメニュー、チェックマーク、スタイル、アイコンをサポートしません。

menuCol 引数には、カスタマイズされたヘルプメニューのすべての項目を定義するメニューオブジェクトのコレクションを渡します。それぞれのメニューオブジェクトは以下のプロパティを格納することができます:

プロパティ	型	詳細
title	テキスト	メニュー項目名
method	テキスト | 4D.Function	メニュー項目が選択されたときに実行するプロジェクトメソッド名または4D フォーミュラオブジェクト。このプロパティが使用されている場合、"action" プロパティを渡してはいけません(渡した場合は"method" は無視されます)
worker	テキスト | 数値	"method"のコード実行を管理するためのワーカーの名前、またはプロセスの番号。"worker"プロパティの値に応じて、複数の設定がサポートされています: 値がワーカー名(テキスト)だった場合、4D は"method"を実行するためにこのワーカーを使用または作成します(CALL WORKER と同等) 値がプロセスの番号だった場合、4D はそれが存在すればそのプロセスを使用し、そうでなければ何もしません(CALL WORKER と同等) 値が未定義でアプリケーションがカレントダイアログ(最前面のダイアログ)を表示している場合、4D はこのダイアログのプロセスを使用します(CALL FORM と同等) 値が未定義でアプリケーションがカレントダイアログを表示していない場合、4D はワーカー1(4D リモート/シングルユーザー版)またはワーカー4D_server_interface (4D Server)を呼び出します。
action	テキスト	メニュー項目が選択されたときに実行する標準アクション。このプロパティが使用されている場合、"method"プロパティは渡されていても無視されます。
shortcutKey	テキスト	項目のショートカットキー(Ctrl/Command キーと組み合わせて呼び出します)
shortcutShift	ブール	項目ショートカットにShift キーを追加するためにはTrue を渡します。
shortcutAlt	ブール	項目ショートカットにAlt/Option キーを追加するためにはTrue を渡します。

カスタマイズされたヘルプメニューは項目を、コレクション内の順番と同じ順番で表示します。

セパレーター線を挿入するには、コレクション内にnull または空のオブジェクトを渡します。

例題

アプリケーションのヘルプメニューをカスタマイズしたい場合を考えます:

 var $col : Collection
 $col:=New collection
 $col.push(New object("title";"Knowledge base";"worker";"workerHlp";"method";"methodHlp";"shortcutAlt";True;"shortcutKey";"Y"))
 $col.push(Null) //セパレーター線を追加
 $col.push(New object("title";"Tools";"action";ak msc;"shortcutShift";True;"shortcutKey";"Y"))
 SET HELP MENU($col)
 SET ABOUT("About this application";"m_about") //to replace 'About 4D' on Windows

参照

SET ABOUT