86HMI::TextInput（テキスト入力）

[Input widgets]

オブジェクト関数

TextInputオブジェクト

TextInputのプロパティ

Identifier (Identifier (識別子))：

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

Geometry (Geometry (形状))：

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

オプション：

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

API Functions

setTextInputText()

説明

TextInputテキストを設定します。

構文

void setTextInputText(lv_obj_t* id, char* text);
void setTextInputText(char* name, char* text);

媒介変数

• [in] id
  オブジェクトID
• [in] name
  オブジェクト名
• [in] text
  TextInputテキスト

戻り値

なし

例

#include "myhmi.h"

void setup() {
  Hmi.begin();
  // ...
  Hmi.setTextInputText(p1tin1, "Text Input 1");
}

void loop() {
  // ...
}

getTextInputText()

説明

TextInputのテキストを取得します。

構文

char* getTextInputText(lv_obj_t* id);
char* getTextInputText(char* name);

媒介変数

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

戻り値

TextInputテキスト

例

#include "myhmi.h"

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

void loop() {
  // ...
  Serial.println(Hmi.getTextInputText(p1tin1));
}

textInputApplied()

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

説明

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

構文

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

媒介変数

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

戻り値

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

例

#include "myhmi.h"

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

void loop() {
  // ...
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.textInputApplied(p1tin1))
    {
      Serial.println(Hmi.getTextInputText(p1tin1));
    }
  }
  END_HMI_EVENT_PROC
}

textInputCanceled()

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

説明

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

構文

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

媒介変数

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

戻り値

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

例

#include "myhmi.h"

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

void loop() {
  // ...
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.textInputCanceled(p1tin1))
    {
      Serial.println(Hmi.getTextInputText(p1tin1));
    }
  }
  END_HMI_EVENT_PROC
}

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