App:Library:LVGL:docs:Widgets:Base object

https://docs.lvgl.io/8.2/widgets/index.html

Base object (lv_obj)

Overview

英文

自動翻訳

The 'Base Object' implements the basic properties of widgets on a screen, such as: coordinates parent object children contains the styles attributes like Clickable, Scrollable, etc. In object-oriented thinking, it is the base class from which all other objects in LVGL are inherited. The functions and functionalities of the Base object can be used with other widgets too. For example lv_obj_set_width(slider, 100) The Base object can be directly used as a simple widget: it's nothing more than a rectangle. In HTML terms, think of it as a <div>.

ベースオブジェクト」は、画面上のウィジェットの基本的なプロパティを実装したもので、次のようなものです。 座標 親オブジェクト 子供 スタイルが含まれています 「ベースオブジェクト」は、次のようなウィジェットの基本的なプロパティを画面に実装します。Clickable、Scrollableなどの属性。 オブジェクト指向の考え方では、LVGL内の他のすべてのオブジェクトの継承元となる基本クラスです。 Baseオブジェクトの関数と機能は、他のウィジェットでも使用できます。例:lv_obj_set_width(slider, 100) Baseオブジェクトは単純なウィジェットとして直接使用できます。これは単なる四角形です。HTMLの用語では、 <div>です。

英文	自動翻訳
Only a small subset of coordinate settings is described here. To see all the features of LVGL (padding, coordinates in styles, layouts, etc) visit the Coordinates page.	ここでは、座標設定のごく一部についてのみ説明します。LVGLのすべての機能（パディング、スタイルの座標、レイアウトなど）を確認するには、[座標]ページにアクセスしてください。

Size

英文	自動翻訳
The object size can be modified on individual axes with lv_obj_set_width(obj, new_width) and lv_obj_set_height(obj, new_height), or both axes can be modified at the same time with lv_obj_set_size(obj, new_width, new_height).	オブジェクトのサイズは、lv_obj_set_width(obj, new_width)およびlv_obj_set_height(obj, new_height)を使用して個々の軸上で変更することも、lv_obj_set_size(obj, new_width, new_height)を使用して両方の軸を同時に変更することもできます。

Position

英文	自動翻訳
You can set the position relative to the parent with lv_obj_set_x(obj, new_x) and lv_obj_set_y(obj, new_y), or both axes at the same time with lv_obj_set_pos(obj, new_x, new_y).	親からの相対位置は、lv_obj_set_x(obj, new_x)とlv_obj_set_y(obj, new_y)、またはlv_obj_set_pos(obj, new_x, new_y)を使用して同時に設定できます。

Alignment

英文

自動翻訳

You can align the object on its parent with lv_obj_set_align(obj, LV_ALIGN_...). After this every x and y setting will be relative to the set alignment mode. For example, this will shift the object by 10;20 px from the center of its parent: lv_obj_set_align(obj, LV_ALIGN_CENTER); lv_obj_set_pos(obj, 10, 20); //Or in one function lv_obj_align(obj, LV_ALIGN_CENTER, 10, 20); To align one object to another use: lv_obj_align_to(obj_to_align, obj_referece, LV_ALIGN_..., x, y) For example, to align a text below an image: lv_obj_align_to(text, image, LV_ALIGN_OUT_BOTTOM_MID, 0, 10). The following align types exist:

lv_obj_set_align(obj, LV_ALIGN_...)で、オブジェクトをその親に位置合わせすることができます。 この後、すべての x と y の設定は、設定されたアライメントモードに対する相対的なものになります。 例えば、これはオブジェクトをその親の中心から 10;20 px ずらすことになります。 あるオブジェクトを他のオブジェクトに合わせるには、次のようにします：lv_obj_align_to(obj_to_align, obj_referece, LV_ALIGN_..., x, y) 例えば、画像の下にテキストを配置する場合： lv_obj_align_to(text, image, LV_ALIGN_OUT_BOTTOM_MID, 0, 10)となります。 以下のアラインタイプが存在します。 (絵)

Parents and children

英文

自動翻訳

You can set a new parent for an object with lv_obj_set_parent(obj, new_parent). To get the current parent, use lv_obj_get_parent(obj). To get a specific child of a parent use lv_obj_get_child(parent, idx). Some examples for idx: 0 get the child created first 1 get the child created second -1 get the child created last The children can be iterated lke this: uint32_t i; for(i = 0i < lv_obj_get_child_cnt(parent)i++) { lv_obj_t * child = lv_obj_get_child(parent, i); /*Do something with child*/ } lv_obj_get_index(obj) returns the index of the object in its parent. It is equivalent to the number of younger children in the parent. You can bring an object to the foreground or send it to the background with lv_obj_move_foreground(obj) and lv_obj_move_background(obj). You can change the index of an object in its parent using lv_obj_move_to_index(obj, index). You can swap the position of two objects with lv_obj_swap(obj1, obj2).

オブジェクトに新しい親を設定するには、 lv_obj_set_parent(obj, new_parent) を使います。 現在の親を取得するには、 lv_obj_get_parent(obj) を使用します。 親の特定の子を取得するには、lv_obj_get_child(parent, idx) を使用します。 idx のいくつかの例： 0子を最初に作成する 1子を2番目に作成する -1最後に作成された子を取得します 子たちはこれを繰り返すことができます： uint32_t i ; for （i = 0 i < lv_obj_get_child_cnt （parent ）i ++ ） { lv_obj_t * child = lv_obj_get_child （parent 、 i ）; /*子供と何かをする*/ } lv_obj_get_index(obj) は、その親の中のオブジェクトのインデックスを返します。これは、親の中の若い子の数に相当します。 lv_obj_move_foreground(obj) や lv_obj_move_background(obj) を使えば、オブジェクトを前景に出したり、背景に送ったりすることができます。 lv_obj_move_to_index(obj, index)を用いると、親オブジェクトのインデックスを変更することができます。 lv_obj_swap(obj1, obj2) を用いると、2つのオブジェクトの位置を入れ替えることができます。

Display and Screens

英文

自動翻訳

At the highest level of the LVGL object hierarchy is the display which represents the driver for a display device (physical display or simulator). A display can have one or more screens associated with it. Each screen contains a hierarchy of objects for graphical widgets representing a layout that covers the entire display. When you have created a screen like lv_obj_t * screen = lv_obj_create(NULL), you can make it active with lv_scr_load(screen). The lv_scr_act() function gives you a pointer to the active screen. If you have multiple displays, it's important to know that the screen functions operate on the most recently created display or the one explicitly selected with lv_disp_set_default. To get an object's screen use the lv_obj_get_screen(obj) function.

LVGLオブジェクト階層の最上位レベルには、ディスプレイデバイス (物理ディスプレイまたはシミュレータ) のドライバを表すディスプレイがあります。ディスプレイには、1つまたは複数の画面を関連付けることができます。各画面には、表示全体をカバーするレイアウトを表すグラフィカルウィジェットのオブジェクトの階層が含まれています。 lv_obj_t * screen = lv_obj_create(NULL) のようなスクリーンを作成したら、lv_scr_load(screen) を使ってそれをアクティブにできます。lv_scr_act()関数は、アクティブなスクリーンへのポインタを返します。 複数のディスプレイを使用する場合、画面関数は最後に作成されたディスプレイ、またはlv_disp_set_defaultで明示的に選択されたディスプレイで動作することを知っておくことが重要です。 オブジェクトのスクリーンを取得するには、lv_obj_get_screen(obj) 関数を使用します。

Events

英文	自動翻訳
To set an event callback for an object, use lv_obj_add_event_cb(obj, event_cb, LV_EVENT_..., user_data), To manually send an event to an object, use lv_event_send(obj, LV_EVENT_..., param) Read the Event overview to learn more about events.	オブジェクトにイベントコールバックを設定するには、lv_obj_add_event_cb(obj, event_cb, LV_EVENT_..., user_data)を使い、 イベントを手動でオブジェクトに送信するには、lv_event_send(obj, LV_EVENT_..., param)を使います。 イベントの詳細については、 「イベントの概要」 を参照してください。

Styles

英文

自動翻訳

Be sure to read the Style overview. Here only the most essential functions are described. A new style can be added to an object with the lv_obj_add_style(obj, &new_style, selector) function. selector is an ORed combination of part and state(s). E.g. LV_PART_SCROLLBAR | LV_STATE_PRESSED. The base objects use LV_PART_MAIN style properties and LV_PART_SCROLLBAR with the typical background style properties.

必ず「スタイルの概要」をお読みください。ここでは、最も重要な機能についてのみ説明します。 lv_obj_add_style(obj, &new_style, selector) 関数で、オブジェクトに新しいスタイルを追加できます。 selector は、part と state の OR の組み合わせです。例：LV_PART_SCROLLBAR | LV_STATE_PRESSED。 ベースオブジェクトはLV_PART_MAINスタイルプロパティを使用し、LV_PART_SCROLLBARは典型的な背景スタイルプロパティを使用します。

Flags

英文

自動翻訳

/*Hide on object*/ lv_obj_add_flag(obj, LV_OBJ_FLAG_HIDDEN); /*Make an object non-clickable*/ lv_obj_clear_flag(obj, LV_OBJ_FLAG_CLICKABLE); LV_OBJ_FLAG_HIDDEN Make the object hidden. (Like it wasn't there at all) LV_OBJ_FLAG_CLICKABLE Make the object clickable by input devices LV_OBJ_FLAG_CLICK_FOCUSABLE Add focused state to the object when clicked LV_OBJ_FLAG_CHECKABLE Toggle checked state when the object is clicked LV_OBJ_FLAG_SCROLLABLE Make the object scrollable LV_OBJ_FLAG_SCROLL_ELASTIC Allow scrolling inside but with slower speed LV_OBJ_FLAG_SCROLL_MOMENTUM Make the object scroll further when "thrown" LV_OBJ_FLAG_SCROLL_ONE Allow scrolling only one snappable children LV_OBJ_FLAG_SCROLL_CHAIN_HOR Allow propagating the horizontal scroll to a parent LV_OBJ_FLAG_SCROLL_CHAIN_VER Allow propagating the vertical scroll to a parent LV_OBJ_FLAG_SCROLL_CHAIN Simple packaging for (LV_OBJ_FLAG_SCROLL_CHAIN_HOR | LV_OBJ_FLAG_SCROLL_CHAIN_VER) LV_OBJ_FLAG_SCROLL_ON_FOCUS Automatically scroll object to make it visible when focused LV_OBJ_FLAG_SCROLL_WITH_ARROW Allow scrolling the focused object with arrow keys LV_OBJ_FLAG_SNAPPABLE If scroll snap is enabled on the parent it can snap to this object LV_OBJ_FLAG_PRESS_LOCK Keep the object pressed even if the press slid from the object LV_OBJ_FLAG_EVENT_BUBBLE Propagate the events to the parent too LV_OBJ_FLAG_GESTURE_BUBBLE Propagate the gestures to the parent LV_OBJ_FLAG_ADV_HITTEST Allow performing more accurate hit (click) test. E.g. accounting for rounded corners LV_OBJ_FLAG_IGNORE_LAYOUT Make the object positionable by the layouts LV_OBJ_FLAG_FLOATING Do not scroll the object when the parent scrolls and ignore layout LV_OBJ_FLAG_OVERFLOW_VISIBLE Do not clip the children's content to the parent's boundary LV_OBJ_FLAG_LAYOUT_1 Custom flag, free to use by layouts LV_OBJ_FLAG_LAYOUT_2 Custom flag, free to use by layouts LV_OBJ_FLAG_WIDGET_1 Custom flag, free to use by widget LV_OBJ_FLAG_WIDGET_2 Custom flag, free to use by widget LV_OBJ_FLAG_USER_1 Custom flag, free to use by user LV_OBJ_FLAG_USER_2 Custom flag, free to use by user LV_OBJ_FLAG_USER_3 Custom flag, free to use by user LV_OBJ_FLAG_USER_4 Custom flag, free to use by user Some examples: /*Hide on object*/ lv_obj_add_flag(obj, LV_OBJ_FLAG_HIDDEN); /*Make an object non-clickable*/ lv_obj_clear_flag(obj, LV_OBJ_FLAG_CLICKABLE);

/*オブジェクトを非表示にする*/ lv_obj_add_flag （obj 、 LV_OBJ_FLAG_HIDDEN ）; /*オブジェクトをクリック不可にする*/ lv_obj_clear_flag （obj 、 LV_OBJ_FLAG_CLICKABLE ）; LV_OBJ_FLAG_HIDDENオブジェクトを非表示にします。（まったくなかったように） LV_OBJ_FLAG_CLICKABLE入力デバイスでオブジェクトをクリック可能にする LV_OBJ_FLAG_CLICK_FOCUSABLEクリックしたときにフォーカスされた状態をオブジェクトに追加します LV_OBJ_FLAG_CHECKABLEオブジェクトがクリックされたときにチェック状態を切り替えます LV_OBJ_FLAG_SCROLLABLEオブジェクトをスクロール可能にする LV_OBJ_FLAG_SCROLL_ELASTIC内部のスクロールを許可しますが、速度は遅くなります LV_OBJ_FLAG_SCROLL_MOMENTUM「投げられた」ときにオブジェクトをさらにスクロールさせる LV_OBJ_FLAG_SCROLL_ONEスナップ可能な子を1つだけスクロールできるようにする LV_OBJ_FLAG_SCROLL_CHAIN_HOR水平スクロールを親に伝播できるようにする LV_OBJ_FLAG_SCROLL_CHAIN_VER垂直スクロールを親に伝播できるようにする LV_OBJ_FLAG_SCROLL_CHAINオブジェクトを非表示にします。（まったくなかったように）LV_OBJ_FLAG_SCROLL_CHAIN_HOR | LV_OBJ_FLAG_SCROLL_CHAIN_VER（ ）のシンプルなパッケージ LV_OBJ_FLAG_SCROLL_ON_FOCUSオブジェクトを自動的にスクロールして、フォーカスされたときに表示されるようにします LV_OBJ_FLAG_SCROLL_WITH_ARROWフォーカスされたオブジェクトを矢印キーでスクロールできるようにする LV_OBJ_FLAG_SNAPPABLE親でスクロールスナップが有効になっている場合は、このオブジェクトにスナップできます LV_OBJ_FLAG_PRESS_LOCKプレスがオブジェクトからスライドした場合でも、オブジェクトをプレスしたままにします LV_OBJ_FLAG_EVENT_BUBBLEイベントを親にも伝達します LV_OBJ_FLAG_GESTURE_BUBBLEジェスチャーを親に伝達します LV_OBJ_FLAG_ADV_HITTESTより正確なヒット（クリック）テストの実行を許可します。例：丸みを帯びた角の会計 LV_OBJ_FLAG_IGNORE_LAYOUTレイアウトによってオブジェクトを配置可能にします LV_OBJ_FLAG_FLOATING親がスクロールするときにオブジェクトをスクロールせず、レイアウトを無視する LV_OBJ_FLAG_OVERFLOW_VISIBLE子のコンテンツを親の境界にクリップしないでください LV_OBJ_FLAG_LAYOUT_1カスタムフラグ、レイアウトで自由に使用 LV_OBJ_FLAG_LAYOUT_2カスタムフラグ、レイアウトで自由に使用 LV_OBJ_FLAG_WIDGET_1カスタムフラグ、ウィジェットで無料で使用 LV_OBJ_FLAG_WIDGET_2カスタムフラグ、ウィジェットで無料で使用 LV_OBJ_FLAG_USER_1カスタムフラグ、ユーザーが自由に使用 LV_OBJ_FLAG_USER_2カスタムフラグ、ユーザーが自由に使用 LV_OBJ_FLAG_USER_3カスタムフラグ、ユーザーが自由に使用 LV_OBJ_FLAG_USER_4カスタムフラグ、ユーザーが自由に使用 いくつかの例： /*オブジェクトを非表示にする*/ lv_obj_add_flag （obj 、 LV_OBJ_FLAG_HIDDEN ）; /*オブジェクトをクリック不可にする*/ lv_obj_clear_flag （obj 、 LV_OBJ_FLAG_CLICKABLE ）;

Groups

英文	自動翻訳
Read the Input devices overview to learn more about Groups. Objects are added to a group with lv_group_add_obj(group, obj), and you can use lv_obj_get_group(obj) to see which group an object belongs to. lv_obj_is_focused(obj) returns if the object is currently focused on its group or not. If the object is not added to a group, false will be returned.	グループについての詳細は、入力デバイスの概要を参照してください。 オブジェクトは lv_group_add_obj(group, obj) でグループに追加され、 lv_obj_get_group(obj) でオブジェクトがどのグループに属しているかを確認することができます。 lv_obj_is_focused(obj) は、そのオブジェクトが現在そのグループにフォーカスされているかどうかを返します。オブジェクトがグループに加わっていない場合、falseが返されます。

Extended click area

英文	自動翻訳
By default, the objects can be clicked only within their bounding area. However, this can be extended with lv_obj_set_ext_click_area(obj, size).	デフォルトでは、オブジェクトは境界領域内でのみクリックできます。ただし、これは。lv_obj_set_ext_click_area(obj, size)で拡張できます。

Events

英文

自動翻訳

LV_EVENT_VALUE_CHANGED when the LV_OBJ_FLAG_CHECKABLE flag is enabled and the object clicked (on transition to/from the checked state) LV_EVENT_DRAW_PART_BEGIN and LV_EVENT_DRAW_PART_END is sent for the following types: LV_OBJ_DRAW_PART_RECTANGLE The main rectangle part: LV_PART_MAIN rect_dsc draw_area: the area of the rectangle LV_OBJ_DRAW_PART_BORDER_POST The border if the border_post style property is true part: LV_PART_MAIN rect_dsc draw_area: the area of the rectangle LV_OBJ_DRAW_PART_SCROLLBAR the scrollbars part: LV_PART_SCROLLBAR rect_dsc draw_area: the area of the rectangle Learn more about Events.

LV_EVENT_VALUE_CHANGED : LV_OBJ_FLAG_CHECKABLEフラグが有効になっており、オブジェクトがクリックされた場合 (チェックされた状態との遷移時) LV_EVENT_DRAW_PART_BEGINと LV_EVENT_DRAW_PART_END は、以下のタイプで送信されます。 LV_OBJ_DRAW_PART_RECTANGLEメインの長方形 part: LV_PART_MAIN rect_dsc draw_area：長方形の面積 LV_OBJ_DRAW_PART_BORDER_POSTstyleborder_postプロパティがtrue part:LV_PART_MAIN rect_dsc draw_area：長方形の面積 LV_OBJ_DRAW_PART_SCROLLBARスクロールバー part:LV_PART_SCROLLBAR rect_dsc draw_area：長方形の面積 イベントの詳細をご覧ください。

Keys

英文

自動翻訳

If LV_OBJ_FLAG_CHECKABLE is enabled, LV_KEY_RIGHT and LV_KEY_UP make the object checked, and LV_KEY_LEFT and LV_KEY_DOWN make it unchecked. If LV_OBJ_FLAG_SCROLLABLE is enabled, but the object is not editable (as declared by the widget class), the arrow keys (LV_KEY_UP, LV_KEY_DOWN, LV_KEY_LEFT, LV_KEY_RIGHT) scroll the object. If the object can only scroll vertically, LV_KEY_LEFT and LV_KEY_RIGHT will scroll up/down instead, making it compatible with an encoder input device. See Input devices overview for more on encoder behaviors and the edit mode. Learn more about Keys.

LV_OBJ_FLAG_CHECKABLE が有効な場合、LV_KEY_RIGHT と LV_KEY_UP はオブジェクトをチェック状態にし、LV_KEY_LEFT と LV_KEY_DOWN は非チェック状態にする。 LV_OBJ_FLAG_SCROLLABLE が有効で、かつオブジェクトが編集可能でない場合（ウィジェットクラスで宣言されている）、矢印キー(LV_KEY_UP, LV_KEY_DOWN, LV_KEY_LEFT, LV_KEY_RIGHT) はオブジェクトをスクロールさせることができます。 オブジェクトが垂直方向にしかスクロールできない場合、LV_KEY_LEFT と LV_KEY_RIGHTが代わりに上下方向にスクロールします。 エンコーダの動作と編集モードについては、入力デバイスの概要を参照してください。 キーについて詳しくはこちら。

Example

Base objects with custom styles

英文	自動翻訳
Make an object draggable

API

英文

自動翻訳

Typedefs typedef uint16_t lv_state_t typedef uint32_t lv_part_t typedef uint32_t lv_obj_flag_t typedef struct _lv_obj_t lv_obj_t Enums enum [anonymous] Possible states of a widget. OR-ed values are possible Values: enumerator LV_STATE_DEFAULT enumerator LV_STATE_CHECKED enumerator LV_STATE_FOCUSED enumerator LV_STATE_FOCUS_KEY enumerator LV_STATE_EDITED enumerator LV_STATE_HOVERED enumerator LV_STATE_PRESSED enumerator LV_STATE_SCROLLED enumerator LV_STATE_DISABLED enumerator LV_STATE_USER_1 enumerator LV_STATE_USER_2 enumerator LV_STATE_USER_3 enumerator LV_STATE_USER_4 enumerator LV_STATE_ANY Special value can be used in some functions to target all states enum [anonymous] The possible parts of widgets. The parts can be considered as the internal building block of the widgets. E.g. slider = background + indicator + knob Note every part is used by every widget Values: enumerator LV_PART_MAIN A background like rectangle enumerator LV_PART_SCROLLBAR The scrollbar(s) enumerator LV_PART_INDICATOR Indicator, e.g. for slider, bar, switch, or the tick box of the checkbox enumerator LV_PART_KNOB Like handle to grab to adjust the value enumerator LV_PART_SELECTED Indicate the currently selected option or section enumerator LV_PART_ITEMS Used if the widget has multiple similar elements (e.g. table cells) enumerator LV_PART_TICKS Ticks on scale e.g. for a chart or meter enumerator LV_PART_CURSOR Mark a specific place e.g. for text area's cursor or on a chart enumerator LV_PART_CUSTOM_FIRST Extension point for custom widgets enumerator LV_PART_ANY Special value can be used in some functions to target all parts enum [anonymous] On/Off features controlling the object's behavior. OR-ed values are possible Values: enumerator LV_OBJ_FLAG_HIDDEN Make the object hidden. (Like it wasn't there at all) enumerator LV_OBJ_FLAG_CLICKABLE Make the object clickable by the input devices enumerator LV_OBJ_FLAG_CLICK_FOCUSABLE Add focused state to the object when clicked enumerator LV_OBJ_FLAG_CHECKABLE Toggle checked state when the object is clicked enumerator LV_OBJ_FLAG_SCROLLABLE Make the object scrollable enumerator LV_OBJ_FLAG_SCROLL_ELASTIC Allow scrolling inside but with slower speed enumerator LV_OBJ_FLAG_SCROLL_MOMENTUM Make the object scroll further when "thrown" enumerator LV_OBJ_FLAG_SCROLL_ONE Allow scrolling only one snappable children enumerator LV_OBJ_FLAG_SCROLL_CHAIN_HOR Allow propagating the horizontal scroll to a parent enumerator LV_OBJ_FLAG_SCROLL_CHAIN_VER Allow propagating the vertical scroll to a parent enumerator LV_OBJ_FLAG_SCROLL_CHAIN enumerator LV_OBJ_FLAG_SCROLL_ON_FOCUS Automatically scroll object to make it visible when focused enumerator LV_OBJ_FLAG_SCROLL_WITH_ARROW Allow scrolling the focused object with arrow keys enumerator LV_OBJ_FLAG_SNAPPABLE If scroll snap is enabled on the parent it can snap to this object enumerator LV_OBJ_FLAG_PRESS_LOCK Keep the object pressed even if the press slid from the object enumerator LV_OBJ_FLAG_EVENT_BUBBLE Propagate the events to the parent too enumerator LV_OBJ_FLAG_GESTURE_BUBBLE Propagate the gestures to the parent enumerator LV_OBJ_FLAG_ADV_HITTEST Allow performing more accurate hit (click) test. E.g. consider rounded corners. enumerator LV_OBJ_FLAG_IGNORE_LAYOUT Make the object position-able by the layouts enumerator LV_OBJ_FLAG_FLOATING Do not scroll the object when the parent scrolls and ignore layout enumerator LV_OBJ_FLAG_OVERFLOW_VISIBLE Do not clip the children's content to the parent's boundary enumerator LV_OBJ_FLAG_LAYOUT_1 Custom flag, free to use by layouts enumerator LV_OBJ_FLAG_LAYOUT_2 Custom flag, free to use by layouts enumerator LV_OBJ_FLAG_WIDGET_1 Custom flag, free to use by widget enumerator LV_OBJ_FLAG_WIDGET_2 Custom flag, free to use by widget enumerator LV_OBJ_FLAG_USER_1 Custom flag, free to use by user enumerator LV_OBJ_FLAG_USER_2 Custom flag, free to use by user enumerator LV_OBJ_FLAG_USER_3 Custom flag, free to use by user enumerator LV_OBJ_FLAG_USER_4 Custom flag, free to use by user enum lv_obj_draw_part_type_t type field in lv_obj_draw_part_dsc_t if class_p = lv_obj_class Used in LV_EVENT_DRAW_PART_BEGIN and LV_EVENT_DRAW_PART_END Values: enumerator LV_OBJ_DRAW_PART_RECTANGLE The main rectangle enumerator LV_OBJ_DRAW_PART_BORDER_POST The border if style_border_post = true enumerator LV_OBJ_DRAW_PART_SCROLLBAR The scrollbar Functions void lv_init(void) Initialize LVGL library. Should be called before any other LVGL related function. void lv_deinit(void) Deinit the 'lv' library Currently only implemented when not using custom allocators, or GC is enabled. bool lv_is_initialized(void) Returns whether the 'lv' library is currently initialized lv_obj_t *lv_obj_create(lv_obj_t *parent) Create a base object (a rectangle) Parameters parent -- pointer to a parent object. If NULL then a screen will be created. Returns pointer to the new object void lv_obj_add_flag(lv_obj_t *obj, lv_obj_flag_t f) Set one or more flags Parameters obj -- pointer to an object f -- R-ed values from lv_obj_flag_t to set. void lv_obj_clear_flag(lv_obj_t *obj, lv_obj_flag_t f) Clear one or more flags Parameters obj -- pointer to an object f -- OR-ed values from lv_obj_flag_t to set. void lv_obj_add_state(lv_obj_t *obj, lv_state_t state) Add one or more states to the object. The other state bits will remain unchanged. If specified in the styles, transition animation will be started from the previous state to the current. Parameters obj -- pointer to an object state -- the states to add. E.g LV_STATE_PRESSED | LV_STATE_FOCUSED void lv_obj_clear_state(lv_obj_t *obj, lv_state_t state) Remove one or more states to the object. The other state bits will remain unchanged. If specified in the styles, transition animation will be started from the previous state to the current. Parameters obj -- pointer to an object state -- the states to add. E.g LV_STATE_PRESSED | LV_STATE_FOCUSED static inline void lv_obj_set_user_data(lv_obj_t *obj, void *user_data) Set the user_data field of the object Parameters obj -- pointer to an object user_data -- pointer to the new user_data. bool lv_obj_has_flag(const lv_obj_t *obj, lv_obj_flag_t f) Check if a given flag or all the given flags are set on an object. Parameters obj -- pointer to an object f -- the flag(s) to check (OR-ed values can be used) Returns true: all flags are setfalse: not all flags are set bool lv_obj_has_flag_any(const lv_obj_t *obj, lv_obj_flag_t f) Check if a given flag or any of the flags are set on an object. Parameters obj -- pointer to an object f -- the flag(s) to check (OR-ed values can be used) Returns true: at lest one flag flag is setfalse: none of the flags are set lv_state_t lv_obj_get_state(const lv_obj_t *obj) Get the state of an object Parameters obj -- pointer to an object Returns the state (OR-ed values from lv_state_t) bool lv_obj_has_state(const lv_obj_t *obj, lv_state_t state) Check if the object is in a given state or not. Parameters obj -- pointer to an object state -- a state or combination of states to check Returns true: obj is in statefalse: obj is not in state void *lv_obj_get_group(const lv_obj_t *obj) Get the group of the object Parameters obj -- pointer to an object Returns the pointer to group of the object static inline void *lv_obj_get_user_data(lv_obj_t *obj) Get the user_data field of the object Parameters obj -- pointer to an object Returns the pointer to the user_data of the object void lv_obj_allocate_spec_attr(lv_obj_t *obj) Allocate special data for an object if not allocated yet. Parameters obj -- pointer to an object bool lv_obj_check_type(const lv_obj_t *obj, const lv_obj_class_t *class_p) Check the type of obj. Parameters obj -- pointer to an object class_p -- a class to check (e.g. lv_slider_class) Returns true: class_p is the obj class. bool lv_obj_has_class(const lv_obj_t *obj, const lv_obj_class_t *class_p) Check if any object has a given class (type). It checks the ancestor classes too. Parameters obj -- pointer to an object class_p -- a class to check (e.g. lv_slider_class) Returns true: obj has the given class const lv_obj_class_t *lv_obj_get_class(const lv_obj_t *obj) Get the class (type) of the object Parameters obj -- pointer to an object Returns the class (type) of the object bool lv_obj_is_valid(const lv_obj_t *obj) Check if any object is still "alive". Parameters obj -- pointer to an object Returns true: valid static inline lv_coord_t lv_obj_dpx(const lv_obj_t *obj, lv_coord_t n) Scale the given number of pixels (a distance or size) relative to a 160 DPI display considering the DPI of the obj's display. It ensures that e.g. lv_dpx(100) will have the same physical size regardless to the DPI of the display. Parameters obj -- an object whose display's dpi should be considered n -- the number of pixels to scale Returns n x current_dpi/160 Variables const lv_obj_class_t lv_obj_class Make the base object's class publicly available. struct _lv_obj_spec_attr_t #include <lv_obj.h> Special, rarely used attributes. They are allocated automatically if any elements is set. Public Members struct _lv_obj_t **children Store the pointer of the children in an array. uint32_t child_cnt Number of children lv_group_t *group_p struct _lv_event_dsc_t *event_dsc Dynamically allocated event callback and user data array lv_point_t scroll The current X/Y scroll offset lv_coord_t ext_click_pad Extra click padding in all direction lv_coord_t ext_draw_size EXTend the size in every direction for drawing. lv_scrollbar_mode_t scrollbar_mode How to display scrollbars lv_scroll_snap_t scroll_snap_x Where to align the snappable children horizontally lv_scroll_snap_t scroll_snap_y Where to align the snappable children vertically lv_dir_t scroll_dir The allowed scroll direction(s) uint8_t event_dsc_cnt Number of event callbacks stored in event_dsc array struct _lv_obj_t Public Members const lv_obj_class_t *class_p struct _lv_obj_t *parent _lv_obj_spec_attr_t *spec_attr _lv_obj_style_t *styles void *user_data lv_area_t coords lv_obj_flag_t flags lv_state_t state uint16_t layout_inv uint16_t scr_layout_inv uint16_t skip_trans uint16_t style_cnt uint16_t h_layout uint16_t w_layout

Typedef typedef uint16_t lv_state_t typedef uint32_t lv_part_t typedef uint32_t lv_obj_flag_t typedef struct _lv_obj_t lv_obj_t 列挙型 列挙型[匿名] ウィジェットの可能な状態。OR-ed値が可能です 値： 列挙子LV_STATE_DEFAULT 列挙子LV_STATE_CHECKED 列挙子LV_STATE_FOCUSED 列挙子LV_STATE_FOCUS_KEY 列挙子LV_STATE_EDITED 列挙子LV_STATE_HOVERED 列挙子LV_STATE_PRESSED 列挙子LV_STATE_SCROLLED 列挙子LV_STATE_DISABLED 列挙子LV_STATE_USER_1 列挙子LV_STATE_USER_2 列挙子LV_STATE_USER_3 列挙子LV_STATE_USER_4 列挙子LV_STATE_ANY 一部の関数で特別な値を使用して、すべての状態をターゲットにすることができます 列挙型[匿名] ウィジェットの可能な部分。パーツは、ウィジェットの内部構成要素と見なすことができます。例：スライダー=背景+インジケーター+ノブすべてのパーツがすべてのウィジェットで使用されていることに注意してください 値： 列挙子LV_PART_MAIN 長方形のような背景 列挙子LV_PART_SCROLLBAR スクロールバー 列挙子LV_PART_INDICATOR インジケーター（スライダー、バー、スイッチ、チェックボックスのチェックボックスなど） 列挙子LV_PART_KNOB ハンドルのようにつかんで値を調整します 列挙子LV_PART_SELECTED 現在選択されているオプションまたはセクションを示します 列挙子LV_PART_ITEMS ウィジェットに複数の類似した要素（テーブルセルなど）がある場合に使用されます 列挙子LV_PART_TICKS チャートやメーターなどのスケールの目盛り 列挙子LV_PART_CURSOR テキスト領域のカーソルやチャートなど、特定の場所をマークします 列挙子LV_PART_CUSTOM_FIRST カスタムウィジェットの拡張ポイント 列挙子LV_PART_ANY 一部の関数で特別な値を使用して、すべてのパーツをターゲットにすることができます 列挙型[匿名] オブジェクトの動作を制御するオン/オフ機能。OR-ed値が可能です 値： 列挙子LV_OBJ_FLAG_HIDDEN オブジェクトを非表示にします。（まったくなかったように） 列挙子LV_OBJ_FLAG_CLICKABLE 入力デバイスでオブジェクトをクリック可能にする 列挙子LV_OBJ_FLAG_CLICK_FOCUSABLE クリックしたときにフォーカスされた状態をオブジェクトに追加します 列挙子LV_OBJ_FLAG_CHECKABLE オブジェクトがクリックされたときにチェック状態を切り替えます 列挙子LV_OBJ_FLAG_SCROLLABLE オブジェクトをスクロール可能にする 列挙子LV_OBJ_FLAG_SCROLL_ELASTIC 内部のスクロールを許可しますが、速度は遅くなります 列挙子LV_OBJ_FLAG_SCROLL_MOMENTUM 「投げられた」ときにオブジェクトをさらにスクロールさせる 列挙子LV_OBJ_FLAG_SCROLL_ONE スナップ可能な子を1つだけスクロールできるようにする 列挙子LV_OBJ_FLAG_SCROLL_CHAIN_HOR 水平スクロールを親に伝播できるようにする 列挙子LV_OBJ_FLAG_SCROLL_CHAIN_VER 垂直スクロールを親に伝播できるようにする 列挙子LV_OBJ_FLAG_SCROLL_CHAIN 列挙子LV_OBJ_FLAG_SCROLL_ON_FOCUS オブジェクトを自動的にスクロールして、フォーカスされたときに表示されるようにします 列挙子LV_OBJ_FLAG_SCROLL_WITH_ARROW フォーカスされたオブジェクトを矢印キーでスクロールできるようにする 列挙子LV_OBJ_FLAG_SNAPPABLE 親でスクロールスナップが有効になっている場合は、このオブジェクトにスナップできます 列挙子LV_OBJ_FLAG_PRESS_LOCK プレスがオブジェクトからスライドした場合でも、オブジェクトをプレスしたままにします 列挙子LV_OBJ_FLAG_EVENT_BUBBLE イベントを親にも伝達します 列挙子LV_OBJ_FLAG_GESTURE_BUBBLE ジェスチャーを親に伝達します 列挙子LV_OBJ_FLAG_ADV_HITTEST より正確なヒット（クリック）テストの実行を許可します。たとえば、角を丸くすることを検討してください。 列挙子LV_OBJ_FLAG_IGNORE_LAYOUT レイアウトによってオブジェクトを配置可能にする 列挙子LV_OBJ_FLAG_FLOATING 親がスクロールするときにオブジェクトをスクロールせず、レイアウトを無視する 列挙子LV_OBJ_FLAG_OVERFLOW_VISIBLE 子のコンテンツを親の境界にクリップしないでください 列挙子LV_OBJ_FLAG_LAYOUT_1 カスタムフラグ、レイアウトで自由に使用 列挙子LV_OBJ_FLAG_LAYOUT_2 カスタムフラグ、レイアウトで自由に使用 列挙子LV_OBJ_FLAG_WIDGET_1 カスタムフラグ、ウィジェットで無料で使用 列挙子LV_OBJ_FLAG_WIDGET_2 カスタムフラグ、ウィジェットで無料で使用 列挙子LV_OBJ_FLAG_USER_1 カスタムフラグ、ユーザーが自由に使用 列挙子LV_OBJ_FLAG_USER_2 カスタムフラグ、ユーザーが自由に使用 列挙子LV_OBJ_FLAG_USER_3 カスタムフラグ、ユーザーが自由に使用 列挙子LV_OBJ_FLAG_USER_4 カスタムフラグ、ユーザーが自由に使用 列挙型lv_obj_draw_part_type_t type使用されるlv_obj_draw_part_dsc_t場合のフィールドと値：class_p = lv_obj_classグループLV_EVENT_DRAW_PART_BEGINグループLV_EVENT_DRAW_PART_END 列挙子LV_OBJ_DRAW_PART_RECTANGLE メインの長方形 列挙子LV_OBJ_DRAW_PART_BORDER_POST style_border_post=trueの場合の境界線 列挙子LV_OBJ_DRAW_PART_SCROLLBAR スクロールバー 機能 void lv_init（void） LVGLライブラリを初期化します。他のLVGL関連関数の前に呼び出す必要があります。 void lv_deinit（void） 'lv'ライブラリを無効にする現在、カスタムアロケータを使用していない場合、またはGCが有効になっている場合にのみ実装されます。 bool lv_is_initialized（void） 'lv'ライブラリが現在初期化されているかどうかを返します lv_obj_t * lv_obj_create（lv_obj_t * parent） ベースオブジェクト（長方形）を作成します パラメーター parent-親オブジェクトへのポインタ。NULLの場合、画面が作成されます。 戻り値 新しいオブジェクトへのポインタ void lv_obj_add_flag（lv_obj_t * obj、lv_obj_flag_t f） 1つ以上のフラグを設定します パラメーター obj-オブジェクトへのポインタ f-からの値をR-edしlv_obj_flag_tて設定します。 void lv_obj_clear_flag（lv_obj_t * obj、lv_obj_flag_t f） 1つ以上のフラグをクリアします パラメーター obj-オブジェクトへのポインタ f-からのOR値lv_obj_flag_tを設定します。 void lv_obj_add_state（lv_obj_t * obj、lv_state_t state） 1つ以上の状態をオブジェクトに追加します。他の状態ビットは変更されません。スタイルで指定されている場合、遷移アニメーションは前の状態から現在の状態に開始されます。 パラメーター obj-オブジェクトへのポインタ state-追加する状態。例えばLV_STATE_PRESSED | LV_STATE_FOCUSED void lv_obj_clear_state（lv_obj_t * obj、lv_state_t state） オブジェクトの1つ以上の状態を削除します。他の状態ビットは変更されません。スタイルで指定されている場合、遷移アニメーションは前の状態から現在の状態に開始されます。 パラメーター obj-オブジェクトへのポインタ state-追加する状態。例えばLV_STATE_PRESSED | LV_STATE_FOCUSED static inline void lv_obj_set_user_data（lv_obj_t * obj、void * user_data） オブジェクトのuser_dataフィールドを設定します パラメーター obj-オブジェクトへのポインタ user_data-新しいuser_dataへのポインタ。 bool lv_obj_has_flag（const lv_obj_t * obj、lv_obj_flag_t f） 指定されたフラグまたは指定されたすべてのフラグがオブジェクトに設定されているかどうかを確認します。 パラメーター obj-オブジェクトへのポインタ f-チェックするフラグ（ORされた値を使用できます） 戻り値 true：すべてのフラグが設定されていますfalse：すべてのフラグが設定されているわけではありません bool lv_obj_has_flag_any（const lv_obj_t * obj、lv_obj_flag_t f） 特定のフラグまたはいずれかのフラグがオブジェクトに設定されているかどうかを確認します。 パラメーター obj-オブジェクトへのポインタ f-チェックするフラグ（ORされた値を使用できます） 戻り値 true：少なくとも1つのフラグフラグが設定されていますfalse：どのフラグも設定されていません lv_state_t lv_obj_get_state（const lv_obj_t * obj） オブジェクトの状態を取得します パラメーター obj-オブジェクトへのポインタ 戻り値 状態（からのOR-ed値lv_state_t） bool lv_obj_has_state（const lv_obj_t * obj、lv_state_t state） オブジェクトが特定の状態にあるかどうかを確認します。 パラメーター obj-オブジェクトへのポインタ 状態-チェックする状態または状態の組み合わせ 戻り値 true：objはstatefalse：objはないstate void * lv_obj_get_group（const lv_obj_t * obj） オブジェクトのグループを取得します パラメーター obj-オブジェクトへのポインタ 戻り値 オブジェクトのグループへのポインタ static inline void * lv_obj_get_user_data（lv_obj_t * obj） オブジェクトのuser_dataフィールドを取得します パラメーター obj-オブジェクトへのポインタ 戻り値 オブジェクトのuser_dataへのポインタ void lv_obj_allocate_spec_attr（lv_obj_t * obj） まだ割り当てられていない場合は、オブジェクトに特別なデータを割り当てます。 パラメーター obj-オブジェクトへのポインタ bool lv_obj_check_type（const lv_obj_t * obj、const lv_obj_class_t * class_p） objのタイプを確認してください。 パラメーター obj-オブジェクトへのポインタ class_p-チェックするクラス（例lv_slider_class） 戻り値 true：クラスですclass_p。objグループ bool lv_obj_has_class（const lv_obj_t * obj、const lv_obj_class_t * class_p） オブジェクトに特定のクラス（タイプ）があるかどうかを確認します。祖先クラスもチェックします。 パラメーター obj-オブジェクトへのポインタ class_p-チェックするクラス（例lv_slider_class） 戻り値 true：obj指定されたクラスがあります const lv_obj_class_t * lv_obj_get_class（const lv_obj_t * obj） オブジェクトのクラス（タイプ）を取得します パラメーター obj-オブジェクトへのポインタ 戻り値 オブジェクトのクラス（タイプ） bool lv_obj_is_valid（const lv_obj_t * obj） オブジェクトがまだ「生きている」かどうかを確認します。 パラメーター obj-オブジェクトへのポインタ 戻り値 true：有効 静的インラインlv_coord_tlv_obj_dpx（const lv_obj_t * obj、lv_coord_t n） のディスプレイのDPIを考慮して、160 DPIディスプレイを基準にして指定されたピクセル数（距離またはサイズ）をスケーリングしobjます。これにより、たとえばlv_dpx(100)、ディスプレイのDPIに関係なく、同じ物理サイズになります。 パラメーター obj-ディスプレイのdpiを考慮する必要があるオブジェクト n-スケーリングするピクセル数 戻り値 n x current_dpi/160 変数 const lv_obj_class_t lv_obj_class 基本オブジェクトのクラスを公開します。 struct _lv_obj_spec_attr_t #include <lv_obj.h>特別な、めったに使用されない属性。要素が設定されている場合、それらは自動的に割り当てられます。パブリックメンバー struct_lv_obj_t **子供 子のポインタを配列に格納します。 uint32_t child_cnt 子どもの数 lv_group_t * group_p struct _lv_event_dsc_t * event_dsc 動的に割り当てられたイベントコールバックとユーザーデータ配列 lv_point_tスクロール 現在のX/Yスクロールオフセット lv_coord_t ext_click_pad 全方向に余分なクリックパディング lv_coord_t ext_draw_size 描画するためにすべての方向にサイズを拡張します。 lv_scrollbar_mode_t scrollbar_mode スクロールバーの表示方法 lv_scroll_snap_t scroll_snap_x スナップ可能な子を水平に配置する場所 lv_scroll_snap_t scroll_snap_y スナップ可能な子を垂直に配置する場所 lv_dir_t scroll_dir 許可されるスクロール方向 uint8_t event_dsc_cnt グループevent_dsc配列に格納されているイベントコールバックの数 struct _lv_obj_t パブリックメンバー const lv_obj_class_t * class_p struct _lv_obj_t * parent _lv_obj_spec_attr_t * spec_attr _lv_obj_style_t * styles void * user_data lv_area_t座標 lv_obj_flag_tフラグ lv_state_t状態 uint16_t layout_inv uint16_t scr_layout_inv uint16_t skip_trans uint16_t style_cnt uint16_t h_layout uint16_t w_layout

戻る : Previous