godotengine/godot-docs-l10n
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs-l10n.git synced 2025-12-31 09:49:22 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
4.x
godot-docs-l10n/classes/it/class_lineedit.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch 
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

1977 lines
94 KiB
ReStructuredText
Raw Permalink Blame History

:github_url: hide
.. meta::
:keywords: text, input
.. _class_LineEdit:
LineEdit
========
**Eredita:** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
Un campo di input per testo su una sola riga.
.. rst-class:: classref-introduction-group
Descrizione
----------------------
**LineEdit** fornisce un campo di input per modificare una singola riga di testo.
- Quando il controllo **LineEdit** è focalizzato usando i tasti freccia della tastiera, otterrà solo il focus e non entrerà in modalità di modifica.
- Per entrare in modalità di modifica, clicca sul controllo con il mouse, vedi anche :ref:`keep_editing_on_text_submit<class_LineEdit_property_keep_editing_on_text_submit>`.
- Per uscire dalla modalità di modifica, premi ``ui_text_submit`` o ``ui_cancel`` (come predefinito le azioni con :kbd:`Escape`).
- Consulta :ref:`edit()<class_LineEdit_method_edit>`, :ref:`unedit()<class_LineEdit_method_unedit>`, :ref:`is_editing()<class_LineEdit_method_is_editing>` e :ref:`editing_toggled<class_LineEdit_signal_editing_toggled>` per maggiori informazioni.
Durante l'inserimento del testo, è possibile inserire caratteri speciali attraverso i codici alt Unicode, OEM o Windows:
- Per inserire codici Unicode, tenere premuto :kbd:`Alt` e digitare il codice sul tastierino numerico. Ad esempio, per inserire il carattere ``á`` (U+00E1), tenere premuto :kbd:`Alt` e digitare :kbd:`+E1` sul tastierino numerico (gli zeri iniziali si possono omettere).
- Per inserire codici OEM, tenere premuto :kbd:`Alt` e digitare il codice sul tastierino numerico. Ad esempio, per inserire il carattere ``á`` (OEM 160), tenere premuto :kbd:`Alt` e digitare ``160`` sul tastierino numerico.
- Per inserire i codici Windows, tenere premuto :kbd:`Alt` e digitare il codice sul tastierino numerico. Ad esempio, per inserire il carattere ``á`` (Windows 0225), tenere premuto :kbd:`Alt` e digitare :kbd:`0`, :kbd:`2`, :kbd:`2`, :kbd:`5` sul tastierino numerico. Lo zero iniziale qui **non** si deve omettere, poiché è questo il modo in cui i codici di Windows si distinguono dai codici OEM.
\ **Importante:**\
- Ottenere il focus del **LineEdit** con ``ui_focus_next`` (predefinito su :kbd:`Tab`) o ``ui_focus_prev`` (predefinito su :kbd:`Maiusc + Tab`) o :ref:`Control.grab_focus()<class_Control_method_grab_focus>` attiva comunque la modalità di modifica (per compatibilità).
\ **LineEdit** fornisce un campo di input per modificare una singola riga di testo. Include molte scorciatoie integrate che sono sempre disponibili (:kbd:`Ctrl` qui corrisponde a :kbd:`Cmd` su macOS):
- :kbd:`Ctrl + C`: copia
- :kbd:`Ctrl + X`: taglia
- :kbd:`Ctrl + V` o :kbd:`Ctrl + Y`: incolla/"strappa"
- :kbd:`Ctrl + Z`: annulla
- :kbd:`Ctrl + ~`: inverti la direzione di input.
- :kbd:`Ctrl + Maiusc + Z`: ripeti
- :kbd:`Ctrl + U`: elimina il testo dalla posizione del cursore all'inizio della riga
- :kbd:`Ctrl + K`: elimina il testo dalla posizione del cursore alla fine della riga
- :kbd:`Ctrl + A`: seleziona tutto il testo
- :kbd:`Freccia su`/:kbd:`Freccia giù`: sposta il cursore all'inizio/fine della riga
Su macOS sono disponibili alcune scorciatoie da tastiera aggiuntive:
- :kbd:`Cmd + F`: uguale a :kbd:`Freccia destra`, sposta il cursore di un carattere a destra
- :kbd:`Cmd + B`: uguale a :kbd:`Freccia sinistra`, sposta il cursore di un carattere a sinistra
- :kbd:`Cmd + P`: uguale a :kbd:`Freccia su`, sposta il cursore alla riga precedente
- :kbd:`Cmd + N`: uguale a :kbd:`Freccia giù`, sposta il cursore alla riga successiva
- :kbd:`Cmd + D`: uguale a :kbd:`Elimina`, elimina il carattere sul lato destro del cursore
- :kbd:`Cmd + H`: uguale a :kbd:`Backspace`, elimina il carattere sul lato sinistro del cursore
- :kbd:`Cmd + A`: uguale a :kbd:`Home`, sposta il cursore all'inizio della riga
- :kbd:`Cmd + E`: uguale a :kbd:`End`, sposta il cursore alla fine della riga
- :kbd:`Cmd + Freccia sinistra`: uguale a :kbd:`Home`, sposta il cursore all'inizio della riga
- :kbd:`Cmd + Freccia destra`: uguale a :kbd:`End`, sposta il cursore alla fine della riga
\ **Nota:** Le scorciatoie per il movimento del cursore elencate sopra non sono influenzate da :ref:`shortcut_keys_enabled<class_LineEdit_property_shortcut_keys_enabled>`.
.. rst-class:: classref-reftable-group
Proprietà
------------------
.. table::
:widths: auto
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` | :ref:`alignment<class_LineEdit_property_alignment>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`backspace_deletes_composite_character_enabled<class_LineEdit_property_backspace_deletes_composite_character_enabled>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`caret_blink<class_LineEdit_property_caret_blink>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`caret_blink_interval<class_LineEdit_property_caret_blink_interval>` | ``0.65`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`caret_column<class_LineEdit_property_caret_column>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`caret_force_displayed<class_LineEdit_property_caret_force_displayed>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`caret_mid_grapheme<class_LineEdit_property_caret_mid_grapheme>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`clear_button_enabled<class_LineEdit_property_clear_button_enabled>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`context_menu_enabled<class_LineEdit_property_context_menu_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`deselect_on_focus_loss_enabled<class_LineEdit_property_deselect_on_focus_loss_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`drag_and_drop_selection_enabled<class_LineEdit_property_drag_and_drop_selection_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`draw_control_chars<class_LineEdit_property_draw_control_chars>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`editable<class_LineEdit_property_editable>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`emoji_menu_enabled<class_LineEdit_property_emoji_menu_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`expand_to_text_length<class_LineEdit_property_expand_to_text_length>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`flat<class_LineEdit_property_flat>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`FocusMode<enum_Control_FocusMode>` | focus_mode | ``2`` (overrides :ref:`Control<class_Control_property_focus_mode>`) |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`ExpandMode<enum_LineEdit_ExpandMode>` | :ref:`icon_expand_mode<class_LineEdit_property_icon_expand_mode>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`keep_editing_on_text_submit<class_LineEdit_property_keep_editing_on_text_submit>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`language<class_LineEdit_property_language>` | ``""`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`max_length<class_LineEdit_property_max_length>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`middle_mouse_paste_enabled<class_LineEdit_property_middle_mouse_paste_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`CursorShape<enum_Control_CursorShape>` | mouse_default_cursor_shape | ``1`` (overrides :ref:`Control<class_Control_property_mouse_default_cursor_shape>`) |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`placeholder_text<class_LineEdit_property_placeholder_text>` | ``""`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`right_icon<class_LineEdit_property_right_icon>` | |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`right_icon_scale<class_LineEdit_property_right_icon_scale>` | ``1.0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`secret<class_LineEdit_property_secret>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`secret_character<class_LineEdit_property_secret_character>` | ``"•"`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`select_all_on_focus<class_LineEdit_property_select_all_on_focus>` | ``false`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`selecting_enabled<class_LineEdit_property_selecting_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`shortcut_keys_enabled<class_LineEdit_property_shortcut_keys_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` | :ref:`structured_text_bidi_override<class_LineEdit_property_structured_text_bidi_override>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`Array<class_Array>` | :ref:`structured_text_bidi_override_options<class_LineEdit_property_structured_text_bidi_override_options>` | ``[]`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`text<class_LineEdit_property_text>` | ``""`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`text_direction<class_LineEdit_property_text_direction>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`virtual_keyboard_enabled<class_LineEdit_property_virtual_keyboard_enabled>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`virtual_keyboard_show_on_focus<class_LineEdit_property_virtual_keyboard_show_on_focus>` | ``true`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| :ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` | :ref:`virtual_keyboard_type<class_LineEdit_property_virtual_keyboard_type>` | ``0`` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Metodi
------------
.. table::
:widths: auto
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`apply_ime<class_LineEdit_method_apply_ime>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`cancel_ime<class_LineEdit_method_cancel_ime>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`clear<class_LineEdit_method_clear>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`delete_char_at_caret<class_LineEdit_method_delete_char_at_caret>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`delete_text<class_LineEdit_method_delete_text>`\ (\ from_column\: :ref:`int<class_int>`, to_column\: :ref:`int<class_int>`\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`deselect<class_LineEdit_method_deselect>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`edit<class_LineEdit_method_edit>`\ (\ hide_focus\: :ref:`bool<class_bool>` = false\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`PopupMenu<class_PopupMenu>` | :ref:`get_menu<class_LineEdit_method_get_menu>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_next_composite_character_column<class_LineEdit_method_get_next_composite_character_column>`\ (\ column\: :ref:`int<class_int>`\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_previous_composite_character_column<class_LineEdit_method_get_previous_composite_character_column>`\ (\ column\: :ref:`int<class_int>`\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_scroll_offset<class_LineEdit_method_get_scroll_offset>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`get_selected_text<class_LineEdit_method_get_selected_text>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_selection_from_column<class_LineEdit_method_get_selection_from_column>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_selection_to_column<class_LineEdit_method_get_selection_to_column>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_ime_text<class_LineEdit_method_has_ime_text>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_redo<class_LineEdit_method_has_redo>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_selection<class_LineEdit_method_has_selection>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_undo<class_LineEdit_method_has_undo>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`insert_text_at_caret<class_LineEdit_method_insert_text_at_caret>`\ (\ text\: :ref:`String<class_String>`\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_editing<class_LineEdit_method_is_editing>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_menu_visible<class_LineEdit_method_is_menu_visible>`\ (\ ) |const| |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`menu_option<class_LineEdit_method_menu_option>`\ (\ option\: :ref:`int<class_int>`\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`select<class_LineEdit_method_select>`\ (\ from\: :ref:`int<class_int>` = 0, to\: :ref:`int<class_int>` = -1\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`select_all<class_LineEdit_method_select_all>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`unedit<class_LineEdit_method_unedit>`\ (\ ) |
+-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Proprietà del tema
------------------------------------
.. table::
:widths: auto
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`caret_color<class_LineEdit_theme_color_caret_color>` | ``Color(0.95, 0.95, 0.95, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`clear_button_color<class_LineEdit_theme_color_clear_button_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`clear_button_color_pressed<class_LineEdit_theme_color_clear_button_color_pressed>` | ``Color(1, 1, 1, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_color<class_LineEdit_theme_color_font_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_outline_color<class_LineEdit_theme_color_font_outline_color>` | ``Color(0, 0, 0, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_placeholder_color<class_LineEdit_theme_color_font_placeholder_color>` | ``Color(0.875, 0.875, 0.875, 0.6)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_selected_color<class_LineEdit_theme_color_font_selected_color>` | ``Color(1, 1, 1, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_uneditable_color<class_LineEdit_theme_color_font_uneditable_color>` | ``Color(0.875, 0.875, 0.875, 0.5)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Color<class_Color>` | :ref:`selection_color<class_LineEdit_theme_color_selection_color>` | ``Color(0.5, 0.5, 0.5, 1)`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`int<class_int>` | :ref:`caret_width<class_LineEdit_theme_constant_caret_width>` | ``1`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`int<class_int>` | :ref:`minimum_character_width<class_LineEdit_theme_constant_minimum_character_width>` | ``4`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`int<class_int>` | :ref:`outline_size<class_LineEdit_theme_constant_outline_size>` | ``0`` |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Font<class_Font>` | :ref:`font<class_LineEdit_theme_font_font>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`int<class_int>` | :ref:`font_size<class_LineEdit_theme_font_size_font_size>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`clear<class_LineEdit_theme_icon_clear>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_LineEdit_theme_style_focus>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`normal<class_LineEdit_theme_style_normal>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`read_only<class_LineEdit_theme_style_read_only>` | |
+-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Segnali
--------------
.. _class_LineEdit_signal_editing_toggled:
.. rst-class:: classref-signal
**editing_toggled**\ (\ toggled_on\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_LineEdit_signal_editing_toggled>`
Emesso quando il **LineEdit** entra o esce dalla modalità modifica.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_signal_text_change_rejected:
.. rst-class:: classref-signal
**text_change_rejected**\ (\ rejected_substring\: :ref:`String<class_String>`\ ) :ref:`🔗<class_LineEdit_signal_text_change_rejected>`
Emesso quando si aggiunge del testo che supera il valore di :ref:`max_length<class_LineEdit_property_max_length>`. Il testo aggiunto viene troncato per adattarsi a :ref:`max_length<class_LineEdit_property_max_length>` e la parte che non è riuscita a adattarsi viene passata come argomento ``rejected_substring``.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_signal_text_changed:
.. rst-class:: classref-signal
**text_changed**\ (\ new_text\: :ref:`String<class_String>`\ ) :ref:`🔗<class_LineEdit_signal_text_changed>`
Emesso quando il testo cambia.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_signal_text_submitted:
.. rst-class:: classref-signal
**text_submitted**\ (\ new_text\: :ref:`String<class_String>`\ ) :ref:`🔗<class_LineEdit_signal_text_submitted>`
Emesso quando l'utente preme l'azione ``ui_text_submit`` (predefinito: :kbd:`Invio` o :kbd:`Kp Invio`) mentre **LineEdit** ha il focus.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Enumerazioni
------------------------
.. _enum_LineEdit_MenuItems:
.. rst-class:: classref-enumeration
enum **MenuItems**: :ref:`🔗<enum_LineEdit_MenuItems>`
.. _class_LineEdit_constant_MENU_CUT:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_CUT** = ``0``
Taglia (copia e cancella) il testo selezionato.
.. _class_LineEdit_constant_MENU_COPY:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_COPY** = ``1``
Copia il testo selezionato.
.. _class_LineEdit_constant_MENU_PASTE:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_PASTE** = ``2``
Incolla il testo negli appunti sul testo selezionato (o nella posizione del cursore).
I caratteri di escape non stampabili sono automaticamente rimossi dagli appunti del sistema operativo tramite :ref:`String.strip_escapes()<class_String_method_strip_escapes>`.
.. _class_LineEdit_constant_MENU_CLEAR:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_CLEAR** = ``3``
Cancella tutto il testo del **LineEdit**.
.. _class_LineEdit_constant_MENU_SELECT_ALL:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_SELECT_ALL** = ``4``
Seleziona tutto il testo del **LineEdit**.
.. _class_LineEdit_constant_MENU_UNDO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_UNDO** = ``5``
Annulla l'azione precedente.
.. _class_LineEdit_constant_MENU_REDO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_REDO** = ``6``
Inverte l'ultima azione annullata.
.. _class_LineEdit_constant_MENU_SUBMENU_TEXT_DIR:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_SUBMENU_TEXT_DIR** = ``7``
ID del sottomenù "Direzione di scrittura del testo".
.. _class_LineEdit_constant_MENU_DIR_INHERITED:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DIR_INHERITED** = ``8``
Imposta la direzione del testo a ereditata.
.. _class_LineEdit_constant_MENU_DIR_AUTO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DIR_AUTO** = ``9``
Imposta la direzione del testo ad automatico.
.. _class_LineEdit_constant_MENU_DIR_LTR:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DIR_LTR** = ``10``
Imposta la direzione del testo da sinistra a destra.
.. _class_LineEdit_constant_MENU_DIR_RTL:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DIR_RTL** = ``11``
Imposta la direzione del testo da destra a sinistra.
.. _class_LineEdit_constant_MENU_DISPLAY_UCC:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_DISPLAY_UCC** = ``12``
Commuta la visualizzazione dei caratteri di controllo.
.. _class_LineEdit_constant_MENU_SUBMENU_INSERT_UCC:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_SUBMENU_INSERT_UCC** = ``13``
ID del sottomenù "Inserisci carattere di controllo".
.. _class_LineEdit_constant_MENU_INSERT_LRM:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_LRM** = ``14``
Inserisce il carattere di marcatura da sinistra a destra (LRM).
.. _class_LineEdit_constant_MENU_INSERT_RLM:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_RLM** = ``15``
Inserisce il carattere di marcatura da destra a sinistra (RLM).
.. _class_LineEdit_constant_MENU_INSERT_LRE:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_LRE** = ``16``
Inserisce il carattere di inizio dell'incorporamento da sinistra a destra (LRE).
.. _class_LineEdit_constant_MENU_INSERT_RLE:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_RLE** = ``17``
Inserisce il carattere di inizio dell'incorporamento da destra a sinistra (RLE).
.. _class_LineEdit_constant_MENU_INSERT_LRO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_LRO** = ``18``
Inserisce il carattere di inizio di sostituzione da sinistra a destra (LRO).
.. _class_LineEdit_constant_MENU_INSERT_RLO:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_RLO** = ``19``
Inserisce il carattere di inizio di sostituzione da destra a sinistra (RLO).
.. _class_LineEdit_constant_MENU_INSERT_PDF:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_PDF** = ``20``
Inserisce il carattere di termine della formattazione della direzione (PDF).
.. _class_LineEdit_constant_MENU_INSERT_ALM:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_ALM** = ``21``
Inserisce il carattere di marcatura di lettera araba (ALM).
.. _class_LineEdit_constant_MENU_INSERT_LRI:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_LRI** = ``22``
Inserisce un carattere di isolamento da sinistra a destra (LRI).
.. _class_LineEdit_constant_MENU_INSERT_RLI:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_RLI** = ``23``
Inserisce un carattere di isolamento da destra a sinistra (RLI).
.. _class_LineEdit_constant_MENU_INSERT_FSI:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_FSI** = ``24``
Inserisce il carattere di primo isolamento forte (FSI).
.. _class_LineEdit_constant_MENU_INSERT_PDI:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_PDI** = ``25``
Inserisce il carattere di isolamento di termine della direzione (PDI).
.. _class_LineEdit_constant_MENU_INSERT_ZWJ:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_ZWJ** = ``26``
Inserisce il carattere di unione di larghezza zero (ZWJ).
.. _class_LineEdit_constant_MENU_INSERT_ZWNJ:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_ZWNJ** = ``27``
Inserisce il carattere di non unione di larghezza zero (ZWNJ).
.. _class_LineEdit_constant_MENU_INSERT_WJ:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_WJ** = ``28``
Inserisce il carattere di unione delle parole (WJ).
.. _class_LineEdit_constant_MENU_INSERT_SHY:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_INSERT_SHY** = ``29``
Inserisce il carattere trattino morbido (SHY).
.. _class_LineEdit_constant_MENU_EMOJI_AND_SYMBOL:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_EMOJI_AND_SYMBOL** = ``30``
Apre il selettore di emoji e simboli del sistema.
.. _class_LineEdit_constant_MENU_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`MenuItems<enum_LineEdit_MenuItems>` **MENU_MAX** = ``31``
Rappresenta la dimensione dell'enumerazione :ref:`MenuItems<enum_LineEdit_MenuItems>`.
.. rst-class:: classref-item-separator
----
.. _enum_LineEdit_VirtualKeyboardType:
.. rst-class:: classref-enumeration
enum **VirtualKeyboardType**: :ref:`🔗<enum_LineEdit_VirtualKeyboardType>`
.. _class_LineEdit_constant_KEYBOARD_TYPE_DEFAULT:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_DEFAULT** = ``0``
Tastiera virtuale di testo predefinita.
.. _class_LineEdit_constant_KEYBOARD_TYPE_MULTILINE:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_MULTILINE** = ``1``
Tastiera virtuale multilinea.
.. _class_LineEdit_constant_KEYBOARD_TYPE_NUMBER:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_NUMBER** = ``2``
Tastierino numerico virtuale, utile per l'inserimento del PIN.
.. _class_LineEdit_constant_KEYBOARD_TYPE_NUMBER_DECIMAL:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_NUMBER_DECIMAL** = ``3``
Tastierino numerico virtuale, utile per inserire numeri frazionari.
.. _class_LineEdit_constant_KEYBOARD_TYPE_PHONE:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_PHONE** = ``4``
Tastiera virtuale per numeri di telefono.
.. _class_LineEdit_constant_KEYBOARD_TYPE_EMAIL_ADDRESS:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_EMAIL_ADDRESS** = ``5``
Tastiera virtuale con tasti aggiuntivi per facilitare la digitazione degli indirizzi e-mail.
.. _class_LineEdit_constant_KEYBOARD_TYPE_PASSWORD:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_PASSWORD** = ``6``
Tastiera virtuale per immettere una password. Sulla maggior parte delle piattaforme, questo dovrebbe disattivare il completamento automatico e l'autocapitalizzazione.
\ **Nota:** Questo non è supportato sul Web. Invece, si comporta in modo identico a :ref:`KEYBOARD_TYPE_DEFAULT<class_LineEdit_constant_KEYBOARD_TYPE_DEFAULT>`.
.. _class_LineEdit_constant_KEYBOARD_TYPE_URL:
.. rst-class:: classref-enumeration-constant
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **KEYBOARD_TYPE_URL** = ``7``
Tastiera virtuale con tasti aggiuntivi per facilitare la digitazione degli URL.
.. rst-class:: classref-item-separator
----
.. _enum_LineEdit_ExpandMode:
.. rst-class:: classref-enumeration
enum **ExpandMode**: :ref:`🔗<enum_LineEdit_ExpandMode>`
.. _class_LineEdit_constant_EXPAND_MODE_ORIGINAL_SIZE:
.. rst-class:: classref-enumeration-constant
:ref:`ExpandMode<enum_LineEdit_ExpandMode>` **EXPAND_MODE_ORIGINAL_SIZE** = ``0``
Use the original size for the right icon.
.. _class_LineEdit_constant_EXPAND_MODE_FIT_TO_TEXT:
.. rst-class:: classref-enumeration-constant
:ref:`ExpandMode<enum_LineEdit_ExpandMode>` **EXPAND_MODE_FIT_TO_TEXT** = ``1``
Scale the right icon's size to match the size of the text.
.. _class_LineEdit_constant_EXPAND_MODE_FIT_TO_LINE_EDIT:
.. rst-class:: classref-enumeration-constant
:ref:`ExpandMode<enum_LineEdit_ExpandMode>` **EXPAND_MODE_FIT_TO_LINE_EDIT** = ``2``
Scale the right icon to fit the LineEdit.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà
------------------------------------------------------
.. _class_LineEdit_property_alignment:
.. rst-class:: classref-property
:ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **alignment** = ``0`` :ref:`🔗<class_LineEdit_property_alignment>`
.. rst-class:: classref-property-setget
- |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>`\ )
- :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **get_horizontal_alignment**\ (\ )
The text's horizontal alignment.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_backspace_deletes_composite_character_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **backspace_deletes_composite_character_enabled** = ``false`` :ref:`🔗<class_LineEdit_property_backspace_deletes_composite_character_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_backspace_deletes_composite_character_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_backspace_deletes_composite_character_enabled**\ (\ )
Se ``true`` e :ref:`caret_mid_grapheme<class_LineEdit_property_caret_mid_grapheme>` è ``false``, il tasto backspace elimina un intero carattere composto, ad esempio ❤️‍🩹, anziché eliminare parte del carattere composto.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_blink:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **caret_blink** = ``false`` :ref:`🔗<class_LineEdit_property_caret_blink>`
.. rst-class:: classref-property-setget
- |void| **set_caret_blink_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_caret_blink_enabled**\ (\ )
Se ``true``, fa lampeggiare il cursore.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_blink_interval:
.. rst-class:: classref-property
:ref:`float<class_float>` **caret_blink_interval** = ``0.65`` :ref:`🔗<class_LineEdit_property_caret_blink_interval>`
.. rst-class:: classref-property-setget
- |void| **set_caret_blink_interval**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_caret_blink_interval**\ (\ )
L'intervallo con il quale il cursore lampeggia (in secondi).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_column:
.. rst-class:: classref-property
:ref:`int<class_int>` **caret_column** = ``0`` :ref:`🔗<class_LineEdit_property_caret_column>`
.. rst-class:: classref-property-setget
- |void| **set_caret_column**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_caret_column**\ (\ )
La posizione della colonna del cursore all'interno del **LineEdit**. Se impostata, il testo potrebbe scorrere per adattarsi.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_force_displayed:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **caret_force_displayed** = ``false`` :ref:`🔗<class_LineEdit_property_caret_force_displayed>`
.. rst-class:: classref-property-setget
- |void| **set_caret_force_displayed**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_caret_force_displayed**\ (\ )
Se ``true``, il **LineEdit** mostrerà sempre il cursore di testo, anche se non è in fase di modifica o il focus viene perso.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_caret_mid_grapheme:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **caret_mid_grapheme** = ``false`` :ref:`🔗<class_LineEdit_property_caret_mid_grapheme>`
.. rst-class:: classref-property-setget
- |void| **set_caret_mid_grapheme_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_caret_mid_grapheme_enabled**\ (\ )
Consente lo spostamento del cursore, la selezione e la rimozione dei singoli componenti di un carattere composito.
\ **Nota:** :kbd:`Backspace` rimuove sempre i singoli componenti di un carattere composito.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_clear_button_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **clear_button_enabled** = ``false`` :ref:`🔗<class_LineEdit_property_clear_button_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_clear_button_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_clear_button_enabled**\ (\ )
Se ``true``, il **LineEdit** mostrerà un pulsante di cancellazione se :ref:`text<class_LineEdit_property_text>` non è vuoto, che può essere utilizzato per cancellare rapidamente il testo.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_context_menu_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **context_menu_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_context_menu_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_context_menu_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_context_menu_enabled**\ (\ )
Se ``true``, il menu contestuale apparirà quando si clicca con il pulsante destro del mouse.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_deselect_on_focus_loss_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **deselect_on_focus_loss_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_deselect_on_focus_loss_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_deselect_on_focus_loss_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_deselect_on_focus_loss_enabled**\ (\ )
Se ``true``, il testo selezionato verrà deselezionato quando si perde il focus.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_drag_and_drop_selection_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **drag_and_drop_selection_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_drag_and_drop_selection_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_drag_and_drop_selection_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_drag_and_drop_selection_enabled**\ (\ )
Se ``true``, consente di trascinare e rilasciare il testo selezionato.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_draw_control_chars:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **draw_control_chars** = ``false`` :ref:`🔗<class_LineEdit_property_draw_control_chars>`
.. rst-class:: classref-property-setget
- |void| **set_draw_control_chars**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_draw_control_chars**\ (\ )
Se ``true``, i caratteri di controllo sono visualizzati.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_editable:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **editable** = ``true`` :ref:`🔗<class_LineEdit_property_editable>`
.. rst-class:: classref-property-setget
- |void| **set_editable**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_editable**\ (\ )
Se ``false``, non è possibile modificare il testo esistente o aggiungere nuovo testo.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_emoji_menu_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **emoji_menu_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_emoji_menu_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_emoji_menu_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_emoji_menu_enabled**\ (\ )
Se ``true``, il menu "Emoji e simboli" è abilitato.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_expand_to_text_length:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **expand_to_text_length** = ``false`` :ref:`🔗<class_LineEdit_property_expand_to_text_length>`
.. rst-class:: classref-property-setget
- |void| **set_expand_to_text_length_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_expand_to_text_length_enabled**\ (\ )
Se ``true``, la larghezza del **LineEdit** aumenterà per rimanere più lunga del :ref:`text<class_LineEdit_property_text>`. **Non** verrà compresso se il :ref:`text<class_LineEdit_property_text>` viene accorciato.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_flat:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **flat** = ``false`` :ref:`🔗<class_LineEdit_property_flat>`
.. rst-class:: classref-property-setget
- |void| **set_flat**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_flat**\ (\ )
Se ``true``, la **LineEdit** non visualizza decorazioni.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_icon_expand_mode:
.. rst-class:: classref-property
:ref:`ExpandMode<enum_LineEdit_ExpandMode>` **icon_expand_mode** = ``0`` :ref:`🔗<class_LineEdit_property_icon_expand_mode>`
.. rst-class:: classref-property-setget
- |void| **set_icon_expand_mode**\ (\ value\: :ref:`ExpandMode<enum_LineEdit_ExpandMode>`\ )
- :ref:`ExpandMode<enum_LineEdit_ExpandMode>` **get_icon_expand_mode**\ (\ )
Define the scaling behavior of the :ref:`right_icon<class_LineEdit_property_right_icon>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_keep_editing_on_text_submit:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **keep_editing_on_text_submit** = ``false`` :ref:`🔗<class_LineEdit_property_keep_editing_on_text_submit>`
.. rst-class:: classref-property-setget
- |void| **set_keep_editing_on_text_submit**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_editing_kept_on_text_submit**\ (\ )
Se ``true``, il **LineEdit** non uscirà dalla modalità di modifica quando il testo viene inviato premendo l'azione ``ui_text_submit`` (predefinito: :kbd:`Invio` o :kbd:`Kp Invio`).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_language:
.. rst-class:: classref-property
:ref:`String<class_String>` **language** = ``""`` :ref:`🔗<class_LineEdit_property_language>`
.. rst-class:: classref-property-setget
- |void| **set_language**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_language**\ (\ )
Language code used for line-breaking and text shaping algorithms. If left empty, the current locale is used instead.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_max_length:
.. rst-class:: classref-property
:ref:`int<class_int>` **max_length** = ``0`` :ref:`🔗<class_LineEdit_property_max_length>`
.. rst-class:: classref-property-setget
- |void| **set_max_length**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_max_length**\ (\ )
Numero massimo di caratteri che è possibile inserire nel **LineEdit**. Se ``0``, non c'è limite.
Quando è definito un limite, i caratteri che supererebbero :ref:`max_length<class_LineEdit_property_max_length>` vengono troncati. Ciò accade sia per il contenuto di :ref:`text<class_LineEdit_property_text>` esistente quando si imposta la lunghezza massima, sia per nuovo testo inserito nel **LineEdit**, anche tramite copia-incolla.
Se del testo inserito viene troncato, il segnale :ref:`text_change_rejected<class_LineEdit_signal_text_change_rejected>` viene emesso con la sottostringa troncata come parametro.
.. tabs::
.. code-tab:: gdscript
text = "Hello world"
max_length = 5
# `text` diventa "Hello".
max_length = 10
text += " goodbye"
# `text` diventa "Hello good".
# `text_change_rejected` viene emesso con "bye" come parametro.
.. code-tab:: csharp
Text = "Hello world";
MaxLength = 5;
// `Text` diventa "Hello".
MaxLength = 10;
Text += " goodbye";
// `Text` diventa "Hello good".
// `text_change_rejected` viene emesso con "bye" come parametro.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_middle_mouse_paste_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **middle_mouse_paste_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_middle_mouse_paste_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_middle_mouse_paste_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_middle_mouse_paste_enabled**\ (\ )
Se ``false``, l'uso del tasto centrale del mouse per incollare gli appunti sarà disabilitato.
\ **Nota:** Questo metodo è implementato solo su Linux.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_placeholder_text:
.. rst-class:: classref-property
:ref:`String<class_String>` **placeholder_text** = ``""`` :ref:`🔗<class_LineEdit_property_placeholder_text>`
.. rst-class:: classref-property-setget
- |void| **set_placeholder**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_placeholder**\ (\ )
Testo visualizzato quando il **LineEdit** è vuoto. **Non** è il valore predefinito del **LineEdit** (vedi :ref:`text<class_LineEdit_property_text>`).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_right_icon:
.. rst-class:: classref-property
:ref:`Texture2D<class_Texture2D>` **right_icon** :ref:`🔗<class_LineEdit_property_right_icon>`
.. rst-class:: classref-property-setget
- |void| **set_right_icon**\ (\ value\: :ref:`Texture2D<class_Texture2D>`\ )
- :ref:`Texture2D<class_Texture2D>` **get_right_icon**\ (\ )
Imposta l'icona che apparirà all'estremità destra di **LineEdit** se :ref:`text<class_LineEdit_property_text>` non è presente, o sempre, se :ref:`clear_button_enabled<class_LineEdit_property_clear_button_enabled>` è impostato su ``false``.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_right_icon_scale:
.. rst-class:: classref-property
:ref:`float<class_float>` **right_icon_scale** = ``1.0`` :ref:`🔗<class_LineEdit_property_right_icon_scale>`
.. rst-class:: classref-property-setget
- |void| **set_right_icon_scale**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_right_icon_scale**\ (\ )
Scale ratio of the icon when :ref:`icon_expand_mode<class_LineEdit_property_icon_expand_mode>` is set to :ref:`EXPAND_MODE_FIT_TO_LINE_EDIT<class_LineEdit_constant_EXPAND_MODE_FIT_TO_LINE_EDIT>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_secret:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **secret** = ``false`` :ref:`🔗<class_LineEdit_property_secret>`
.. rst-class:: classref-property-setget
- |void| **set_secret**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_secret**\ (\ )
Se ``true``, ogni carattere è sostituito con il carattere segreto (vedi :ref:`secret_character<class_LineEdit_property_secret_character>`).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_secret_character:
.. rst-class:: classref-property
:ref:`String<class_String>` **secret_character** = ``"•"`` :ref:`🔗<class_LineEdit_property_secret_character>`
.. rst-class:: classref-property-setget
- |void| **set_secret_character**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_secret_character**\ (\ )
Il carattere da usare per mascherare l'input segreto. Solo un singolo carattere può essere usato come carattere segreto. Se è più lungo di un carattere, sarà usato solo il primo. Se è vuoto, sarà usato uno spazio.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_select_all_on_focus:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **select_all_on_focus** = ``false`` :ref:`🔗<class_LineEdit_property_select_all_on_focus>`
.. rst-class:: classref-property-setget
- |void| **set_select_all_on_focus**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_select_all_on_focus**\ (\ )
Se ``true``, il **LineEdit** selezionerà tutto il testo quando ottiene il focus.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_selecting_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **selecting_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_selecting_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_selecting_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_selecting_enabled**\ (\ )
Se ``false``, è impossibile selezionare il testo utilizzando il mouse o la tastiera.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_shortcut_keys_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **shortcut_keys_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_shortcut_keys_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_shortcut_keys_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_shortcut_keys_enabled**\ (\ )
Se ``true``, le scorciatoie da tastiera per le voci del menu contestuale sono abilitate, anche se il menu contestuale è disabilitato.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_structured_text_bidi_override:
.. rst-class:: classref-property
:ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **structured_text_bidi_override** = ``0`` :ref:`🔗<class_LineEdit_property_structured_text_bidi_override>`
.. rst-class:: classref-property-setget
- |void| **set_structured_text_bidi_override**\ (\ value\: :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>`\ )
- :ref:`StructuredTextParser<enum_TextServer_StructuredTextParser>` **get_structured_text_bidi_override**\ (\ )
Imposta la sostituzione dell'algoritmo BiDi per il testo strutturato.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_structured_text_bidi_override_options:
.. rst-class:: classref-property
:ref:`Array<class_Array>` **structured_text_bidi_override_options** = ``[]`` :ref:`🔗<class_LineEdit_property_structured_text_bidi_override_options>`
.. rst-class:: classref-property-setget
- |void| **set_structured_text_bidi_override_options**\ (\ value\: :ref:`Array<class_Array>`\ )
- :ref:`Array<class_Array>` **get_structured_text_bidi_override_options**\ (\ )
Imposta opzioni aggiuntive per la sostituzione BiDi.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_text:
.. rst-class:: classref-property
:ref:`String<class_String>` **text** = ``""`` :ref:`🔗<class_LineEdit_property_text>`
.. rst-class:: classref-property-setget
- |void| **set_text**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_text**\ (\ )
Valore della stringa di **LineEdit**.
\ **Nota:** La modifica del testo tramite questa proprietà non emetterà il segnale :ref:`text_changed<class_LineEdit_signal_text_changed>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_text_direction:
.. rst-class:: classref-property
:ref:`TextDirection<enum_Control_TextDirection>` **text_direction** = ``0`` :ref:`🔗<class_LineEdit_property_text_direction>`
.. rst-class:: classref-property-setget
- |void| **set_text_direction**\ (\ value\: :ref:`TextDirection<enum_Control_TextDirection>`\ )
- :ref:`TextDirection<enum_Control_TextDirection>` **get_text_direction**\ (\ )
Direzione di scrittura del testo di base.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_virtual_keyboard_enabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **virtual_keyboard_enabled** = ``true`` :ref:`🔗<class_LineEdit_property_virtual_keyboard_enabled>`
.. rst-class:: classref-property-setget
- |void| **set_virtual_keyboard_enabled**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_virtual_keyboard_enabled**\ (\ )
Se ``true``, la tastiera virtuale nativa è abilitata sulle piattaforme che la supportano.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_virtual_keyboard_show_on_focus:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **virtual_keyboard_show_on_focus** = ``true`` :ref:`🔗<class_LineEdit_property_virtual_keyboard_show_on_focus>`
.. rst-class:: classref-property-setget
- |void| **set_virtual_keyboard_show_on_focus**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_virtual_keyboard_show_on_focus**\ (\ )
Se ``true``, la tastiera virtuale nativa è mostrata dopo eventi di focus sulle piattaforme che la supportano.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_property_virtual_keyboard_type:
.. rst-class:: classref-property
:ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **virtual_keyboard_type** = ``0`` :ref:`🔗<class_LineEdit_property_virtual_keyboard_type>`
.. rst-class:: classref-property-setget
- |void| **set_virtual_keyboard_type**\ (\ value\: :ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>`\ )
- :ref:`VirtualKeyboardType<enum_LineEdit_VirtualKeyboardType>` **get_virtual_keyboard_type**\ (\ )
Specifica il tipo di tastiera virtuale da visualizzare.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni dei metodi
--------------------------------------------
.. _class_LineEdit_method_apply_ime:
.. rst-class:: classref-method
|void| **apply_ime**\ (\ ) :ref:`🔗<class_LineEdit_method_apply_ime>`
Applica il testo dall'`Input Method Editor <https://en.wikipedia.org/wiki/Input_method>`__ (IME) e chiude l'IME se è aperto.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_cancel_ime:
.. rst-class:: classref-method
|void| **cancel_ime**\ (\ ) :ref:`🔗<class_LineEdit_method_cancel_ime>`
Chiude l'`Input Method Editor <https://en.wikipedia.org/wiki/Input_method>`__ (IME) se è aperto. Qualsiasi testo nell'IME sarà perso.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_clear:
.. rst-class:: classref-method
|void| **clear**\ (\ ) :ref:`🔗<class_LineEdit_method_clear>`
Cancella il :ref:`text<class_LineEdit_property_text>` di **LineEdit**.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_delete_char_at_caret:
.. rst-class:: classref-method
|void| **delete_char_at_caret**\ (\ ) :ref:`🔗<class_LineEdit_method_delete_char_at_caret>`
Elimina un carattere nella posizione attuale del cursore (equivalente a premere :kbd:`Cancella`).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_delete_text:
.. rst-class:: classref-method
|void| **delete_text**\ (\ from_column\: :ref:`int<class_int>`, to_column\: :ref:`int<class_int>`\ ) :ref:`🔗<class_LineEdit_method_delete_text>`
Elimina una sezione del :ref:`text<class_LineEdit_property_text>` che va dalla posizione ``from_column`` alla posizione ``to_column``. Entrambi i parametri devono rientrare nella lunghezza del testo.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_deselect:
.. rst-class:: classref-method
|void| **deselect**\ (\ ) :ref:`🔗<class_LineEdit_method_deselect>`
Cancella la selezione attuale.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_edit:
.. rst-class:: classref-method
|void| **edit**\ (\ hide_focus\: :ref:`bool<class_bool>` = false\ ) :ref:`🔗<class_LineEdit_method_edit>`
Allows entering edit mode whether the **LineEdit** is focused or not. If ``hide_focus`` is ``true``, the focused state will not be shown (see :ref:`Control.grab_focus()<class_Control_method_grab_focus>`).
See also :ref:`keep_editing_on_text_submit<class_LineEdit_property_keep_editing_on_text_submit>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_menu:
.. rst-class:: classref-method
:ref:`PopupMenu<class_PopupMenu>` **get_menu**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_get_menu>`
Restituisce il :ref:`PopupMenu<class_PopupMenu>` di questo **LineEdit**. Per impostazione predefinita, questo menu viene visualizzato quando si clicca con il pulsante destro del mouse sul **LineEdit**.
È possibile aggiungere voci di menu personalizzate o rimuovere quelle esistenti. Assicurarsi che gli ID non siano in conflitto con quelli esistenti (vedi :ref:`MenuItems<enum_LineEdit_MenuItems>`). Ad esempio:
.. tabs::
.. code-tab:: gdscript
func _ready():
var menu = get_menu()
# Rimuovi tutte le voci dopo "Ripeti".
menu.item_count = menu.get_item_index(MENU_REDO) + 1
# Aggiungi voci personalizzate.
menu.add_separator()
menu.add_item("Insert Date", MENU_MAX + 1)
# Connetti il callback.
menu.id_pressed.connect(_on_item_pressed)
func _on_item_pressed(id):
if id == MENU_MAX + 1:
insert_text_at_caret(Time.get_date_string_from_system())
.. code-tab:: csharp
public override void _Ready()
{
var menu = GetMenu();
// Rimuovi tutte le voci dopo "Ripeti".
menu.ItemCount = menu.GetItemIndex(LineEdit.MenuItems.Redo) + 1;
// Aggiungi voci personalizzate.
menu.AddSeparator();
menu.AddItem("Insert Date", LineEdit.MenuItems.Max + 1);
// Aggiungi il gestore dell'evento.
menu.IdPressed += OnItemPressed;
}
public void OnItemPressed(int id)
{
if (id == LineEdit.MenuItems.Max + 1)
{
InsertTextAtCaret(Time.GetDateStringFromSystem());
}
}
\ **Attenzione:** Questo è un nodo interno obbligatorio, rimuoverlo e liberarlo potrebbe causare un arresto anomalo. Se desideri nasconderlo o nascondere uno dei suoi figli, usa la loro proprietà :ref:`Window.visible<class_Window_property_visible>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_next_composite_character_column:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_next_composite_character_column**\ (\ column\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_LineEdit_method_get_next_composite_character_column>`
Restituisce la colonna corretta alla fine di un carattere composto come ❤️‍🩹 (cuore guarito; Unicode: ``U+2764 U+FE0F U+200D U+1FA79``) che è composto da più di un punto di codice Unicode, se il cursore si trova all'inizio del carattere composto. Restituisce anche la colonna corretta con il cursore a metà grafema e per i caratteri non composti.
\ **Nota:** Per verificare la posizione del cursore, utilizza ``get_next_composite_character_column(get_caret_column())``
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_previous_composite_character_column:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_previous_composite_character_column**\ (\ column\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_LineEdit_method_get_previous_composite_character_column>`
Restituisce la colonna corretta all'inizio di un carattere composto come ❤️‍🩹 (cuore guarito; Unicode: ``U+2764 U+FE0F U+200D U+1FA79``) che è composto da più di un punto di codice Unicode, se il cursore si trova alla fine del carattere composto. Restituisce anche la colonna corretta con il cursore a metà grafema e per i caratteri non composti.
\ **Nota:** Per verificare la posizione del cursore, utilizza ``get_previous_composite_character_column(get_caret_column())``
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_scroll_offset:
.. rst-class:: classref-method
:ref:`float<class_float>` **get_scroll_offset**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_get_scroll_offset>`
Restituisce lo scostamento di scorrimento dovuto a :ref:`caret_column<class_LineEdit_property_caret_column>`, come numero di caratteri.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_selected_text:
.. rst-class:: classref-method
:ref:`String<class_String>` **get_selected_text**\ (\ ) :ref:`🔗<class_LineEdit_method_get_selected_text>`
Restituisce il testo all'interno della selezione.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_selection_from_column:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_selection_from_column**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_get_selection_from_column>`
Restituisce la colonna di inizio della selezione.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_get_selection_to_column:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_selection_to_column**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_get_selection_to_column>`
Restituisce la colonna di fine della selezione.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_has_ime_text:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_ime_text**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_has_ime_text>`
Restituisce ``true`` se l'utente ha testo nell'`Input Method Editor <https://en.wikipedia.org/wiki/Input_method>`__ (IME).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_has_redo:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_redo**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_has_redo>`
Restituisce ``true`` se un'azione "ripeti" è disponibile.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_has_selection:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_selection**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_has_selection>`
Restituisce ``true`` se l'utente ha selezionato del testo.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_has_undo:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_undo**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_has_undo>`
Restituisce ``true`` se un'azione "annulla" è disponibile.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_insert_text_at_caret:
.. rst-class:: classref-method
|void| **insert_text_at_caret**\ (\ text\: :ref:`String<class_String>`\ ) :ref:`🔗<class_LineEdit_method_insert_text_at_caret>`
Inserisce ``text`` al cursore. Se il valore risultante è più lungo di :ref:`max_length<class_LineEdit_property_max_length>`, non succede nulla.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_is_editing:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_editing**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_is_editing>`
Restituisce se il **LineEdit** è in fase di modifica.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_is_menu_visible:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_menu_visible**\ (\ ) |const| :ref:`🔗<class_LineEdit_method_is_menu_visible>`
Restituisce se il menù è visibile. Usa questo invece di ``get_menu().visible`` per migliorare le prestazioni (in modo da evitare la creazione del menu).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_menu_option:
.. rst-class:: classref-method
|void| **menu_option**\ (\ option\: :ref:`int<class_int>`\ ) :ref:`🔗<class_LineEdit_method_menu_option>`
Esegue l'azione specificata come definito nell'enumerazione :ref:`MenuItems<enum_LineEdit_MenuItems>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_select:
.. rst-class:: classref-method
|void| **select**\ (\ from\: :ref:`int<class_int>` = 0, to\: :ref:`int<class_int>` = -1\ ) :ref:`🔗<class_LineEdit_method_select>`
Seleziona i caratteri all'interno del **LineEdit** tra ``from`` e ``to``. Per impostazione predefinita, ``from`` è all'inizio e ``to`` alla fine.
.. tabs::
.. code-tab:: gdscript
text = "Welcome"
select() # Selezionerà "Welcome".
select(4) # Selezionerà "ome".
select(2, 5) # Selezionerà "lco".
.. code-tab:: csharp
Text = "Welcome";
Select(); // Selezionerà "Welcome".
Select(4); // Selezionerà "ome".
Select(2, 5); // Selezionerà "lco".
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_select_all:
.. rst-class:: classref-method
|void| **select_all**\ (\ ) :ref:`🔗<class_LineEdit_method_select_all>`
Seleziona l'intera :ref:`String<class_String>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_method_unedit:
.. rst-class:: classref-method
|void| **unedit**\ (\ ) :ref:`🔗<class_LineEdit_method_unedit>`
Consente di uscire dalla modalità di modifica mantenendo il focus.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descrizioni delle proprietà del tema
------------------------------------------------------------------------
.. _class_LineEdit_theme_color_caret_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **caret_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗<class_LineEdit_theme_color_caret_color>`
Colore del cursore di testo del **LineEdit**. Può essere impostato su un colore completamente trasparente per nascondere totalmente il cursore.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_clear_button_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **clear_button_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_LineEdit_theme_color_clear_button_color>`
Colore utilizzato come tinta predefinita per il pulsante di cancellazione.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_clear_button_color_pressed:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **clear_button_color_pressed** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_LineEdit_theme_color_clear_button_color_pressed>`
Colore utilizzato per il pulsante di cancellazione quando è premuto.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_LineEdit_theme_color_font_color>`
Colore predefinito del font.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_outline_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_LineEdit_theme_color_font_outline_color>`
La tinta del contorno del testo del **LineEdit**.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_placeholder_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_placeholder_color** = ``Color(0.875, 0.875, 0.875, 0.6)`` :ref:`🔗<class_LineEdit_theme_color_font_placeholder_color>`
Colore del font per :ref:`placeholder_text<class_LineEdit_property_placeholder_text>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_selected_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_selected_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_LineEdit_theme_color_font_selected_color>`
Colore del font per il testo selezionato (all'interno del rettangolo di selezione).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_font_uneditable_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_uneditable_color** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`🔗<class_LineEdit_theme_color_font_uneditable_color>`
Colore del font quando la modifica è disabilitata.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_color_selection_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **selection_color** = ``Color(0.5, 0.5, 0.5, 1)`` :ref:`🔗<class_LineEdit_theme_color_selection_color>`
Colore del rettangolo di selezione.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_constant_caret_width:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **caret_width** = ``1`` :ref:`🔗<class_LineEdit_theme_constant_caret_width>`
La larghezza del cursore in pixel. È possibile usare valori più grandi per migliorare l'accessibilità, assicurando che il cursore sia facilmente visibile, o per coerenza con una dimensione grande del font.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_constant_minimum_character_width:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **minimum_character_width** = ``4`` :ref:`🔗<class_LineEdit_theme_constant_minimum_character_width>`
Spazio orizzontale minimo per il testo (senza contare il pulsante di cancellazione e i margini del contenuto). Questo valore è misurato in conteggio di caratteri 'M' (cioè questo numero di caratteri 'M' può essere visualizzato senza scorrere).
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_constant_outline_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **outline_size** = ``0`` :ref:`🔗<class_LineEdit_theme_constant_outline_size>`
La dimensione del contorno del testo.
\ **Nota:** Se si utilizza un font con :ref:`FontFile.multichannel_signed_distance_field<class_FontFile_property_multichannel_signed_distance_field>` abilitato, il suo :ref:`FontFile.msdf_pixel_range<class_FontFile_property_msdf_pixel_range>` deve essere impostato su almeno il *doppio* del valore di :ref:`outline_size<class_LineEdit_theme_constant_outline_size>` affinché il rendering del contorno appaia corretto. Altrimenti, il contorno potrebbe apparire troncato prima del previsto.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_font_font:
.. rst-class:: classref-themeproperty
:ref:`Font<class_Font>` **font** :ref:`🔗<class_LineEdit_theme_font_font>`
Font usato per il testo.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_font_size_font_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **font_size** :ref:`🔗<class_LineEdit_theme_font_size_font_size>`
Dimensione del font per il testo del **LineEdit**.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_icon_clear:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **clear** :ref:`🔗<class_LineEdit_theme_icon_clear>`
La texture per il pulsante di cancellazione. Vedi :ref:`clear_button_enabled<class_LineEdit_property_clear_button_enabled>`.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_style_focus:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **focus** :ref:`🔗<class_LineEdit_theme_style_focus>`
Sfondo utilizzato quando il **LineEdit** ha il focus della GUI. Lo :ref:`StyleBox<class_StyleBox>` di :ref:`focus<class_LineEdit_theme_style_focus>` è visualizzato *sopra* lo :ref:`StyleBox<class_StyleBox>` di base, quindi è necessario utilizzare uno :ref:`StyleBox<class_StyleBox>` parzialmente trasparente per garantire che lo :ref:`StyleBox<class_StyleBox>` di base rimanga visibile. Uno :ref:`StyleBox<class_StyleBox>` che rappresenta un contorno o una sottolineatura funziona bene per questo scopo. Per disabilitare l'effetto visivo del focus, assegna una risorsa :ref:`StyleBoxEmpty<class_StyleBoxEmpty>`. Tieni presente che disattivare l'effetto visivo di focus ridurrà l'usabilità della navigazione tramite tastiera o controller, perciò non è consigliato per motivi di accessibilità.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_style_normal:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **normal** :ref:`🔗<class_LineEdit_theme_style_normal>`
Sfondo predefinito per il **LineEdit**.
.. rst-class:: classref-item-separator
----
.. _class_LineEdit_theme_style_read_only:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **read_only** :ref:`🔗<class_LineEdit_theme_style_read_only>`
Sfondo utilizzato quando il **LineEdit** è in modalità di sola lettura (:ref:`editable<class_LineEdit_property_editable>` è impostato su ``false``).
.. |virtual| replace:: :abbr:`virtual (Questo metodo dovrebbe solitamente essere sovrascritto dall'utente per aver un effetto.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Questo metodo non ha effetti collaterali. Non modifica alcuna variabile appartenente all'istanza.)`
.. |vararg| replace:: :abbr:`vararg (Questo metodo accetta qualsiasi numero di argomenti oltre a quelli descritti qui.)`
.. |constructor| replace:: :abbr:`constructor (Questo metodo è utilizzato per creare un tipo.)`
.. |static| replace:: :abbr:`static (Questo metodo non necessita di alcun'istanza per essere chiamato, quindi può essere chiamato direttamente usando il nome della classe.)`
.. |operator| replace:: :abbr:`operator (Questo metodo descrive un operatore valido da usare con questo tipo come operando di sinistra.)`
.. |bitfield| replace:: :abbr:`BitField (Questo valore è un intero composto da una maschera di bit dei seguenti flag.)`
.. |void| replace:: :abbr:`void (Nessun valore restituito.)`
Reference in New Issue View Git Blame Copy Permalink