awtk/docs/how_to_enable_bidi.md

56 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

# 如何启用文本双向排版 (Unicode Bidirectional Algorithm)
## 1. 启用文本双向排版算法
定义宏 WITH\_TEXT\_BIDI 即可,嵌入式版本请修改 awtk_config.h:
```c
/**
* 如果希望支持文字双向排版算法(如阿拉伯语言),请定义本宏。
*
* #define WITH_TEXT_BIDI 1
*
*/
```
>PC 版本默认已经定义。
2022-07-05 17:10:18 +08:00
## 2. 加入相关文件
```
3rd/fribidi/fribidi-arabic.c
3rd/fribidi/fribidi-bidi-types.c
3rd/fribidi/fribidi-bidi.c
3rd/fribidi/fribidi-brackets.c
3rd/fribidi/fribidi-deprecated.c
3rd/fribidi/fribidi-joining-types.c
3rd/fribidi/fribidi-joining.c
3rd/fribidi/fribidi-mirroring.c
3rd/fribidi/fribidi-run.c
3rd/fribidi/fribidi-shape.c
3rd/fribidi/fribidi.c
src/base/bidi.c
```
2020-07-16 07:58:53 +08:00
>PC 版本默认已经加。
2022-07-05 17:10:18 +08:00
## 3. 控件的 bidi 属性
2020-07-16 07:58:53 +08:00
2022-07-05 17:10:18 +08:00
默认情况下,文字的方向自动确定,如果在某些情况下,需要自己指定,可以通过 bidi 属性来实现。
2020-07-16 07:58:53 +08:00
2022-07-05 17:10:18 +08:00
示例:
2020-07-16 07:58:53 +08:00
2022-07-05 17:10:18 +08:00
```xml
2020-07-16 07:58:53 +08:00
<label text="1. جامعة كولومبيا عام." style:font_size="30" style:font_name="trado" bidi="lro"/>
```
2021-07-12 07:49:04 +08:00
bidi 的可选值有:
2020-07-16 07:58:53 +08:00
* rtl Right-To-Left letter。
* ltr Left-To-Right letter。
* auto Auto Detection
* wrtl Weak Right To Left paragraph。
* wltr Weak Left To Right paragraph。
* lro Left-To-Right letter Override。
* rlo Right-To-Left letter Override。