LineEdit

Inherits: Control < CanvasItem < Node < Object

类别: 核心

简要说明

提供单行字符串编辑的控件。

方法

无效

append_at_cursor ( String text )

无效

clear ( )

无效

deselect ( )

PopupMenu

get_menu ( ) const

无效

menu_option ( int option )

无效

select ( int from=0, int to=-1 )

无效

select_all ( )

主题属性

Texture

清楚的

Color

clear_button_color

颜色(0.88、0.88、0.88、1)

Color

clear_button_color_pressed

颜色(1,1,1,1)

Color

cursor_color

颜色(0.94、0.94、0.94、1)

StyleBox

集中

Font

字体

Color

font_color

颜色(0.88、0.88、0.88、1)

Color

font_color_selected

颜色(0,0,0,1)

Color

font_color_uneditable

颜色(0.88、0.88、0.88、0.5)

int

minimum_spaces

12

StyleBox

正常的

StyleBox

read_only

Color

selection_color

颜色(0.49、0.49、0.49、1)

信号

  • text_changed ( String new_text )

文本更改时发出。

  • text_entered ( String new_text )

用户按下时发出 @GlobalScope.KEY_ENTERLineEdit .

枚举

枚举 排列

  • ALIGN_LEFT = 0 ---将文本与 LineEdit .

  • ALIGN_CENTER = 1 ---将文本居中 LineEdit .

  • ALIGN_RIGHT = 2 ---将文本与 LineEdit .

  • ALIGN_FILL = 3 ---延伸空白以适应 LineEdit 的宽度。

枚举 MenuItems

  • MENU_CUT = 0 ---剪切(复制和清除)所选文本。

  • MENU_COPY = 1 ---复制所选文本。

  • MENU_PASTE = 2 ---将剪贴板文本粘贴到所选文本上(或在光标位置)。

不可打印的转义字符通过 String.strip_escapes .

  • MENU_CLEAR = 3 ---抹去整个 LineEdit 文本。

  • MENU_SELECT_ALL = 4 ---选择整个 LineEdit 文本。

  • MENU_UNDO = 5 ---撤消上一个操作。

  • MENU_REDO = 6 ---撤消上一次撤消操作。

  • MENU_MAX = 7 ---表示 MenuItems 枚举。

描述

lineedit提供用于文本字段的单行字符串编辑器。它具有许多内置快捷方式,这些快捷方式将始终可用:

  • ctrl+c:复制

  • ctrl+x:剪切

  • ctrl+v或ctrl+y:paste/“扬克”

  • ctrl+z:撤消

  • ctrl+shift+z:重做

  • ctrl+u:删除从光标位置到行首的文本

  • ctrl+k:删除从光标位置到行尾的文本

  • ctrl+a:选择所有文本

  • 上/下箭头:将光标移动到行首/行尾

属性描述

违约

0

设定器

设置对齐(值)

吸气剂

获取对齐()

文本对齐方式如 ALIGN_* 枚举。

违约

设定器

光标设置闪烁启用(值)

吸气剂

光标闪烁(启用)

如果 true ,插入符号(可视光标)闪烁。

违约

0.65

设定器

光标设置闪烁速度(值)

吸气剂

光标闪烁速度

插入符号闪烁周期的持续时间(秒)。

  • int caret_position

违约

0

设定器

设置光标位置(值)

吸气剂

获取光标位置()

光标在 LineEdit . 设置后,文本可能会滚动以适应它。

  • bool clear_button_enabled

违约

设定器

设置清除按钮(值)

吸气剂

_clear_button_enabled()是否已启用?

如果 true , the LineEdit 将显示清除按钮,如果 text 不是空的。

  • bool context_menu_enabled

违约

设定器

设置上下文菜单启用(值)

吸气剂

_-context_-menu_-enabled()是否已启用?

如果 true ,右键单击时将显示上下文菜单。

违约

设定器

设置可编辑(值)

吸气剂

可编辑()

如果 false ,无法修改现有文本,也无法添加新文本。

  • bool expand_to_text_length

违约

设定器

将“展开”设置为“文本长度”(值)

吸气剂

获取扩展到文本长度()。

如果 true , the LineEdit 宽度将增加以保持比 text . 它将 not 如果 text 被缩短。

违约

2

设定器

设置焦点模式(值)

吸气剂

获取焦点模式()

定义 LineEdit 可以抓取焦点(键盘和鼠标,仅键盘或无)。见 FocusMode 有关详细信息。

  • int max_length

违约

0

设定器

设置最大长度(值)

吸气剂

获取最大长度()

可在中输入的最大字符数 LineEdit .如果 0 ,没有限制。

  • float placeholder_alpha

违约

0.6

设定器

设置_placeholder_alpha(值)

吸气剂

获取_placeholder_alpha()

不透明度 placeholder_text . 从 01 .

违约

设定器

设置占位符(值)

吸气剂

获取u placeholder()

文本显示时间 LineEdit 是空的。它是 not 这个 LineEdit 的默认值(请参见 text

违约

设定器

设置机密(值)

吸气剂

是机密()。

如果 true ,每个字符都替换为秘密字符(请参见 secret_character

违约

“*”

设定器

设置秘密字符(值)

吸气剂

获取u秘密u字符()

用于屏蔽机密输入的字符(默认为“ * “”。只有一个字符可以用作秘密字符。

违约

设定器

设置文本(值)

吸气剂

获取文本()

的字符串值 LineEdit .

方法说明

  • void append_at_cursor ( String text )

添加 text 在光标之后。如果结果值大于 max_length ,什么也没发生。

  • void clear ( )

删除 LineEdit 文本。

  • void deselect ( )

清除当前选择。

返回 PopupMenu 其中 LineEdit . 默认情况下,右键单击 LineEdit .

  • void menu_option ( int option )

执行“menu”枚举中定义的给定操作。

  • void select ( int from=0, int to=-1 )

选择内部字符 LineEdit 之间 fromto . 默认情况下, from 是在开始和 to 最后。

text = "Welcome"
select()     # Will select "Welcome"
select(4)    # Will select "ome"
select(2, 5) # Will select "lco"
  • void select_all ( )

选择整个 String .