86HMI::ImageButton(画像ボタン)

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

オブジェクト関数

ImageButtonオブジェクト。ユーザーは独自の画像をデザインし、それを呼び出す前に画像ファイルリソースに追加できます。

ImageButtonオブジェクトを使用するには、必要な画像ファイルを画像ファイルリソースに追加し、プロパティグリッドの ImageSourceから使用する画像ファイルを選択する必要があります。

注記：
86HMIでは画像ファイルは直接拡大または縮小できないため、ユーザーは HMI画面に表示するために必要なサイズを満たすように事前に画像ファイルを編集する必要があります。

ImageButtonのプロパティ

Identifier (Identifier (識別子))：

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

Content (Content (内容))：

• ImageButton: 画像ファイル・ソースの選択。デフォルトの画像として設定できます。
  画像ソースの説明については、 画像ファイルリソースを参照してください。

Geometry (Geometry (形状))：

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

オプション：

• PressedEffect: ImageButtonオブジェクトを押したときの効果：
  1. 暗くする
  2. 縮小する
  3. 両方とも
• Opacity: ImageButton object opacity ratio.
• Enable: オブジェクトのデフォルト状態を有効化または無効化を選択します。
• Order: オブジェクトの順序。オブジェクトリストに表示されるオブジェクトの順序を上下に調整できます。

ImageButtonのイベント

ImageButtonオブジェクトのイベント条件: Clicked(クリック)、Pressing(押下)

次の命令を追加できます: Page Change（ページ変更）、Set Language（言語設定）、Play Sound（サウンド再生）、Custom Instruction（カスタム命令）
イベントのコマンドの使用方法については、イベント命令関数を参照してください。

注記：
カスタム命令を使用すると、編集コードを使用して、オブジェクトまたはページで実行されるイベントを編集できます。このオプションは、専門的な高度なオプションのため、ユーザーは編集する前に 86Duinoプログラムに精通している必要があります。

API Functions

imageButtonClicked()

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

説明

Determine ImageButton is clicked or not.

構文

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

媒介変数

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

戻り値

Bool. Determine ImageButton is clicked or not.

例

#include "myhmi.h"

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

void loop() {
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.imageButtonClicked(p1ib1))
    {
       // do something.
    }
  }
  END_HMI_EVENT_PROC
}

imageButtonPressing()

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

説明

Determine whether the ImageButton is pressing or not.

構文

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

媒介変数

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

戻り値

Bool. Determine whether the ImageButton is pressing or not.

例

#include "myhmi.h"

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

void loop() {
  BEGIN_HMI_EVENT_PROC
  {
    if (Hmi.imageButtonPressing(p1ib1))
    {
       // do something.
    }
  }
  END_HMI_EVENT_PROC
}

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