86HMI::Checkbox(チェックボックス)

コントロールウィジェット

オブジェクト関数

Checkboxオブジェクト

Checkboxのプロパティ

Identifier (Identifier (識別子))：

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

Content (Content (内容))：

• Text: Checkboxのコンテンツ
• Checked: デフォルトのCheckbox状態

Geometry (Geometry (形状))：

• X: オブジェクトのX座標
• Y: オブジェクトのY座標
• Width: オブジェクトの幅。デフォルトでは調整できません。
• Height: オブジェクトの高さ。デフォルトでは調整できません。

オプション：

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

API Functions

setCheckboxState()

説明

Checkboxの状態を設定します。

構文

void setCheckboxState(lv_obj_t* id, bool checked);
void setCheckboxState(char* name, bool checked);

媒介変数

• [in] id
  オブジェクトID
• [in] name
  オブジェクト名
• [in] checked
  ブール値で、 Checkboxの状態を Checked（チェック済み）または Unchecked（未チェック）に設定します。

戻り値

なし

例

#include "myhmi.h"

void setup() {
  Hmi.begin();
  // put your setup code here, to run once:
  Hmi.setCheckboxState(p1cb1, true);
}

void loop() {
  // ...
}

getCheckboxState()

説明

Checkboxの状態を取得します。

構文

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

媒介変数

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

戻り値

Checkboxの状態を返します。

例

#include "myhmi.h"

void setup() {
  Hmi.begin();
  // put your setup code here, to run once:
}

void loop() {
  if (Hmi.getCheckboxState(p1cb1)) {
    // do something.
  }
}

checkboxChecked()

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

説明

Checkboxがチェックされていることを確認します。

構文

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

媒介変数

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

戻り値

ブール値で、Checkboxがチェックされていることを返します。

例

#include "myhmi.h"

void setup() {
  Hmi.begin();
  // put your setup code here, to run once:
}

void loop() {
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.checkboxChecked(p1cb1))
    {
      // do something.
    }
    if (Hmi.checkboxUnchecked(p1cb1))
    {
      // do something.
    }
  }
  END_HMI_EVENT_PROC
}

checkboxUnchecked()

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

説明

Checkboxがチェックされていないことを確認します。

構文

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

媒介変数

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

戻り値

ブール値で、Checkboxがチェックされていないことを返します。

例

#include "myhmi.h"

void setup() {
  Hmi.begin();
  // put your setup code here, to run once:
}

void loop() {
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.checkboxChecked(p1cb1))
    {
      // do something.
    }
    if (Hmi.checkboxUnchecked(p1cb1))
    {
      // do something.
    }
  }
  END_HMI_EVENT_PROC
}

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