関数のパラメータで定義したリストアイテムをリストリソースに追加します。

構文

bool AL_AddListItemEx(
  LIST_HANDLE list,
  const char *listText,
  int paletteIndex,
  int showControl,
  bool checked,
  int userParam1,
  int userParam2,
  char *userParam3
);

パラメータ

list
[in] リストハンドル
listText
[in] 表示文字列。リストアイテムに表示する文字列を指定します。
paletteIndex
[in] パレットインデックス。カラーパレットのインデックス値で表示色を指定します。独自のカラーパレットを登録していないときは、0 を指定します。
showControl
[in] コントロールの種類。リストアイテムに追加するコントロールの種類を次のいずれかの値で指定します
値説明
AM_NO_CONTROLコントロールを追加しません。
AM_CHECK_BOX表示文字列の前にチェックボックスを表示します。
AM_RADIO_BTN表示文字列の前にラジオボタンを表示します。
checked
[in] checked属性。showControlの値がAM_CHECK_BOXまたはAM_RADIO_BTNのとき、ラジオボタンまたはチェックボックスの状態を指定します。trueならばチェックした状態の表示を、それ以外はチェックしない状態の表示を行います。
userParam1
[in] アプリケーションプログラム用のint型のパラメータ。
userParam2
[in] アプリケーションプログラム用のint型のパラメータ。
userParam3
[in] アプリケーションプログラム用の16バイトのchar型配列のパラメータを指すポインタ。

戻り値

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

解説

　listで指定したリストハンドルのリストリソースに、パラメータに従って定義したリストアイテムを追加します。 listTextで指定された文字列はリストリソースに複製されます

　リストリソースに登録されたリストアイテムは、0から始まるインデックス値を指定して参照します。

　本関数でリストアイテムを追加しただけでは、リスト表示は更新されないので注意してください。

必要条件

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

関連事項

AL_AddListItem関数
AL_ListItem構造体

最終更新日：2020/10/04

Copyright © 2020 OPTOELECTRONICS CO.,LTD. All rights reserved.