GET MENU ITEM ICON

4D v19

GET MENU ITEM ICON


GET MENU ITEM ICON ( menu ; menuItem ; iconRef {; process} )

引数	型	説明
menu	倍長整数, MenuRef	メニュー参照またはメニュー番号
menuItem	倍長整数	メニュー項目番号または -1: 最後に追加された項目
iconRef	テキスト変数, 倍長整数変数	メニュー項目に関連付けられたアイコンのピクチャー名または番号
process	倍長整数	プロセス番号

説明

GET MENU ITEM ICON コマンドはiconRef変数に、menu と menuItem引数で指定されたメニュー項目に関連付けられたアイコンの参照を返します。この参照はピクチャーのパス名または番号です。

メニュー項目に関連付けられたアイコンは、アプリケーションのツールバーに追加されます。

menuItemに-1を渡してmenuに最後に追加された項目を指定することができます。

menuにはメニュー参照 (MenuRef) またはメニュー番号を渡します。メニュー参照を渡す場合、process 引数は必要なく、渡されても無視されます。メニュー番号を渡す場合、コマンドはカレントプロセスのメインメニューバー中の対応するメニューを考慮します。他のプロセスを指定したい場合、オプションのprocess 引数にその番号を渡します。

ピクチャーファイルを使用してアイコンが指定されていた場合、コマンドはiconRefにピクチャーのパス名 ( path:<filesystem path> ) を返します。
アイコンがライブラリピクチャー (バイナリデータベースのみ) を使用して指定されていた場合、コマンドはこの引数に渡された変数の型に応じ、ピクチャー名 ( pictlib:<name>) あるいは番号のいずれかを返します。なお、iconRef 変数の型を指定しなかった場合は、デフォルトでピクチャー名が返されます (テキスト)

メニュー項目にアイコンが割り当てられていない場合、コマンドは空値を返します。

参照

SET MENU ITEM ICON