diff --git a/zh-cn/native_sdk/graphic/native_drawing/drawing_text_typography.h b/zh-cn/native_sdk/graphic/native_drawing/drawing_text_typography.h index eb4c740b31aec95d336462fa6623a70929da050d..79e29d51296d03fda1f366fc2c7d353e444793c1 100644 --- a/zh-cn/native_sdk/graphic/native_drawing/drawing_text_typography.h +++ b/zh-cn/native_sdk/graphic/native_drawing/drawing_text_typography.h @@ -348,6 +348,23 @@ typedef struct OH_Drawing_LineMetrics { OH_Drawing_Font_Metrics firstCharMetrics; } OH_Drawing_LineMetrics; +/** + * @brief 文本高度修饰符模式枚举。 + * + * @since 12 + * @version 1.0 + */ +enum OH_Drawing_TextHeightBehavior { + /** 高度修饰符设置为段落中第一行和最后一行都上升 */ + TEXT_HEIGHT_ALL = 0x0, + /** 高度修饰符设置为禁止段落中第一行上升 */ + TEXT_HEIGHT_DISABLE_FIRST_ASCENT = 0x1, + /** 高度修饰符设置为禁止段落中最后一行上升 */ + TEXT_HEIGHT_DISABLE_LAST_ASCENT = 0x2, + /** 高度修饰符设置为段落中第一行和最后一行都不上升 */ + TEXT_HEIGHT_DISABLE_ALL = 0x1 | 0x2, +}; + /** * @brief 创建指向OH_Drawing_TypographyStyle对象的指针。 * @@ -1687,6 +1704,28 @@ OH_Drawing_Range* OH_Drawing_TypographyGetLineTextRange(OH_Drawing_Typography*, */ void OH_Drawing_DestroyTextShadows(OH_Drawing_TextShadow*); +/** + * @brief 设置文本高度修饰符模式。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_TypographyStyle 指向OH_Drawing_TypographyStyle对象的指针,由{@link OH_Drawing_CreateTypographyStyle}获取。 + * @param heightMode 文本高度修饰符模式,为OH_Drawing_TextHeightBehavior类型的枚举值。 + * @since 12 + * @version 1.0 + */ +void OH_Drawing_TypographyTextSetHeightBehavior(OH_Drawing_TypographyStyle*, OH_Drawing_TextHeightBehavior heightMode); + +/** + * @brief 获取文本高度修饰符模式。 + * + * @syscap SystemCapability.Graphic.Graphic2D.NativeDrawing + * @param OH_Drawing_TypographyStyle 指向OH_Drawing_TypographyStyle对象的指针,由{@link OH_Drawing_CreateTypographyStyle}获取。 + * @return 返回文本高度修饰符模式,为OH_Drawing_TextHeightBehavior类型的枚举值。 + * @since 12 + * @version 1.0 + */ +OH_Drawing_TextHeightBehavior OH_Drawing_TypographyTextGetHeightBehavior(OH_Drawing_TypographyStyle*); + #ifdef __cplusplus } #endif