App:Library:LVGL:docs:Widgets:Image button (lv imgbtn)

https://docs.lvgl.io/8.2/widgets/extra/imgbtn.html

Image button (lv_imgbtn)

Overview

英文	自動翻訳
The Image button is very similar to the simple 'Button' object. The only difference is that it displays user-defined images in each state instead of drawing a rectangle. You can set a left, right and center image, and the center image will be repeated to match the width of the object.	画像ボタンは、単純な「ボタン」オブジェクトと非常によく似ています。 唯一の違いは、長方形を描画する代わりに、各状態でユーザー定義の画像を表示することです。 左、右、中央の画像を設定でき、オブジェクトの幅に合わせて中央の画像が繰り返されます。

戻る : Previous

Parts and Styles

英文	自動翻訳
LV_PART_MAIN Refers to the image(s). If background style properties are used, a rectangle will be drawn behind the image button.	LV_PART_MAIN 画像を参照します。 背景スタイルのプロパティを使用すると、画像ボタンの後ろに長方形が描画されます。

戻る : Previous

Usage

Image sources

英文

自動翻訳

To set the image in a state, use the lv_imgbtn_set_src(imgbtn, LV_IMGBTN_STATE_..., src_left, src_center, src_right). The image sources work the same as described in the Image object except that "Symbols" are not supported by the Image button. Any of the sources can NULL. The possible states are: LV_IMGBTN_STATE_RELEASED LV_IMGBTN_STATE_PRESSED LV_IMGBTN_STATE_DISABLED LV_IMGBTN_STATE_CHECKED_RELEASED LV_IMGBTN_STATE_CHECKED_PRESSED LV_IMGBTN_STATE_CHECKED_DISABLED If you set sources only in LV_IMGBTN_STATE_RELEASED, these sources will be used in other states too. If you set e.g. LV_IMGBTN_STATE_PRESSED they will be used in pressed state instead of the released images.

画像の状態を設定するには、lv_imgbtn_set_src(imgbtn, LV_IMGBTN_STATE_..., src_left, src_center, src_right)を使用します。 画像ソースは、"シンボル "がイメージボタンでサポートされていないことを除いて、イメージオブジェクトで説明されたものと同じように動作します。どのソースもNULLにすることができます。 可能な状態は以下の通りです。 LV_IMGBTN_STATE_RELEASED LV_IMGBTN_STATE_PRESSED LV_IMGBTN_STATE_DISABLED LV_IMGBTN_STATE_CHECKED_RELEASED LV_IMGBTN_STATE_CHECKED_PRESSED LV_IMGBTN_STATE_CHECKED_DISABLED LV_IMGBTN_STATE_RELEASEDにのみソースを設定した場合、これらのソースは他の状態でも使用されます。LV_IMGBTN_STATE_PRESSED などに設定すると、リリースされた画像ではなく、プレスされた状態で使用されます。

戻る : Previous

States

英文	自動翻訳
Instead of the regular lv_obj_add/clear_state() functions the lv_imgbtn_set_state(imgbtn, LV_IMGBTN_STATE_...) functions should be used to manually set a state.	通常のlv_obj_add/clear_state()関数の代わりに lv_imgbtn_set_state(imgbtn, LV_IMGBTN_STATE_...)関数を使用して手動で状態を設定する必要があります．

戻る : Previous

Events

英文	自動翻訳
LV_EVENT_VALUE_CHANGED Sent when the button is toggled. Learn more about Events.	LV_EVENT_VALUE_CHANGED ボタンがトグルされたときに送信されます。 イベントについてはこちらをご覧ください。

戻る : Previous

Keys

英文	自動翻訳
LV_KEY_RIGHT/UP Go to toggled state if LV_OBJ_FLAG_CHECKABLE is enabled. LV_KEY_LEFT/DOWN Go to non-toggled state if LV_OBJ_FLAG_CHECKABLE is enabled. LV_KEY_ENTER Clicks the button Learn more about Keys.	LV_KEY_RIGHT/UP : LV_OBJ_FLAG_CHECKABLE が有効の場合、トグル状態になる。 LV_KEY_LEFT/DOWN :次の場合は切り替えられない状態になります。LV_OBJ_FLAG_CHECKABLE :が有効になります。 LV_KEY_ENTER :ボタンをクリックします キーの詳細を確認してください。

戻る : Previous

Example

英文	自動翻訳
Simple Image button

戻る : Previous

API

英文

自動翻訳

Enums enum lv_imgbtn_state_t Values: enumerator LV_IMGBTN_STATE_RELEASED enumerator LV_IMGBTN_STATE_PRESSED enumerator LV_IMGBTN_STATE_DISABLED enumerator LV_IMGBTN_STATE_CHECKED_RELEASED enumerator LV_IMGBTN_STATE_CHECKED_PRESSED enumerator LV_IMGBTN_STATE_CHECKED_DISABLED enumerator _LV_IMGBTN_STATE_NUM Functions lv_obj_t *lv_imgbtn_create(lv_obj_t *parent) Create an image button object Parameters parent -- pointer to an object, it will be the parent of the new image button Returns pointer to the created image button void lv_imgbtn_set_src(lv_obj_t *imgbtn, lv_imgbtn_state_t state, const void *src_left, const void *src_mid, const void *src_right) Set images for a state of the image button Parameters imgbtn -- pointer to an image button object state -- for which state set the new image src_left -- pointer to an image source for the left side of the button (a C array or path to a file) src_mid -- pointer to an image source for the middle of the button (ideally 1px wide) (a C array or path to a file) src_right -- pointer to an image source for the right side of the button (a C array or path to a file) void lv_imgbtn_set_state(lv_obj_t *imgbtn, lv_imgbtn_state_t state) Use this function instead of lv_obj_add/clear_state to set a state manually Parameters imgbtn -- pointer to an image button object state -- the new state const void *lv_imgbtn_get_src_left(lv_obj_t *imgbtn, lv_imgbtn_state_t state) Get the left image in a given state Parameters imgbtn -- pointer to an image button object state -- the state where to get the image (from lv_btn_state_t) ` Returns pointer to the left image source (a C array or path to a file) const void *lv_imgbtn_get_src_middle(lv_obj_t *imgbtn, lv_imgbtn_state_t state) Get the middle image in a given state Parameters imgbtn -- pointer to an image button object state -- the state where to get the image (from lv_btn_state_t) ` Returns pointer to the middle image source (a C array or path to a file) const void *lv_imgbtn_get_src_right(lv_obj_t *imgbtn, lv_imgbtn_state_t state) Get the right image in a given state Parameters imgbtn -- pointer to an image button object state -- the state where to get the image (from lv_btn_state_t) ` Returns pointer to the left image source (a C array or path to a file) Variables const lv_obj_class_t lv_imgbtn_class struct lv_imgbtn_t Public Members lv_obj_t obj const void *img_src_mid[_LV_IMGBTN_STATE_NUM] const void *img_src_left[_LV_IMGBTN_STATE_NUM] const void *img_src_right[_LV_IMGBTN_STATE_NUM] lv_img_cf_t act_cf

Enums enum lv_imgbtn_state_t Values: enumerator LV_IMGBTN_STATE_RELEASED enumerator LV_IMGBTN_STATE_PRESSED enumerator LV_IMGBTN_STATE_DISABLED enumerator LV_IMGBTN_STATE_CHECKED_RELEASED enumerator LV_IMGBTN_STATE_CHECKED_PRESSED enumerator LV_IMGBTN_STATE_CHECKED_DISABLED enumerator _LV_IMGBTN_STATE_NUM Functions lv_obj_t *lv_imgbtn_create(lv_obj_t *parent) イメージボタンオブジェクトを作成する Parameters parent --オブジェクトへのポインタ。新しいイメージボタンの親になります。 Returns 作成されたイメージボタンへのポインタ void lv_imgbtn_set_src(lv_obj_t *imgbtn, lv_imgbtn_state_t state, const void *src_left, const void *src_mid, const void *src_right) イメージボタンの状態のイメージを設定する Parameters imgbtn -- 画像ボタンオブジェクトへのポインタ state -- どの状態が新しいイメージを設定するか src_left -- ボタンの左側のイメージソースへのポインター (C配列またはファイルへのパス) src_mid -- ボタンの中央のイメージソースへのポインタ (できれば1ピクセル幅) (Cの配列かファイルへのパス) 。 src_right -- ボタンの右側のイメージソースへのポインタ (Cの配列またはファイルへのパス) 。 void lv_imgbtn_set_state(lv_obj_t *imgbtn, lv_imgbtn_state_t state) lv_obj_add/clear_stateの代わりにこの関数を使用して、手動で状態を設定します。 Parameters imgbtn -- 画像ボタンオブジェクトへのポインタ state -- 新しい状態 const void *lv_imgbtn_get_src_left(lv_obj_t *imgbtn, lv_imgbtn_state_t state) 指定した状態で左の画像を取得する Parameters imgbtn -- 画像ボタンオブジェクトへのポインタ state -- 画像を取得する状態 (from lv_btn_state_t) ` Returns 左画像ソースへのポインタ（C 言語の配列，あるいはファイルへのパス）． const void *lv_imgbtn_get_src_middle(lv_obj_t *imgbtn, lv_imgbtn_state_t state) 指定された状態での中央の画像を取得する Parameters imgbtn -- 画像ボタンオブジェクトへのポインタ state -- 画像を取得する国 (from lv_btn_state_t) ` Returns 中間画像ソースへのポインタ（C 言語の配列，あるいはファイルへのパス）． const void *lv_imgbtn_get_src_right(lv_obj_t *imgbtn, lv_imgbtn_state_t state) 与えられた状態で正しい画像を取得する Parameters imgbtn -- 画像ボタンオブジェクトへのポインタ state --画像を取得する国 (from lv_btn_state_t) ` Returns 左画像ソースへのポインタ（C 言語の配列，あるいはファイルへのパス）． Variables const lv_obj_class_t lv_imgbtn_class struct lv_imgbtn_t Public Members lv_obj_t obj const void *img_src_mid[_LV_IMGBTN_STATE_NUM] const void *img_src_left[_LV_IMGBTN_STATE_NUM] const void *img_src_right[_LV_IMGBTN_STATE_NUM] lv_img_cf_t act_cf

戻る : Previous