:github_url: hide .. _class_LinkButton: LinkButton ========== **Eredita:** :ref:`BaseButton` **<** :ref:`Control` **<** :ref:`CanvasItem` **<** :ref:`Node` **<** :ref:`Object` Un pulsante che rappresenta un collegamento. .. rst-class:: classref-introduction-group Descrizione ---------------------- Un pulsante che rappresenta un collegamento. Questo tipo di pulsante è utilizzato principalmente per interazioni che causano un cambiamento di contesto (come il collegamento a una pagina web). Vedi anche :ref:`BaseButton` che contiene le proprietà e i metodi comuni associati a questo nodo. .. rst-class:: classref-reftable-group Proprietà ------------------ .. table:: :widths: auto +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`ellipsis_char` | ``"…"`` | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`FocusMode` | focus_mode | ``3`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`language` | ``""`` | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`CursorShape` | mouse_default_cursor_shape | ``2`` (overrides :ref:`Control`) | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :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:`OverrunBehavior` | :ref:`text_overrun_behavior` | ``0`` | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`UnderlineMode` | :ref:`underline` | ``0`` | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ | :ref:`String` | :ref:`uri` | ``""`` | +-------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+ .. rst-class:: classref-reftable-group Proprietà del tema ------------------------------------ .. table:: :widths: auto +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`font_color` | ``Color(0.875, 0.875, 0.875, 1)`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`font_disabled_color` | ``Color(0, 0, 0, 1)`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`font_focus_color` | ``Color(0.95, 0.95, 0.95, 1)`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`font_hover_color` | ``Color(0.95, 0.95, 0.95, 1)`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`font_hover_pressed_color` | ``Color(0, 0, 0, 1)`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`font_outline_color` | ``Color(0, 0, 0, 1)`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Color` | :ref:`font_pressed_color` | ``Color(1, 1, 1, 1)`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`outline_size` | ``0`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`underline_spacing` | ``2`` | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`Font` | :ref:`font` | | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`int` | :ref:`font_size` | | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ | :ref:`StyleBox` | :ref:`focus` | | +---------------------------------+----------------------------------------------------------------------------------------+-----------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Enumerazioni ------------------------ .. _enum_LinkButton_UnderlineMode: .. rst-class:: classref-enumeration enum **UnderlineMode**: :ref:`🔗` .. _class_LinkButton_constant_UNDERLINE_MODE_ALWAYS: .. rst-class:: classref-enumeration-constant :ref:`UnderlineMode` **UNDERLINE_MODE_ALWAYS** = ``0`` Il LinkButton mostrerà sempre una sottolineatura sotto al suo testo. .. _class_LinkButton_constant_UNDERLINE_MODE_ON_HOVER: .. rst-class:: classref-enumeration-constant :ref:`UnderlineMode` **UNDERLINE_MODE_ON_HOVER** = ``1`` Il LinkButton mostrerà una sottolineatura sotto il suo testo quando il cursore del mouse è su di esso. .. _class_LinkButton_constant_UNDERLINE_MODE_NEVER: .. rst-class:: classref-enumeration-constant :ref:`UnderlineMode` **UNDERLINE_MODE_NEVER** = ``2`` Il LinkButton non mostrerà mai una sottolineatura sotto al suo testo. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni delle proprietà ------------------------------------------------------ .. _class_LinkButton_property_ellipsis_char: .. rst-class:: classref-property :ref:`String` **ellipsis_char** = ``"…"`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_ellipsis_char**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_ellipsis_char**\ (\ ) Carattere di ellissi (puntini di sospensione) utilizzato per ritagliare il testo. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_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_LinkButton_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_LinkButton_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_LinkButton_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**\ (\ ) Il testo del pulsante che sarà visualizzato all'interno dell'area del pulsante. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_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_LinkButton_property_text_overrun_behavior: .. rst-class:: classref-property :ref:`OverrunBehavior` **text_overrun_behavior** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_overrun_behavior**\ (\ value\: :ref:`OverrunBehavior`\ ) - :ref:`OverrunBehavior` **get_text_overrun_behavior**\ (\ ) Imposta il comportamento di ritaglio quando il testo supera il rettangolo di delimitazione del nodo. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_property_underline: .. rst-class:: classref-property :ref:`UnderlineMode` **underline** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_underline_mode**\ (\ value\: :ref:`UnderlineMode`\ ) - :ref:`UnderlineMode` **get_underline_mode**\ (\ ) La modalità di sottolineatura da utilizzare per il testo. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_property_uri: .. rst-class:: classref-property :ref:`String` **uri** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_uri**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_uri**\ (\ ) L'`URI `__ per questo **LinkButton**. Se impostato su un URI valido, premendo il pulsante si apre l'URI utilizzando il programma predefinito del sistema operativo per il protocollo (tramite :ref:`OS.shell_open()`). Gli URL HTTP e HTTPS aprono il browser Web predefinito. .. tabs:: .. code-tab:: gdscript uri = "https://godotengine.org" # Apre l'URL nel browser Web predefinito. uri = "C:\SomeFolder" # Apre l'esploratore file nel percorso specificato. uri = "C:\SomeImage.png" # Apre l'immagine specificata nell'app di visualizzazione predefinita. .. code-tab:: csharp Uri = "https://godotengine.org"; // Apre l'URL nel browser Web predefinito. Uri = "C:\SomeFolder"; // Apre l'esploratore file nel percorso specificato. Uri = "C:\SomeImage.png"; // Apre l'immagine specificata nell'app di visualizzazione predefinita. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descrizioni delle proprietà del tema ------------------------------------------------------------------------ .. _class_LinkButton_theme_color_font_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗` Il :ref:`Color` predefinito del testo del **LinkButton**. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_theme_color_font_disabled_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_disabled_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗` Il :ref:`Color` del testo utilizzato quando il **LinkButton** è disabilitato. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_theme_color_font_focus_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_focus_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗` Il :ref:`Color` del testo utilizzato quando il **LinkButton** è focalizzato. Sostituisce solo il colore del testo normale del pulsante. Gli stati disabilitato, al passaggio del mouse e premuto hanno la precedenza su questo colore. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_theme_color_font_hover_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_hover_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗` Il :ref:`Color` del testo utilizzato quando si passa il mouse sul **LinkButton**. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_theme_color_font_hover_pressed_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_hover_pressed_color** = ``Color(0, 0, 0, 1)`` :ref:`🔗` Il :ref:`Color` del testo utilizzato quando si passa il mouse sopra e si preme il **LinkButton**. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_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 **LinkButton**. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_theme_color_font_pressed_color: .. rst-class:: classref-themeproperty :ref:`Color` **font_pressed_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗` Il :ref:`Color` del testo utilizzato quando il pulsante **LinkButton** è premuto. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_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_LinkButton_theme_constant_underline_spacing: .. rst-class:: classref-themeproperty :ref:`int` **underline_spacing** = ``2`` :ref:`🔗` Lo spazio verticale tra la linea di base del testo e la sottolineatura. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_theme_font_font: .. rst-class:: classref-themeproperty :ref:`Font` **font** :ref:`🔗` Il :ref:`Font` del testo del **LinkButton**. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_theme_font_size_font_size: .. rst-class:: classref-themeproperty :ref:`int` **font_size** :ref:`🔗` Dimensione del font per il testo del **LinkButton**. .. rst-class:: classref-item-separator ---- .. _class_LinkButton_theme_style_focus: .. rst-class:: classref-themeproperty :ref:`StyleBox` **focus** :ref:`🔗` Lo :ref:`StyleBox` utilizzato quando il **LinkButton** è focalizzato. 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à. .. |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.)`