LineEdit¶
Inherits: Control < CanvasItem < Node < Object
类别: 核心
简要说明¶
提供单行字符串编辑的控件。
属性¶
0 |
||
假 |
||
0.65 |
||
0 |
||
假 |
||
真 |
||
真 |
||
假 |
||
2 |
||
0 |
||
0.6 |
||
“ |
||
假 |
||
“*” |
||
“ |
方法¶
无效 |
append_at_cursor ( String text ) |
无效 |
clear ( ) |
无效 |
deselect ( ) |
get_menu ( ) const |
|
无效 |
menu_option ( int option ) |
无效 |
|
无效 |
select_all ( ) |
主题属性¶
清楚的 |
||
clear_button_color |
颜色(0.88、0.88、0.88、1) |
|
clear_button_color_pressed |
颜色(1,1,1,1) |
|
cursor_color |
颜色(0.94、0.94、0.94、1) |
|
集中 |
||
字体 |
||
font_color |
颜色(0.88、0.88、0.88、1) |
|
font_color_selected |
颜色(0,0,0,1) |
|
font_color_uneditable |
颜色(0.88、0.88、0.88、0.5) |
|
minimum_spaces |
12 |
|
正常的 |
||
read_only |
||
selection_color |
颜色(0.49、0.49、0.49、1) |
信号¶
text_changed ( String new_text )
文本更改时发出。
text_entered ( String new_text )
用户按下时发出 @GlobalScope.KEY_ENTER 上 LineEdit
.
枚举¶
枚举 排列 :
ALIGN_LEFT = 0 ---将文本与
LineEdit
.ALIGN_CENTER = 1 ---将文本居中
LineEdit
.ALIGN_RIGHT = 2 ---将文本与
LineEdit
.ALIGN_FILL = 3 ---延伸空白以适应
LineEdit
的宽度。
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:选择所有文本
上/下箭头:将光标移动到行首/行尾
属性描述¶
Align align
违约 |
0 |
设定器 |
设置对齐(值) |
吸气剂 |
获取对齐() |
文本对齐方式如 ALIGN_*
枚举。
bool caret_blink
违约 |
假 |
设定器 |
光标设置闪烁启用(值) |
吸气剂 |
光标闪烁(启用) |
如果 true
,插入符号(可视光标)闪烁。
float caret_blink_speed
违约 |
0.65 |
设定器 |
光标设置闪烁速度(值) |
吸气剂 |
光标闪烁速度 |
插入符号闪烁周期的持续时间(秒)。
int caret_position
违约 |
0 |
设定器 |
设置光标位置(值) |
吸气剂 |
获取光标位置() |
光标在 LineEdit
. 设置后,文本可能会滚动以适应它。
bool clear_button_enabled
违约 |
假 |
设定器 |
设置清除按钮(值) |
吸气剂 |
_clear_button_enabled()是否已启用? |
如果 true
, the LineEdit
将显示清除按钮,如果 text
不是空的。
违约 |
真 |
设定器 |
设置上下文菜单启用(值) |
吸气剂 |
如果 true
,右键单击时将显示上下文菜单。
bool editable
违约 |
真 |
设定器 |
设置可编辑(值) |
吸气剂 |
可编辑() |
如果 false
,无法修改现有文本,也无法添加新文本。
bool expand_to_text_length
违约 |
假 |
设定器 |
将“展开”设置为“文本长度”(值) |
吸气剂 |
获取扩展到文本长度()。 |
如果 true
, the LineEdit
宽度将增加以保持比 text . 它将 not 如果 text 被缩短。
FocusMode focus_mode
违约 |
2 |
设定器 |
设置焦点模式(值) |
吸气剂 |
获取焦点模式() |
定义 LineEdit
可以抓取焦点(键盘和鼠标,仅键盘或无)。见 FocusMode 有关详细信息。
int max_length
违约 |
0 |
设定器 |
设置最大长度(值) |
吸气剂 |
获取最大长度() |
可在中输入的最大字符数 LineEdit
.如果 0
,没有限制。
float placeholder_alpha
违约 |
0.6 |
设定器 |
设置_placeholder_alpha(值) |
吸气剂 |
获取_placeholder_alpha() |
不透明度 placeholder_text . 从 0
到 1
.
String placeholder_text
违约 |
“ |
设定器 |
设置占位符(值) |
吸气剂 |
获取u placeholder() |
文本显示时间 LineEdit
是空的。它是 not 这个 LineEdit
的默认值(请参见 text )
bool secret
违约 |
假 |
设定器 |
设置机密(值) |
吸气剂 |
是机密()。 |
如果 true
,每个字符都替换为秘密字符(请参见 secret_character )
String secret_character
违约 |
“*” |
设定器 |
设置秘密字符(值) |
吸气剂 |
获取u秘密u字符() |
用于屏蔽机密输入的字符(默认为“ * “”。只有一个字符可以用作秘密字符。
String text
违约 |
“ |
设定器 |
设置文本(值) |
吸气剂 |
获取文本() |
的字符串值 LineEdit
.
方法说明¶
void append_at_cursor ( String text )
添加 text
在光标之后。如果结果值大于 max_length ,什么也没发生。
void clear ( )
删除 LineEdit
文本。
void deselect ( )
清除当前选择。
返回 PopupMenu 其中 LineEdit
. 默认情况下,右键单击 LineEdit
.
执行“menu”枚举中定义的给定操作。
选择内部字符 LineEdit
之间 from
和 to
. 默认情况下, from
是在开始和 to
最后。
text = "Welcome"
select() # Will select "Welcome"
select(4) # Will select "ome"
select(2, 5) # Will select "lco"
void select_all ( )
选择整个 String .