コントロールウィジェット
オブジェクト関数
ArcSliderオブジェクト
円弧リニア・スライダの動きを制御してイベントの変更を管理し、オブジェクトを変化させる数値を調整するために使用できます。
ArcSliderのプロパティ
Identifier (Identifier (識別子))：
- ID: オブジェクトを識別する一意の番号
- Name: オブジェクトのユーザー定義可能な名前。86HMI APIで使用できます。
Content (Content (内容))：
- ShowValue: 値を表示するか、しないか
- Value: オブジェクトの初期値
- MaxValue: 最大値は正または負の値を取ることができますが、最小値より小さくすることはできません。
- MinValue: 最小値は正または負の値を取ることができますが、最大値より大きくすることはできません。
- SuffixText: 値の後のテキストを付加します。
Geometry (Geometry (形状))：
- X: オブジェクトのX座標
- Y: オブジェクトのY座標
- Width: オブジェクトの幅
- Height: オブジェクトの高さ
オプション：
- AngleStart: ArcSliderの開始角度
- AngleEnd: ArcSliderの終了角度
- TextColor: テキストの色は、カラーパレットから選択するか、カラーコードを直接入力して設定できます。
- TextFont: 6つのデフォルトのフォントスタイルから選択します。フォントの設定手順については、テーマ管理を参照ください。
- Background: オブジェクトの背景タイプで、次の 3 つのタイプがあります：
- Rectangle（矩形）
- Circle（円）
- 隠す
- BgColor: 背景色は、カラーパレットから選択するか、カラーコードを直接入力して設定できます。
- Bar Thickness: ArcSliderの厚さを調整できます。
- ObjColor: 4つのテーマカラーから選択します。フォントの設定手順については、テーマ管理を参照ください。
- Enable: オブジェクトのデフォルト状態を有効化または無効化を選択します。
- Order: オブジェクトの順序。オブジェクトリストに表示されるオブジェクトの順序を上下に調整できます。
API Functions
setArcSliderValue()
説明
ArcSliderの値を設定します。
構文
void setArcSliderValue(lv_obj_t* id, int value);
void setArcSliderValue(char* name, int value);
媒介変数
[in] id
オブジェクトID[in] name
オブジェクト名[in] value
ArcSliderの値を設定します。
戻り値
なし
例
#include "myhmi.h"
void setup() {
Hmi.begin();
// ...
Hmi.setArcSliderValue(p1asl1, 100);
}
void loop() {
// ...
}getArcSliderValue()
説明
ArcSliderの値を取得します。
構文
int getArcSliderValue(lv_obj_t* id);
int getArcSliderValue(char* name);
媒介変数
[in] id
オブジェクトID[in] name
オブジェクト名
戻り値
ArcSliderの値を返します
例
#include "myhmi.h"
void setup() {
Serial.begin(115200);
while (!Serial);
Hmi.begin();
// ...
Hmi.setArcSliderValue(p1asl1, 100);
Serial.print("p1as1 value: ");
Serial.println(Hmi.getArcSliderValue(p1asl1));
}
void loop() {
// ...
}arcSliderDragging()
次のイベント関数は、BEGIN_HMI_EVENT_PROCとEND_HMI_EVENT_PROCの間に記述されます。 BEGIN_HMI_EVENT_PROC 入力と END_HMI_EVENT_PROC.
説明
ArcSliderがドラッグされていることを確認します。
構文
bool arcSliderDragging(lv_obj_t* id);
bool arcSliderDragging(char* name);
媒介変数
[in] id
オブジェクトID[in] name
オブジェクト名
戻り値
ブール値で、ArcSliderがドラッグされていることを返します。
例
#include "myhmi.h"
void setup() {
Hmi.begin();
// ...
}
void loop() {
BEGIN_HMI_EVENT_PROC
{
if (Hmi.arcSliderDragging(p1asl1))
{
// do something.
}
}
END_HMI_EVENT_PROC
}arcSliderDropped()
次のイベント関数は、BEGIN_HMI_EVENT_PROCとEND_HMI_EVENT_PROCの間に記述されます。 BEGIN_HMI_EVENT_PROC 入力と END_HMI_EVENT_PROC.
説明
ArcSliderが落とされたことを確認します。
構文
bool arcSliderDropped(lv_obj_t* id);
bool arcSliderDropped(char* name);
媒介変数
[in] id
オブジェクトID[in] name
オブジェクト名
戻り値
ブール値で、ArcSliderが落とされたことを返します。
例
#include "myhmi.h"
void setup() {
Hmi.begin();
// ...
}
void loop() {
BEGIN_HMI_EVENT_PROC
{
if (Hmi.arcSliderDropped(p1asl1))
{
// do something.
}
}
END_HMI_EVENT_PROC
}詳細は 86HMIエディタ ユーザーマニュアル には、86HMI ウィジェットとAPIのさらなる説明がございます。
