3.3.6. InputField

InputField 控件用于接收用户输入的文本信息

inputfield_object.set_text(string, [color_r, color_g, color_b, color_a, ]align, size)
描述:

设置输入框对象中的的文字属性

参数:
  • string (string) – 需要显示的字符串内容
  • [color_r, color_g, color_b, color_a] (list) – 可选参数,需要显示的字符串的颜色,参数分别为显示颜色 r 值、b 值,g 值,透明度,取值范围都为[0, 255]
  • align (enum) – 可选参数,枚举类型,需要显示文字的对齐方式,详细见表格 align
  • size (int) – 显示文字的字号大小
返回:

示例:

my_InputField.set_text('Hello RoboMaster',120, 120, 120, 200, text_anchor.upper_left, 12)

示例说明:

设置字体的 rgb 值为(120, 120, 120),透明度为 200 ,字体对齐方式为顶端左对齐,字号大小为 12 号

input_field_object.set_text_color(r, g, b, a)
描述:

设置文字的颜色

参数:
  • r (int) – 文字颜色的 r 值,范围为[0, 255]
  • g (int) – 文字颜色的 g 值,范围为[0, 255]
  • b (int) – 文字颜色的 b 值,范围为[0, 255]
  • a (int) – 文字颜色的透明度, 范围为[0, 255]
返回:

示例:

my_button.set_text_color(120, 120, 120, 200)

示例说明:

设置字体的 rgb 值为(120, 120, 120),透明度为 200

input_field_object.set_text_align(align)
描述:设置控件中文字的对齐方式
参数:align (enum) – 可选参数,枚举类型,需要显示文字的对齐方式,详细见表格 align
返回:
示例:my_Input_field.set_text_align(text_anchor.upper_left)
示例说明:设置文字的对齐方式为顶端左对齐
input_field_object.set_text_size(size)
描述:设置控件中文字的字号大小
参数:size (int) – 文字的字号值
返回:
示例:my_Input_field.set_text_size(12)
示例说明:设置文字的字号为 12 号
input_field_object.set_background_color(r, g, b, a)
描述:

设置控件的背景色

参数:
  • r (int) – 背景颜色的 r 值,范围为[0, 255]
  • g (int) – 背景颜色的 g 值,范围为[0, 255]
  • b (int) – 背景颜色的 b 值,范围为[0, 255]
  • a (int) – 背景颜色的透明度,[0, 255]
返回:

示例:

my_Input_field.set_background_color(200, 200, 200, 230)

示例说明:

设置背景色的 rgb 值为(200, 200, 200) ,透明度为 230

input_field_object.set_hint_text(string, [color_r, color_g, color_b, color_a, ]align, size)
描述:

设置控件中的提示文字的属性

参数:
  • string (string) – 需要显示的字符串内容
  • [color_r, color_g, color_b, color_a] (list) – 可选参数,需要显示的字符串的颜色,参数分别为显示颜色 r 值、b 值,g 值,透明度,取值范围都为[0, 255]
  • align (enum) – 可选参数,枚举类型,需要显示文字的对齐方式,详细见表格 align
  • size (int) – 显示文字的字号大小
返回:

示例:

my_Input_field.set_hint_text(120, 120, 120, 200, text_anchor.upper_left, 12)

示例说明:

设置提示文字的 rgb 值为(120, 120, 120),透明度为 200 ,字体对齐方式为顶端左对齐,字号大小为 12 号

input_field_object.set_hint_text_color(r, g, b, a)
描述:

设置控件提示文字的颜色

参数:
  • r (int) – 文字颜色的 r 值,范围为[0, 255]
  • g (int) – 文字颜色的 g 值,范围为[0, 255]
  • b (int) – 文字颜色的 b 值,范围为[0, 255]
  • a (int) – 文字颜色的透明度, 范围为[0, 255]
返回:

示例:

my_Input_field.set_text_color(120, 120, 120, 200)

示例说明:

设置提示文字的 rgb 值为(120, 120, 120),透明度为 200

input_field_object.set_hint_text_align(align)
描述:设置提示文字的对齐方式
参数:align (enum) – 可选参数,枚举类型,需要显示文字的对齐方式,详细见表格 align
返回:
示例:my_Input_field.set_text_align(text_anchor.upper_left)
示例说明:设置提示文字的对齐方式为顶端左对齐
input_field_object.set_hint_text_size(size)
描述:设置提示文字的字号大小
参数:size (int) – 文字的字号值
返回:
示例:my_Input_field.set_text_size(12)
示例说明:设置 hint 对象中文字的字号为 12 号