86HMI::NumberInput（数値入力）

[Input widgets]

オブジェクト関数

NumberInputオブジェクト

NumberInputのプロパティ

Identifier (Identifier (識別子))：

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

Geometry (Geometry (形状))：

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

オプション：

• Value Type: NumberInputのタイプで、整数または小数点
• Keyboard: 仮想キーボードを表示するかどうかを設定します。仮想キーボードは、ユーザーが数値入力ボックスをクリックして数値を入力するときに表示されます。
• TextFont: 6つのデフォルトのフォントスタイルから選択します。フォントの設定手順については、テーマ管理を参照ください。
• Order: オブジェクトの順序。オブジェクトリストに表示されるオブジェクトの順序を上下に調整できます。

API Functions

setNumberInputValue()

説明

NumberInput値を設定します。

構文

void setNumberInputValue(lv_obj_t* id, double value);
void setNumberInputValue(char* name, double value);

媒介変数

• [in] id
  オブジェクトID
• [in] name
  オブジェクト名
• [in] value
  デフォルトのNumberInput値

戻り値

なし

例

#include "myhmi.h"

void setup() {  
  Hmi.begin();
  // ...
  Hmi.setNumberInputValue(p1nin1, 100);
}

void loop() {
  // ...
}

getNumberInputValue()

説明

NumberInput値を取得します。

構文

double getNumberInputValue(lv_obj_t* id);
double getNumberInputValue(char* name);

媒介変数

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

戻り値

NumberInput値

例

#include "myhmi.h"

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

void loop() {
  // ...
}

getNumberInputInteger()

説明

NumberInputの整数値を取得します。

構文

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

媒介変数

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

戻り値

NumberInputの整数値

例

#include "myhmi.h"

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

void loop() {
  // ...
}

numberInputApplied()

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

説明

NumberInputが適用されていることを確認します。

構文

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

媒介変数

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

戻り値

ブール値で、NumberInputが適用されていることを確認します。

例

#include "myhmi.h"

void setup() {  
  Hmi.begin();
  // ...
}

void loop() {
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.numberInputApplied(p1nin1))
    {
      Serial.println(Hmi.getNumberInputInteger(p1nin1));
    }
  }
  END_HMI_EVENT_PROC
}

numberInputCanceled()

説明

numberInputがキャンセルされたことを確認します。

構文

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

媒介変数

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

戻り値

ブール値で、numberInputがキャンセルされたことを確認します。

例

#include "myhmi.h"

void setup() {  
  Hmi.begin();
  // ...
}

void loop() {
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.numberInputCanceled(p1nin1))
    {
      Serial.println(Hmi.getNumberInputInteger(p1nin1));
    }
  }
  END_HMI_EVENT_PROC
}

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