アイドル状態で入力を待機している間に呼び呼び出されるコールバック関数を登録します。

構文

bool AM_SetIdleCallback(
  MENU_HANDLE menu,
  bool( *IdleCallback)(MENU_HANDLE menu, void *param),
  void *param
);

パラメータ

menu
[in] メニューハンドル
IdleCallback
[in] コールバック関数を指すポインタ。
param
[in] コールバック関数の引数として渡すパラメータを指すポインタ。

戻り値

 関数が成功したらtrueを、それ以外はfalseを返します。

解説

 本関数でコールバック関数を登録すると、AM_ExecMenu関数がアイドル状態で入力を待機している間、コールバック関数が繰り返し呼び出されます。
 コールバック関数の登録を解除するにはAM_RemoveIdleCallback関数を呼び出します。

 コールバック関数の仕様は次のとおりです。

構文

  bool MyCallbackFunction(
    MENU_HANDLE menu,
    void *param
  );
  

パラメータ

menu
[in] AM_SetIdleCallback関数のmenuパラメータで指定されたメニューハンドル。
param
[in] AM_SetIdleCallback関数のparamパラメータで指定されたポインタ。

戻り値

 入力の待機を継続する場合はtrueを返します。
 入力の待機を中止する場合はfalseを返します。この場合、AM_ExecMenu関数は待機を中止し、AMENU_CALLBACK_BREAKイベントを返します。

必要条件

ヘッダファイル:
lib.h
AdvancedMenu.h
ライブラリファイル:
libAdvancedMenu.a
libSTARTUPOPH5000.a

最終更新日:2020/10/06