「App:Library:LVGL:docs:Layouts:Flex」の版間の差分
21行目: | 21行目: | ||
オブジェクトフレックスコンテナを作成するには、<code style="color: #bb0000;">lv_obj_set_layout(obj, LV_LAYOUT_FLEX)</code>を呼び出します。 | オブジェクトフレックスコンテナを作成するには、<code style="color: #bb0000;">lv_obj_set_layout(obj, LV_LAYOUT_FLEX)</code>を呼び出します。 | ||
− | + | LVGLのフレックスレイアウト機能は、<code style="color: #bb0000;">lv_conf.h</code>の中の<code style="color: #bb0000;">LV_USE_FLEX</code>をグローバルに有効にする必要があることに注意してください。 | |
|} | |} | ||
81行目: | 81行目: | ||
<code style="color: #bb0000;">lv_obj_set_flex_flow(obj, flex_flow)</code> | <code style="color: #bb0000;">lv_obj_set_flex_flow(obj, flex_flow)</code> | ||
− | + | <code style="color: #bb0000;">flex_flow</code>で設定可能な値は次のとおりです。 | |
* <code style="color: #bb0000;">LV_FLEX_FLOW_ROW</code>ラップせずに子供たちを一列に並べる | * <code style="color: #bb0000;">LV_FLEX_FLOW_ROW</code>ラップせずに子供たちを一列に並べる | ||
117行目: | 117行目: | ||
− | 子供の配置を管理するには、<code style="color: #bb0000;">lv_obj_set_flex_align(obj, main_place, cross_place, track_cross_place)</code> | + | 子供の配置を管理するには、<code style="color: #bb0000;">lv_obj_set_flex_align(obj, main_place, cross_place, track_cross_place)</code>を使います。 |
* <code style="color: #bb0000;">main_place</code>主軸上のトラックでアイテムを配布する方法を決定します。たとえば、の右側にあるアイテムをフラッシュします<code style="color: #bb0000;">LV_FLEX_FLOW_ROW_WRAP</code>。<code style="color: #bb0000;">justify-content</code>( CSSで呼び出されます) | * <code style="color: #bb0000;">main_place</code>主軸上のトラックでアイテムを配布する方法を決定します。たとえば、の右側にあるアイテムをフラッシュします<code style="color: #bb0000;">LV_FLEX_FLOW_ROW_WRAP</code>。<code style="color: #bb0000;">justify-content</code>( CSSで呼び出されます) | ||
129行目: | 129行目: | ||
* <code style="color: #bb0000;">LV_FLEX_ALIGN_CENTER</code>単に中央に配置する | * <code style="color: #bb0000;">LV_FLEX_ALIGN_CENTER</code>単に中央に配置する | ||
* <code style="color: #bb0000;">LV_FLEX_ALIGN_SPACE_EVENLY</code>アイテムは、任意の2つのアイテム間の間隔(およびエッジまでのスペース)が等しくなるように分散されます。には適用されません<code style="color: #bb0000;">track_cross_place</code>。 | * <code style="color: #bb0000;">LV_FLEX_ALIGN_SPACE_EVENLY</code>アイテムは、任意の2つのアイテム間の間隔(およびエッジまでのスペース)が等しくなるように分散されます。には適用されません<code style="color: #bb0000;">track_cross_place</code>。 | ||
− | * <code style="color: #bb0000;">LV_FLEX_ALIGN_SPACE_AROUND</code> | + | * <code style="color: #bb0000;">LV_FLEX_ALIGN_SPACE_AROUND</code>アイテムは、トラック内に均等に配置され、周囲に等間隔で配置されます。すべてのアイテムの両側に等しいスペースがあるため、視覚的にはスペースが等しくないことに注意してください。最初のアイテムには、コンテナの端に対して1単位のスペースがありますが、次のアイテムには独自の間隔が適用されるため、次のアイテムの間に2単位のスペースがあります。<code style="color: #bb0000;">track_cross_place</code>には適用されません。 |
− | * <code style="color: #bb0000;">LV_FLEX_ALIGN_SPACE_BETWEEN</code> | + | * <code style="color: #bb0000;">LV_FLEX_ALIGN_SPACE_BETWEEN</code>アイテムはトラックに均等に分散されます。最初のアイテムはスタートラインにあり、最後のアイテムはエンドラインにあります。<code style="color: #bb0000;">track_cross_place</code>には適用されません。 |
|} | |} | ||
155行目: | 155行目: | ||
* <code style="color: #bb0000;">C</code>成長=2で | * <code style="color: #bb0000;">C</code>成長=2で | ||
− | <code style="color: #bb0000;"> | + | <code style="color: #bb0000;">A</code>と<code style="color: #bb0000;">B</code>のサイズは100ピクセル、<code style="color: #bb0000;">C</code>のサイズは200ピクセルです。 |
− | Flex | + | Flex Growthは、<code style="color: #bb0000;">lv_obj_set_flex_grow(child, value)</code>を使用して子に設定できます。 |
+ | |||
+ | 子の成長を無効にするには、<code style="color: #bb0000;">value</code>>1または<code style="color: #bb0000;">value</code>=0である必要があります。 | ||
|} | |} | ||
215行目: | 217行目: | ||
|- | |- | ||
| | | | ||
− | If the base direction of the container is set the <code style="color: #bb0000;">LV_BASE_DIR_RTL</code> the meaning of <code style="color: #bb0000;">LV_FLEX_ALIGN_START</code> and <code style="color: #bb0000;">LV_FLEX_ALIGN_END</code> is swapped on <code style="color: #bb0000;">ROW</code> layouts. I.e. <code style="color: #bb0000;">START</code> will mean right. | + | If the base direction of the container is set the <code style="color: #bb0000;">LV_BASE_DIR_RTL</code> the meaning of <code style="color: #bb0000;">LV_FLEX_ALIGN_START</code> and <code style="color: #bb0000;">LV_FLEX_ALIGN_END</code> is swapped on <code style="color: #bb0000;">ROW</code> layouts. I.e. <code style="color: #bb0000;">START</code> will mean '''right'''. |
− | The items on <code style="color: #bb0000;">ROW</code> layouts, and tracks of <code style="color: #bb0000;">COLUMN</code> layouts will be placed from right to left. | + | The items on <code style="color: #bb0000;">ROW</code> layouts, and tracks of <code style="color: #bb0000;">COLUMN</code> layouts will be placed from '''right''' to '''left'''. |
− | | | + | |コンテナの基本方向が<code style="color: #bb0000;">LV_BASE_DIR_RTL</code>に設定されている場合、レイアウト上での<code style="color: #bb0000;">LV_FLEX_ALIGN_START</code>と<code style="color: #bb0000;">LV_FLEX_ALIGN_END</code>の意味が<code style="color: #bb0000;">ROW</code>により入れ替わります。つまり、<code style="color: #bb0000;">START</code>が'''右'''を意味します。 |
− | + | <code style="color: #bb0000;">ROW</code>レイアウト上のアイテムと<code style="color: #bb0000;">COLUMN</code>トラックは、'''右'''から'''左'''に配置されます。 | |
|} | |} | ||
231行目: | 233行目: | ||
| | | | ||
You can force Flex to put an item into a new line with <code style="color: #bb0000;">lv_obj_add_flag(child, LV_OBJ_FLAG_FLEX_IN_NEW_TRACK)</code>. | You can force Flex to put an item into a new line with <code style="color: #bb0000;">lv_obj_add_flag(child, LV_OBJ_FLAG_FLEX_IN_NEW_TRACK)</code>. | ||
− | | | + | |<code style="color: #bb0000;">lv_obj_add_flag(child, LV_OBJ_FLAG_FLEX_IN_NEW_TRACK)</code>を使用してFlexにアイテムを新しい行を強制的に配置させます。 |
|} | |} | ||
452行目: | 454行目: | ||
: アイテムが流れるはずのホットセット | : アイテムが流れるはずのホットセット | ||
: '''パラメーター''' | : '''パラメーター''' | ||
− | ::* '''flex-フレックス'''レイアウト記述子へのポインタ | + | ::*'''flex-フレックス'''レイアウト記述子へのポインタ |
− | ::* '''フロー'''- | + | ::* '''フロー'''-<code style="color: #bb0000;">lv_flex_flow_t</code>の要素。 |
void lv_obj_set_flex_align(lv_obj_t * obj、lv_flex_align_t main_place、lv_flex_align_t cross_place、lv_flex_align_t track_cross_place) | void lv_obj_set_flex_align(lv_obj_t * obj、lv_flex_align_t main_place、lv_flex_align_t cross_place、lv_flex_align_t track_cross_place) | ||
459行目: | 461行目: | ||
: アイテムとトラックの配置方法(配置場所)を設定します | : アイテムとトラックの配置方法(配置場所)を設定します | ||
: '''パラメーター''' | : '''パラメーター''' | ||
− | ::* '''flex-'''ポインタ:フレックスレイアウト記述子へ | + | ::*'''flex-'''ポインタ:フレックスレイアウト記述子へ |
− | ::* '''main_place-''' | + | ::* '''main_place-'''アイテムを主軸(トラック内)に配置する場所。<code style="color: #bb0000;">lv_flex_align_t</code>の任意の値。 |
− | ::* '''cross_place-''' | + | ::* '''cross_place-'''クロス軸上のトラックのアイテムを配置する場所。<code style="color: #bb0000;">LV_FLEX_ALIGN_START/END/CENTER</code> |
− | ::* '''track_place-''' | + | ::* '''track_place-'''クロス方向にトラックを配置する場所。<code style="color: #bb0000;">lv_flex_align_t</code>の任意の値。 |
void lv_obj_set_flex_grow(lv_obj_t * obj、uint8_t grow) | void lv_obj_set_flex_grow(lv_obj_t * obj、uint8_t grow) |
2022年6月29日 (水) 12:46時点における版
https://docs.lvgl.io/8.2/layouts/flex.html
Flex
Overview
英文 | 自動翻訳 |
---|---|
The Flexbox (or Flex for short) is a subset of CSS Flexbox. It can arrange items into rows or columns (tracks), handle wrapping, adjust the spacing between the items and tracks, handle grow to make the item(s) fill the remaining space with respect to min/max width and height. To make an object flex container call Note that the flex layout feature of LVGL needs to be globally enabled with |
Flexbox(または略してFlex)はCSSFlexboxのサブセットです。
アイテムを行または列(トラック)に配置し、ラッピングを処理し、アイテムとトラックの間隔を調整し、ハンドルを大きくして、最小/最大の幅と高さに関して残りのスペースをアイテムが埋めるようにします。 オブジェクトフレックスコンテナを作成するには、 LVGLのフレックスレイアウト機能は、 |
Terms
英文 | 自動翻訳 |
---|---|
|
|
Simple interface
英文 | 自動翻訳 |
---|---|
With the following functions you can set a Flex layout on any parent. |
次の関数を使用して、任意の親にFlexレイアウトを設定できます。 |
Flex flow
英文 | 自動翻訳 |
---|---|
The possible values for
|
|
Flex align
英文 | 自動翻訳 |
---|---|
To manage the placement of the children use
The possible values are:
|
可能な値は次のとおりです。
|
Flex grow
英文 | 自動翻訳 |
---|---|
Flex grow can be used to make one or more children fill the available space on the track. When more children have grow parameters, the available space will be distributed proportionally to the grow values. For example, there is 400 px remaining space and 4 objects with grow:
Flex grow can be set on a child with |
フレックスグローを使用して、1人または複数の子をトラックの使用可能なスペースに埋めることができます。より多くの子が成長パラメータを持っている場合、利用可能なスペースは成長値に比例して分配されます。たとえば、残りのスペースは400ピクセルで、growのあるオブジェクトは4つあります。
Flex Growthは、 子の成長を無効にするには、 |
Style interface
英文 | 自動翻訳 |
---|---|
All the Flex-related values are style properties under the hood and you can use them similarly to any other style property. The following flex related style properties exist:
|
|
Internal padding
英文 | 自動翻訳 |
---|---|
To modify the minimum space flexbox inserts between objects, the following properties can be set on the flex container style:
These can for example be used if you don't want any padding between your objects: |
オブジェクト間の最小スペースフレックスボックス挿入を変更するには、フレックスコンテナスタイルに次のプロパティを設定できます。
これらは、たとえば、オブジェクト間にパディングが必要ない場合に使用できます。 |
Other features
RTL
英文 | 自動翻訳 |
---|---|
If the base direction of the container is set the The items on |
コンテナの基本方向がLV_BASE_DIR_RTL に設定されている場合、レイアウト上でのLV_FLEX_ALIGN_START とLV_FLEX_ALIGN_END の意味がROW により入れ替わります。つまり、START が右を意味します。
|
New track
英文 | 自動翻訳 |
---|---|
You can force Flex to put an item into a new line with |
lv_obj_add_flag(child, LV_OBJ_FLAG_FLEX_IN_NEW_TRACK) を使用してFlexにアイテムを新しい行を強制的に配置させます。
|
Example
A simple row and a column layout with flexbox
英文 | 自動翻訳 |
---|---|
Arrange items in rows with wrap and even spacing | |
Demonstrate flex grow | |
Demonstrate flex grow. | |
Demonstrate column and row gap style properties | |
RTL base direction changes order of the items |
API
英文 | 自動翻訳 |
---|---|
Enums enum lv_flex_align_t
enum lv_flex_flow_t
Functions LV_EXPORT_CONST_INT(LV_OBJ_FLAG_FLEX_IN_NEW_TRACK) void lv_flex_init(void)
void lv_obj_set_flex_flow(lv_obj_t *obj, lv_flex_flow_t flow)
void lv_obj_set_flex_align(lv_obj_t *obj, lv_flex_align_t main_place, lv_flex_align_t cross_place, lv_flex_align_t track_cross_place)
void lv_obj_set_flex_grow(lv_obj_t *obj, uint8_t grow)
void lv_style_set_flex_flow(lv_style_t *style, lv_flex_flow_t value) void lv_style_set_flex_main_place(lv_style_t *style, lv_flex_align_t value) void lv_style_set_flex_cross_place(lv_style_t *style, lv_flex_align_t value) void lv_style_set_flex_track_place(lv_style_t *style, lv_flex_align_t value) void lv_style_set_flex_grow(lv_style_t *style, uint8_t value) void lv_obj_set_style_flex_flow(lv_obj_t *obj, lv_flex_flow_t value, lv_style_selector_t selector) void lv_obj_set_style_flex_main_place(lv_obj_t *obj, lv_flex_align_t value, lv_style_selector_t selector) void lv_obj_set_style_flex_cross_place(lv_obj_t *obj, lv_flex_align_t value, lv_style_selector_t selector) void lv_obj_set_style_flex_track_place(lv_obj_t *obj, lv_flex_align_t value, lv_style_selector_t selector) void lv_obj_set_style_flex_grow(lv_obj_t *obj, uint8_t value, lv_style_selector_t selector) static inline lv_flex_flow_t lv_obj_get_style_flex_flow(const lv_obj_t *obj, uint32_t part) static inline lv_flex_align_t lv_obj_get_style_flex_main_place(const lv_obj_t *obj, uint32_t part) static inline lv_flex_align_t lv_obj_get_style_flex_cross_place(const lv_obj_t *obj, uint32_t part) static inline lv_flex_align_t lv_obj_get_style_flex_track_place(const lv_obj_t *obj, uint32_t part) static inline uint8_t lv_obj_get_style_flex_grow(const lv_obj_t *obj, uint32_t part) Variables uint32_t LV_LAYOUT_FLEX lv_style_prop_t LV_STYLE_FLEX_FLOW lv_style_prop_t LV_STYLE_FLEX_MAIN_PLACE lv_style_prop_t LV_STYLE_FLEX_CROSS_PLACE lv_style_prop_t LV_STYLE_FLEX_TRACK_PLACE lv_style_prop_t LV_STYLE_FLEX_GROW |
列挙型
列挙型lv_flex_align_t
列挙型lv_flex_flow_t
機能 LV_EXPORT_CONST_INT(LV_OBJ_FLAG_FLEX_IN_NEW_TRACK) void lv_flex_init(void)
void lv_obj_set_flex_flow(lv_obj_t * obj、lv_flex_flow_t flow)
void lv_obj_set_flex_align(lv_obj_t * obj、lv_flex_align_t main_place、lv_flex_align_t cross_place、lv_flex_align_t track_cross_place)
void lv_obj_set_flex_grow(lv_obj_t * obj、uint8_t grow)
void lv_style_set_flex_flow(lv_style_t * style、lv_flex_flow_t value) void lv_style_set_flex_main_place(lv_style_t * style、lv_flex_align_t value) void lv_style_set_flex_cross_place(lv_style_t * style、lv_flex_align_t value) void lv_style_set_flex_track_place(lv_style_t * style、lv_flex_align_t value) void lv_style_set_flex_grow(lv_style_t * style、uint8_t value) void lv_obj_set_style_flex_flow(lv_obj_t * obj、lv_flex_flow_t value、lv_style_selector_tセレクター) void lv_obj_set_style_flex_main_place(lv_obj_t * obj、lv_flex_align_t value、lv_style_selector_tセレクター) void lv_obj_set_style_flex_cross_place(lv_obj_t * obj、lv_flex_align_t value、lv_style_selector_tセレクター) void lv_obj_set_style_flex_track_place(lv_obj_t * obj、lv_flex_align_t value、lv_style_selector_tセレクター) void lv_obj_set_style_flex_grow(lv_obj_t * obj、uint8_t value、lv_style_selector_tセレクター) static inline lv_flex_flow_t lv_obj_get_style_flex_flow(const lv_obj_t * obj、uint32_t part) static inline lv_flex_align_t lv_obj_get_style_flex_main_place(const lv_obj_t * obj、uint32_t part) static inline lv_flex_align_t lv_obj_get_style_flex_cross_place(const lv_obj_t * obj、uint32_t part) static inline lv_flex_align_t lv_obj_get_style_flex_track_place(const lv_obj_t * obj、uint32_t part) 静的インラインuint8_tlv_obj_get_style_flex_grow(const lv_obj_t * obj、uint32_t part) 変数 uint32_t LV_LAYOUT_FLEX lv_style_prop_t LV_STYLE_FLEX_FLOW lv_style_prop_t LV_STYLE_FLEX_MAIN_PLACE lv_style_prop_t LV_STYLE_FLEX_CROSS_PLACE lv_style_prop_t LV_STYLE_FLEX_TRACK_PLACE lv_style_prop_t LV_STYLE_FLEX_GROW |