コントロールウィジェット
オブジェクト関数
Sliderオブジェクト。スライダの動きやイベントの変化を制御し、数値変更機能の要素として調整に使用できます。
Sliderのプロパティ
Identifier (Identifier (識別子))：
- ID: オブジェクトを識別する一意の番号
- Name: オブジェクトのユーザー定義可能な名前。86HMI APIで使用できます。
Content (Content (内容))：
- ShowValue: 表示される値の位置で、オプションとして、Disable（無効）, Top（上）, Bottom（下）, Left（左）, Right（右）, Following（フォロー）から選択できます。
- Value: オブジェクトの初期値
- MaxValue: 最大値は正または負の値を取ることができますが、最小値より小さくすることはできません。
- MinValue: 最小値は正または負の値を取ることができますが、最大値より大きくすることはできません。
- PrefixText: 値の前にテキストを付加します。
- SuffixText: 値の後のテキストを付加します。
Geometry (Geometry (形状))：
- X: オブジェクトのX座標
- Y: オブジェクトのY座標
- Width: オブジェクトの幅。デフォルトでは調整できません。
- Height: オブジェクトの高さ。デフォルトでは調整できません。
オプション：
- Type: スライダ・タイプ、水平または垂直
- TextColor: テキストの色は、カラーパレットから選択するか、カラーコードを直接入力して設定できます。
- TextFont: 6つのデフォルトのフォントスタイルから選択します。フォントの設定手順については、テーマ管理を参照ください。
- ObjColor: 4つのテーマカラーから選択します。フォントの設定手順については、テーマ管理を参照ください。
- Enable: オブジェクトのデフォルト状態を有効化または無効化を選択します。
- Order: オブジェクトの順序。オブジェクトリストに表示されるオブジェクトの順序を上下に調整できます。
API Functions
setSliderValue()
説明
スライダの値を設定します。
構文
void setSliderValue(lv_obj_t* id, int value);
void setSliderValue(char* name, int value);
媒介変数
[in] id
オブジェクトID[in] name
オブジェクト名[in] value
スライダの値を設定します。
戻り値
なし
例
#include "myhmi.h"
void setup() {
Hmi.begin();
// put your setup code here, to run once:
Hmi.setSliderValue(p1sl1, 50);
}
void loop() {
// ..
}getSliderValue()
説明
スライダの値を取得します。
構文
int getSliderValue(lv_obj_t* id);
int getSliderValue(char* name);
媒介変数
[in] id
オブジェクトID[in] name
オブジェクト名
戻り値
スライダの値を返します。
例
#include "myhmi.h"
void setup() {
Serial.begin(115200);
while (!Serial);
Hmi.begin();
}
void loop() {
Serial.println(Hmi.getSliderValue(p1sl1));
delay(1000);
}
sliderDragging()
次のイベント関数は、BEGIN_HMI_EVENT_PROCとEND_HMI_EVENT_PROCの間に記述されます。 BEGIN_HMI_EVENT_PROC と END_HMI_EVENT_PROC.
説明
スライダがドラッグされていることを確認します。
構文
bool sliderDragging(lv_obj_t* id);
bool sliderDragging(char* name);
媒介変数
[in] id
オブジェクトID[in] name
オブジェクト名
戻り値
ブール値で、スライダがドラッグされていることを返します。
例
#include "myhmi.h"
void setup() {
Hmi.begin();
}
void loop() {
BEGIN_HMI_EVENT_PROC
{
if (Hmi.sliderDragging(p1sl1))
{
// do something.
}
}
END_HMI_EVENT_PROC
}sliderDropped()
次のイベント関数は、BEGIN_HMI_EVENT_PROCとEND_HMI_EVENT_PROCの間に記述されます。 BEGIN_HMI_EVENT_PROC と END_HMI_EVENT_PROC.
説明
スライダが落とされたことを確認します。
構文
bool sliderDropped(lv_obj_t* id);
bool sliderDropped(char* name);
媒介変数
[in] id
オブジェクトID[in] name
オブジェクト名
戻り値
ブール値で、スライダが落とされたことを返します。
例
#include "myhmi.h"
void setup() {
Hmi.begin();
}
void loop() {
BEGIN_HMI_EVENT_PROC
{
if (Hmi.sliderDropped(p1sl1))
{
// do something.
}
}
END_HMI_EVENT_PROC
}詳細は 86HMIエディタ ユーザーマニュアル には、86HMI ウィジェットとAPIのさらなる説明がございます。