AIT_VerifyMenuEnabled
機能
メニュー項目が使用可能かどうかを確認します。
形式
integer AIT_VerifyMenuEnabled ( integer nMenu, // メニューハンドル integer nIndex // メニュー項目のインデックス );
引数
nMenu(入力用)
AIT_GetMenuまたはAIT_GetSubMenuのAPIが返したメニューハンドルを指定してください。
nIndex(入力用)
メニュー項目のインデックスを指定してください。メニュー項目のインデックスは0から始まります。したがって、最初のメニュー項目のインデックスは0になります。
インデックスには、メニューセパレータのインデックスも含まれます。メニューセパレータのインデックスが入力値として与えられた場合、この関数の処理は失敗し拡張エラーコードERROR_INVALID_INDEXを返します。
戻り値
メニュー項目が使用できる場合の戻り値は1、使用できない場合の戻り値は0、失敗した場合の戻り値は-1となります。
関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。
拡張エラー番号 |
エラーコード |
---|---|
8 |
ERROR_NOT_ENOUGH_MEMORY |
14 |
ERROR_OUTOFMEMORY |
87 |
ERROR_INVALID_PARAMETER |
112 |
ERROR_DISK_FULL |
1401 |
ERROR_INVALID_MENU_HANDLE |
1413 |
ERROR_INVALID_INDEX |
1460 |
ERROR_TIMEOUT |