:github_url: hide .. meta:: :keywords: text, input .. _class_LineEdit: LineEdit ======== **Eredita:** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`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`. - Per uscire dalla modalità di modifica, premi ``ui_text_submit`` o ``ui_cancel`` (come predefinito le azioni con :kbd:`Escape`). - Consulta :ref:`edit()`, :ref:`unedit()`, :ref:`is_editing()` e :ref:`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()` 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`. .. rst-class:: classref-reftable-group Proprietà ------------------ .. table:: :widths: auto +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`HorizontalAlignment` | :ref:`alignment` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`backspace_deletes_composite_character_enabled` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_blink` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`caret_blink_interval` | ``0.65`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`caret_column` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_force_displayed` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`caret_mid_grapheme` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`clear_button_enabled` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`context_menu_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`deselect_on_focus_loss_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`drag_and_drop_selection_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`draw_control_chars` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`editable` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`emoji_menu_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`expand_to_text_length` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`flat` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`FocusMode` | focus_mode | ``2`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`ExpandMode` | :ref:`icon_expand_mode` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`keep_editing_on_text_submit` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`language` | ``""`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`max_length` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`middle_mouse_paste_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`CursorShape` | mouse_default_cursor_shape | ``1`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`placeholder_text` | ``""`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`Texture2D` | :ref:`right_icon` | | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`right_icon_scale` | ``1.0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`secret` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`secret_character` | ``"•"`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`select_all_on_focus` | ``false`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`selecting_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`shortcut_keys_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`StructuredTextParser` | :ref:`structured_text_bidi_override` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`Array` | :ref:`structured_text_bidi_override_options` | ``[]`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`text` | ``""`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`TextDirection` | :ref:`text_direction` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`virtual_keyboard_enabled` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`virtual_keyboard_show_on_focus` | ``true`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`VirtualKeyboardType` | :ref:`virtual_keyboard_type` | ``0`` | +-------------------------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Metodi ------------ .. table:: :widths: auto +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`apply_ime`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`cancel_ime`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`delete_char_at_caret`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`delete_text`\ (\ from_column\: :ref:`int`, to_column\: :ref:`int`\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`deselect`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`edit`\ (\ hide_focus\: :ref:`bool` = false\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PopupMenu` | :ref:`get_menu`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_next_composite_character_column`\ (\ column\: :ref:`int`\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_previous_composite_character_column`\ (\ column\: :ref:`int`\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_scroll_offset`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`get_selected_text`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_from_column`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_selection_to_column`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_ime_text`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_redo`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_selection`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_undo`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`insert_text_at_caret`\ (\ text\: :ref:`String`\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_editing`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_menu_visible`\ (\ ) |const| | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`menu_option`\ (\ option\: :ref:`int`\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`select`\ (\ from\: :ref:`int` = 0, to\: :ref:`int` = -1\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`select_all`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`unedit`\ (\ ) | +-----------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Proprietà del tema ------------------------------------ .. table:: :widths: auto +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`caret_color` | ``Color(0.95, 0.95, 0.95, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`clear_button_color` | ``Color(0.875, 0.875, 0.875, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`clear_button_color_pressed` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_color` | ``Color(0.875, 0.875, 0.875, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_placeholder_color` | ``Color(0.875, 0.875, 0.875, 0.6)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_selected_color` | ``Color(1, 1, 1, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`font_uneditable_color` | ``Color(0.875, 0.875, 0.875, 0.5)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Color` | :ref:`selection_color` | ``Color(0.5, 0.5, 0.5, 1)`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`caret_width` | ``1`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`minimum_character_width` | ``4`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`outline_size` | ``0`` | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Font` | :ref:`font` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`int` | :ref:`font_size` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`Texture2D` | :ref:`clear` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`focus` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`normal` | | +-----------------------------------+------------------------------------------------------------------------------------------+-------------------------------------+ | :ref:`StyleBox` | :ref:`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`\ ) :ref:`🔗` 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`\ ) :ref:`🔗` Emesso quando si aggiunge del testo che supera il valore di :ref:`max_length`. Il testo aggiunto viene troncato per adattarsi a :ref:`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`\ ) :ref:`🔗` 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`\ ) :ref:`🔗` 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:`🔗` .. _class_LineEdit_constant_MENU_CUT: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_CUT** = ``0`` Taglia (copia e cancella) il testo selezionato. .. _class_LineEdit_constant_MENU_COPY: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_COPY** = ``1`` Copia il testo selezionato. .. _class_LineEdit_constant_MENU_PASTE: .. rst-class:: classref-enumeration-constant :ref:`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_LineEdit_constant_MENU_CLEAR: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_CLEAR** = ``3`` Cancella tutto il testo del **LineEdit**. .. _class_LineEdit_constant_MENU_SELECT_ALL: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_SELECT_ALL** = ``4`` Seleziona tutto il testo del **LineEdit**. .. _class_LineEdit_constant_MENU_UNDO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_UNDO** = ``5`` Annulla l'azione precedente. .. _class_LineEdit_constant_MENU_REDO: .. rst-class:: classref-enumeration-constant :ref:`MenuItems` **MENU_REDO** = ``6`` Inverte l'ultima azione annullata. .. _class_LineEdit_constant_MENU_SUBMENU_TEXT_DIR: .. rst-class:: classref-enumeration-constant :ref:`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` **MENU_DIR_INHERITED** = ``8`` Imposta la direzione del testo a ereditata. .. _class_LineEdit_constant_MENU_DIR_AUTO: .. rst-class:: classref-enumeration-constant :ref:`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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **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` **MENU_INSERT_SHY** = ``29`` Inserisce il carattere trattino morbido (SHY). .. _class_LineEdit_constant_MENU_EMOJI_AND_SYMBOL: .. rst-class:: classref-enumeration-constant :ref:`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` **MENU_MAX** = ``31`` Rappresenta la dimensione dell'enumerazione :ref:`MenuItems`. .. rst-class:: classref-item-separator ---- .. _enum_LineEdit_VirtualKeyboardType: .. rst-class:: classref-enumeration enum **VirtualKeyboardType**: :ref:`🔗` .. _class_LineEdit_constant_KEYBOARD_TYPE_DEFAULT: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_DEFAULT** = ``0`` Tastiera virtuale di testo predefinita. .. _class_LineEdit_constant_KEYBOARD_TYPE_MULTILINE: .. rst-class:: classref-enumeration-constant :ref:`VirtualKeyboardType` **KEYBOARD_TYPE_MULTILINE** = ``1`` Tastiera virtuale multilinea. .. _class_LineEdit_constant_KEYBOARD_TYPE_NUMBER: .. rst-class:: classref-enumeration-constant :ref:`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` **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` **KEYBOARD_TYPE_PHONE** = ``4`` Tastiera virtuale per numeri di telefono. .. _class_LineEdit_constant_KEYBOARD_TYPE_EMAIL_ADDRESS: .. rst-class:: classref-enumeration-constant :ref:`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` **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_URL: .. rst-class:: classref-enumeration-constant :ref:`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:`🔗` .. _class_LineEdit_constant_EXPAND_MODE_ORIGINAL_SIZE: .. rst-class:: classref-enumeration-constant :ref:`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` **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` **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` **alignment** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_horizontal_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`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` **backspace_deletes_composite_character_enabled** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_backspace_deletes_composite_character_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_backspace_deletes_composite_character_enabled**\ (\ ) Se ``true`` e :ref:`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` **caret_blink** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_blink_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **caret_blink_interval** = ``0.65`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_blink_interval**\ (\ value\: :ref:`float`\ ) - :ref:`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` **caret_column** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_column**\ (\ value\: :ref:`int`\ ) - :ref:`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` **caret_force_displayed** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_force_displayed**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **caret_mid_grapheme** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_caret_mid_grapheme_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **clear_button_enabled** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_clear_button_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_clear_button_enabled**\ (\ ) Se ``true``, il **LineEdit** mostrerà un pulsante di cancellazione se :ref:`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` **context_menu_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_context_menu_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **deselect_on_focus_loss_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_deselect_on_focus_loss_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **drag_and_drop_selection_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_drag_and_drop_selection_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **draw_control_chars** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_draw_control_chars**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **editable** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_editable**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **emoji_menu_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_emoji_menu_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **expand_to_text_length** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_expand_to_text_length_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_expand_to_text_length_enabled**\ (\ ) Se ``true``, la larghezza del **LineEdit** aumenterà per rimanere più lunga del :ref:`text`. **Non** verrà compresso se il :ref:`text` viene accorciato. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_flat: .. rst-class:: classref-property :ref:`bool` **flat** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_flat**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **icon_expand_mode** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_icon_expand_mode**\ (\ value\: :ref:`ExpandMode`\ ) - :ref:`ExpandMode` **get_icon_expand_mode**\ (\ ) Define the scaling behavior of the :ref:`right_icon`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_keep_editing_on_text_submit: .. rst-class:: classref-property :ref:`bool` **keep_editing_on_text_submit** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_keep_editing_on_text_submit**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **language** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_language**\ (\ value\: :ref:`String`\ ) - :ref:`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` **max_length** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_max_length**\ (\ value\: :ref:`int`\ ) - :ref:`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` vengono troncati. Ciò accade sia per il contenuto di :ref:`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` 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` **middle_mouse_paste_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_middle_mouse_paste_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **placeholder_text** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_placeholder**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_placeholder**\ (\ ) Testo visualizzato quando il **LineEdit** è vuoto. **Non** è il valore predefinito del **LineEdit** (vedi :ref:`text`). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_right_icon: .. rst-class:: classref-property :ref:`Texture2D` **right_icon** :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_right_icon**\ (\ value\: :ref:`Texture2D`\ ) - :ref:`Texture2D` **get_right_icon**\ (\ ) Imposta l'icona che apparirà all'estremità destra di **LineEdit** se :ref:`text` non è presente, o sempre, se :ref:`clear_button_enabled` è impostato su ``false``. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_right_icon_scale: .. rst-class:: classref-property :ref:`float` **right_icon_scale** = ``1.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_right_icon_scale**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_right_icon_scale**\ (\ ) Scale ratio of the icon when :ref:`icon_expand_mode` is set to :ref:`EXPAND_MODE_FIT_TO_LINE_EDIT`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_secret: .. rst-class:: classref-property :ref:`bool` **secret** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_secret**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **is_secret**\ (\ ) Se ``true``, ogni carattere è sostituito con il carattere segreto (vedi :ref:`secret_character`). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_secret_character: .. rst-class:: classref-property :ref:`String` **secret_character** = ``"•"`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_secret_character**\ (\ value\: :ref:`String`\ ) - :ref:`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` **select_all_on_focus** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_select_all_on_focus**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **selecting_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_selecting_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **shortcut_keys_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_shortcut_keys_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **structured_text_bidi_override** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_structured_text_bidi_override**\ (\ value\: :ref:`StructuredTextParser`\ ) - :ref:`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` **structured_text_bidi_override_options** = ``[]`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_structured_text_bidi_override_options**\ (\ value\: :ref:`Array`\ ) - :ref:`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` **text** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_text**\ (\ ) Valore della stringa di **LineEdit**. \ **Nota:** La modifica del testo tramite questa proprietà non emetterà il segnale :ref:`text_changed`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_property_text_direction: .. rst-class:: classref-property :ref:`TextDirection` **text_direction** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_direction**\ (\ value\: :ref:`TextDirection`\ ) - :ref:`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` **virtual_keyboard_enabled** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_virtual_keyboard_enabled**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **virtual_keyboard_show_on_focus** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_virtual_keyboard_show_on_focus**\ (\ value\: :ref:`bool`\ ) - :ref:`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` **virtual_keyboard_type** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_virtual_keyboard_type**\ (\ value\: :ref:`VirtualKeyboardType`\ ) - :ref:`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:`🔗` Applica il testo dall'`Input Method Editor `__ (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:`🔗` Chiude l'`Input Method Editor `__ (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:`🔗` Cancella il :ref:`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:`🔗` 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`, to_column\: :ref:`int`\ ) :ref:`🔗` Elimina una sezione del :ref:`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:`🔗` Cancella la selezione attuale. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_edit: .. rst-class:: classref-method |void| **edit**\ (\ hide_focus\: :ref:`bool` = false\ ) :ref:`🔗` 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()`). See also :ref:`keep_editing_on_text_submit`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_get_menu: .. rst-class:: classref-method :ref:`PopupMenu` **get_menu**\ (\ ) |const| :ref:`🔗` Restituisce il :ref:`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`). 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`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_get_next_composite_character_column: .. rst-class:: classref-method :ref:`int` **get_next_composite_character_column**\ (\ column\: :ref:`int`\ ) |const| :ref:`🔗` 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` **get_previous_composite_character_column**\ (\ column\: :ref:`int`\ ) |const| :ref:`🔗` 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` **get_scroll_offset**\ (\ ) |const| :ref:`🔗` Restituisce lo scostamento di scorrimento dovuto a :ref:`caret_column`, come numero di caratteri. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_get_selected_text: .. rst-class:: classref-method :ref:`String` **get_selected_text**\ (\ ) :ref:`🔗` 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` **get_selection_from_column**\ (\ ) |const| :ref:`🔗` 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` **get_selection_to_column**\ (\ ) |const| :ref:`🔗` Restituisce la colonna di fine della selezione. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_has_ime_text: .. rst-class:: classref-method :ref:`bool` **has_ime_text**\ (\ ) |const| :ref:`🔗` Restituisce ``true`` se l'utente ha testo nell'`Input Method Editor `__ (IME). .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_has_redo: .. rst-class:: classref-method :ref:`bool` **has_redo**\ (\ ) |const| :ref:`🔗` Restituisce ``true`` se un'azione "ripeti" è disponibile. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_has_selection: .. rst-class:: classref-method :ref:`bool` **has_selection**\ (\ ) |const| :ref:`🔗` 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` **has_undo**\ (\ ) |const| :ref:`🔗` 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`\ ) :ref:`🔗` Inserisce ``text`` al cursore. Se il valore risultante è più lungo di :ref:`max_length`, non succede nulla. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_is_editing: .. rst-class:: classref-method :ref:`bool` **is_editing**\ (\ ) |const| :ref:`🔗` 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` **is_menu_visible**\ (\ ) |const| :ref:`🔗` 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`\ ) :ref:`🔗` Esegue l'azione specificata come definito nell'enumerazione :ref:`MenuItems`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_select: .. rst-class:: classref-method |void| **select**\ (\ from\: :ref:`int` = 0, to\: :ref:`int` = -1\ ) :ref:`🔗` 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:`🔗` Seleziona l'intera :ref:`String`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_method_unedit: .. rst-class:: classref-method |void| **unedit**\ (\ ) :ref:`🔗` 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` **caret_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗` 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` **clear_button_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗` 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` **clear_button_color_pressed** = ``Color(1, 1, 1, 1)`` :ref:`🔗` 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` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗` Colore predefinito del font. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_font_outline_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_outline_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗` 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` **font_placeholder_color** = ``Color(0.875, 0.875, 0.875, 0.6)`` :ref:`🔗` Colore del font per :ref:`placeholder_text`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_font_selected_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_selected_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` 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` **font_uneditable_color** = ``Color(0.875, 0.875, 0.875, 0.5)`` :ref:`🔗` Colore del font quando la modifica è disabilitata. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_color_selection_color: .. rst-class:: classref-themeproperty :ref:`Color` **selection_color** = ``Color(0.5, 0.5, 0.5, 1)`` :ref:`🔗` Colore del rettangolo di selezione. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_constant_caret_width: .. rst-class:: classref-themeproperty :ref:`int` **caret_width** = ``1`` :ref:`🔗` 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` **minimum_character_width** = ``4`` :ref:`🔗` 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` **outline_size** = ``0`` :ref:`🔗` La dimensione del contorno del testo. \ **Nota:** Se si utilizza un font con :ref:`FontFile.multichannel_signed_distance_field` abilitato, il suo :ref:`FontFile.msdf_pixel_range` deve essere impostato su almeno il *doppio* del valore di :ref:`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` **font** :ref:`🔗` Font usato per il testo. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_font_size_font_size: .. rst-class:: classref-themeproperty :ref:`int` **font_size** :ref:`🔗` Dimensione del font per il testo del **LineEdit**. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_icon_clear: .. rst-class:: classref-themeproperty :ref:`Texture2D` **clear** :ref:`🔗` La texture per il pulsante di cancellazione. Vedi :ref:`clear_button_enabled`. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_style_focus: .. rst-class:: classref-themeproperty :ref:`StyleBox` **focus** :ref:`🔗` Sfondo utilizzato quando il **LineEdit** ha il focus della GUI. Lo :ref:`StyleBox` di :ref:`focus` è visualizzato *sopra* lo :ref:`StyleBox` di base, quindi è necessario utilizzare uno :ref:`StyleBox` parzialmente trasparente per garantire che lo :ref:`StyleBox` di base rimanga visibile. Uno :ref:`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`. 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` **normal** :ref:`🔗` Sfondo predefinito per il **LineEdit**. .. rst-class:: classref-item-separator ---- .. _class_LineEdit_theme_style_read_only: .. rst-class:: classref-themeproperty :ref:`StyleBox` **read_only** :ref:`🔗` Sfondo utilizzato quando il **LineEdit** è in modalità di sola lettura (:ref:`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.)`