86HMI::List（リスト）

[メニューウィジェット]

オブジェクト関数

Listオブジェクト

Listのプロパティ

Identifier (Identifier (識別子))：

• ID: オブジェクトを識別する一意の番号
• Name: オブジェクトのユーザー定義可能な名前。86HMI APIで使用できます。

Geometry (Geometry (形状))：

• X: オブジェクトのX座標
• Y: オブジェクトのY座標
• Width: オブジェクトの幅
• Height: オブジェクトの高さ

Item Settings:

• Number of Items: 項目数は 2から 16までで、デフォルトは 5です。
• Item1～n Text: 各項目名
• Item1～n PrefixSymbol: 各項目の接頭辞記号

オプション：

• Spacing: 項目のスペース
• TextFont: 6つのデフォルトのフォントスタイルから選択します。フォントの設定手順については、テーマ管理を参照ください。
• ObjColor: 4つのテーマカラーから選択します。フォントの設定手順については、テーマ管理を参照ください。
• Enable: オブジェクトのデフォルト状態を有効化または無効化を選択します。
• Order: オブジェクトの順序。オブジェクトリストに表示されるオブジェクトの順序を上下に調整できます。

API Functions

getListSelectedItem()

説明

選択した項目番号のListを取得します。

構文

int getListSelectedItem(lv_obj_t* id);
int getListSelectedItem(char *name);

媒介変数

• [in] id
  オブジェクトID
• [in] name
  オブジェクト名

戻り値

選択した項目番号のListを返します。

例

#include "myhmi.h"

void setup() {
  Serial.begin(115200);
  while (!Serial);
  
  Hmi.begin();
  Serial.println(Hmi.getListSelectedItem(p1li1));
}

void loop() {
  // ...
}

listItemSelected()

次のイベント関数は、BEGIN_HMI_EVENT_PROCとEND_HMI_EVENT_PROCの間に記述されます。 BEGIN_HMI_EVENT_PROC 入力と END_HMI_EVENT_PROC.

説明

Listの項目が選択されていることを確認します。

構文

bool listItemSelected(lv_obj_t* id);
bool listItemSelected(char* name);

媒介変数

• [in] id
  オブジェクトID
• [in] name
  オブジェクト名

戻り値

ブール値で、Listの項目が選択されていること返します。

例

#include "myhmi.h"

void setup() {
  Serial.begin(115200);
  while (!Serial);
  
  Hmi.begin();
  // ...
}

void loop() {
  // ...
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.listItemSelected(p1li1))
    {
      Serial.println(Hmi.getListSelectedItem(p1li1));
    }
  }
  END_HMI_EVENT_PROC
}

詳細は 86HMIエディタ ユーザーマニュアル には、86HMI ウィジェットとAPIのさらなる説明がございます。