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/fr/class_styleboxflat.rst
Rémi Verschelde 369fd84a4f Sync classref with 4.5 branch
2025-12-19 14:34:07 +01:00

668 lines
34 KiB
ReStructuredText
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. _class_StyleBoxFlat:
StyleBoxFlat
============
**Hérite de :** :ref:`StyleBox<class_StyleBox>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
Une :ref:`StyleBox<class_StyleBox>` personnalisable qui n'utilise pas de texture.
.. rst-class:: classref-introduction-group
Description
-----------
En configurant diverses propriétés de cette boîte de style, vous pouvez réaliser de nombreux looks communs sans avoir besoin d'une texture. Cela comprend les bordures arrondies, l'anticrénelage, les ombres et le cisaillement.
Définir le rayon des coins à des valeurs élevées est autorisé. Dès que les coins se chevauchent, la boîte de style passe à un système relatif :
.. code:: text
hauteur = 30
rayon_coin_haut_gauche = 50
rayon_coin_bas_gauche = 100
Le système relatif prendrait maintenant le rapport 1:2 des deux coins gauches pour calculer la largeur réelle des coins. Les deux coins ajoutés ne seront **jamais** plus grands que la hauteur. Résultat :
.. code:: text
rayon_coin_haut_gauche : 10
rayon_coin_bas_gauche : 20
.. rst-class:: classref-reftable-group
Propriétés
--------------------
.. table::
:widths: auto
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`bool<class_bool>` | :ref:`anti_aliasing<class_StyleBoxFlat_property_anti_aliasing>` | ``true`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`float<class_float>` | :ref:`anti_aliasing_size<class_StyleBoxFlat_property_anti_aliasing_size>` | ``1.0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`Color<class_Color>` | :ref:`bg_color<class_StyleBoxFlat_property_bg_color>` | ``Color(0.6, 0.6, 0.6, 1)`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`bool<class_bool>` | :ref:`border_blend<class_StyleBoxFlat_property_border_blend>` | ``false`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`Color<class_Color>` | :ref:`border_color<class_StyleBoxFlat_property_border_color>` | ``Color(0.8, 0.8, 0.8, 1)`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`border_width_bottom<class_StyleBoxFlat_property_border_width_bottom>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`border_width_left<class_StyleBoxFlat_property_border_width_left>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`border_width_right<class_StyleBoxFlat_property_border_width_right>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`border_width_top<class_StyleBoxFlat_property_border_width_top>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`corner_detail<class_StyleBoxFlat_property_corner_detail>` | ``8`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`corner_radius_bottom_left<class_StyleBoxFlat_property_corner_radius_bottom_left>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`corner_radius_bottom_right<class_StyleBoxFlat_property_corner_radius_bottom_right>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`corner_radius_top_left<class_StyleBoxFlat_property_corner_radius_top_left>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`corner_radius_top_right<class_StyleBoxFlat_property_corner_radius_top_right>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`bool<class_bool>` | :ref:`draw_center<class_StyleBoxFlat_property_draw_center>` | ``true`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`float<class_float>` | :ref:`expand_margin_bottom<class_StyleBoxFlat_property_expand_margin_bottom>` | ``0.0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`float<class_float>` | :ref:`expand_margin_left<class_StyleBoxFlat_property_expand_margin_left>` | ``0.0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`float<class_float>` | :ref:`expand_margin_right<class_StyleBoxFlat_property_expand_margin_right>` | ``0.0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`float<class_float>` | :ref:`expand_margin_top<class_StyleBoxFlat_property_expand_margin_top>` | ``0.0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`Color<class_Color>` | :ref:`shadow_color<class_StyleBoxFlat_property_shadow_color>` | ``Color(0, 0, 0, 0.6)`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`shadow_offset<class_StyleBoxFlat_property_shadow_offset>` | ``Vector2(0, 0)`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`int<class_int>` | :ref:`shadow_size<class_StyleBoxFlat_property_shadow_size>` | ``0`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`skew<class_StyleBoxFlat_property_skew>` | ``Vector2(0, 0)`` |
+-------------------------------+-------------------------------------------------------------------------------------------+-----------------------------+
.. rst-class:: classref-reftable-group
Méthodes
----------------
.. table::
:widths: auto
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_border_width<class_StyleBoxFlat_method_get_border_width>`\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const| |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_border_width_min<class_StyleBoxFlat_method_get_border_width_min>`\ (\ ) |const| |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_corner_radius<class_StyleBoxFlat_method_get_corner_radius>`\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`\ ) |const| |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_expand_margin<class_StyleBoxFlat_method_get_expand_margin>`\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const| |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_border_width<class_StyleBoxFlat_method_set_border_width>`\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, width\: :ref:`int<class_int>`\ ) |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_border_width_all<class_StyleBoxFlat_method_set_border_width_all>`\ (\ width\: :ref:`int<class_int>`\ ) |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_corner_radius<class_StyleBoxFlat_method_set_corner_radius>`\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`, radius\: :ref:`int<class_int>`\ ) |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_corner_radius_all<class_StyleBoxFlat_method_set_corner_radius_all>`\ (\ radius\: :ref:`int<class_int>`\ ) |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_expand_margin<class_StyleBoxFlat_method_set_expand_margin>`\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, size\: :ref:`float<class_float>`\ ) |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_expand_margin_all<class_StyleBoxFlat_method_set_expand_margin_all>`\ (\ size\: :ref:`float<class_float>`\ ) |
+---------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descriptions des propriétés
------------------------------------------------------
.. _class_StyleBoxFlat_property_anti_aliasing:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **anti_aliasing** = ``true`` :ref:`🔗<class_StyleBoxFlat_property_anti_aliasing>`
.. rst-class:: classref-property-setget
- |void| **set_anti_aliased**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_anti_aliased**\ (\ )
L'anticrénelage dessine un petit anneau autour des bords, qui disparaît vers de la transparence. En conséquence, les bords sont beaucoup plus doux. Ceci n'est visible que lorsque vous utilisez des coins arrondis ou :ref:`skew<class_StyleBoxFlat_property_skew>`.
\ **Note :** Lors de l'utilisation d'angles biseautés avec des angles de 45 degrés (:ref:`corner_detail<class_StyleBoxFlat_property_corner_detail>` = 1), il est recommandé de définir :ref:`anti_aliasing<class_StyleBoxFlat_property_anti_aliasing>` à ``false`` afin d'assurer des visuels nets et d'éviter des glitchs visuels possibles.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_anti_aliasing_size:
.. rst-class:: classref-property
:ref:`float<class_float>` **anti_aliasing_size** = ``1.0`` :ref:`🔗<class_StyleBoxFlat_property_anti_aliasing_size>`
.. rst-class:: classref-property-setget
- |void| **set_aa_size**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_aa_size**\ (\ )
Cela modifie la taille de l'effet d'anticrénelage. ``1.0`` est recommandé pour un résultat optimal à l'échelle 100%, identique à la façon dont les rectangles arrondis sont rendus dans les navigateurs Web et la plupart des logiciels de dessin vectoriel.
\ **Note :** Des valeurs plus élevées peuvent produire un effet de flou, mais peuvent également créer des artéfacts indésirables sur les petites boîtes avec des angles à grand rayon.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_bg_color:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **bg_color** = ``Color(0.6, 0.6, 0.6, 1)`` :ref:`🔗<class_StyleBoxFlat_property_bg_color>`
.. rst-class:: classref-property-setget
- |void| **set_bg_color**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_bg_color**\ (\ )
La couleur d'arrière-plan de la stylebox.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_border_blend:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **border_blend** = ``false`` :ref:`🔗<class_StyleBoxFlat_property_border_blend>`
.. rst-class:: classref-property-setget
- |void| **set_border_blend**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_border_blend**\ (\ )
Si ``true``, la bordure fusionnera avec la couleur de l'arrière-plan.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_border_color:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **border_color** = ``Color(0.8, 0.8, 0.8, 1)`` :ref:`🔗<class_StyleBoxFlat_property_border_color>`
.. rst-class:: classref-property-setget
- |void| **set_border_color**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_border_color**\ (\ )
Définit la couleur de la bordure.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_border_width_bottom:
.. rst-class:: classref-property
:ref:`int<class_int>` **border_width_bottom** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_border_width_bottom>`
.. rst-class:: classref-property-setget
- |void| **set_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, width\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const|
L'épaisseur de la bordure du bas.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_border_width_left:
.. rst-class:: classref-property
:ref:`int<class_int>` **border_width_left** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_border_width_left>`
.. rst-class:: classref-property-setget
- |void| **set_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, width\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const|
L'épaisseur de la bordure de gauche.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_border_width_right:
.. rst-class:: classref-property
:ref:`int<class_int>` **border_width_right** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_border_width_right>`
.. rst-class:: classref-property-setget
- |void| **set_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, width\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const|
L'épaisseur de la bordure de droite.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_border_width_top:
.. rst-class:: classref-property
:ref:`int<class_int>` **border_width_top** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_border_width_top>`
.. rst-class:: classref-property-setget
- |void| **set_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, width\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const|
L'épaisseur de la bordure du haut.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_corner_detail:
.. rst-class:: classref-property
:ref:`int<class_int>` **corner_detail** = ``8`` :ref:`🔗<class_StyleBoxFlat_property_corner_detail>`
.. rst-class:: classref-property-setget
- |void| **set_corner_detail**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_corner_detail**\ (\ )
Cela définit le nombre de sommets utilisés pour chaque coin. Les valeurs plus élevées résultent en des angles plus ronds mais prennent plus de puissance de traitement pour calculer. Lors du choix d'une valeur, vous devriez prendre en compte le rayon du coin (:ref:`set_corner_radius_all()<class_StyleBoxFlat_method_set_corner_radius_all>`).
Pour des rayons de coin inférieurs à 10, ``4`` ou ``5`` devrait suffire. Pour des rayons de coin inférieurs à 30, des valeurs entre ``8`` et ``12`` devraient suffire.
Un détail d'angle de ``1`` résultera en des angles chanfreinés au lieu d'angles arrondis, ce qui est utile pour certains effets artistiques.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_corner_radius_bottom_left:
.. rst-class:: classref-property
:ref:`int<class_int>` **corner_radius_bottom_left** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_corner_radius_bottom_left>`
.. rst-class:: classref-property-setget
- |void| **set_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`, radius\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`\ ) |const|
Le rayon du coin bas-gauche. Si ``0``, le coin n'est pas arrondi.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_corner_radius_bottom_right:
.. rst-class:: classref-property
:ref:`int<class_int>` **corner_radius_bottom_right** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_corner_radius_bottom_right>`
.. rst-class:: classref-property-setget
- |void| **set_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`, radius\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`\ ) |const|
Le rayon du coin bas-droit. Si ``0``, le coin n'est pas arrondi.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_corner_radius_top_left:
.. rst-class:: classref-property
:ref:`int<class_int>` **corner_radius_top_left** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_corner_radius_top_left>`
.. rst-class:: classref-property-setget
- |void| **set_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`, radius\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`\ ) |const|
Le rayon du coin haut-gauche. Si ``0``, le coin n'est pas arrondi.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_corner_radius_top_right:
.. rst-class:: classref-property
:ref:`int<class_int>` **corner_radius_top_right** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_corner_radius_top_right>`
.. rst-class:: classref-property-setget
- |void| **set_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`, radius\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`\ ) |const|
Le rayon du coin haut-droit. Si ``0``, le coin n'est pas arrondi.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_draw_center:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **draw_center** = ``true`` :ref:`🔗<class_StyleBoxFlat_property_draw_center>`
.. rst-class:: classref-property-setget
- |void| **set_draw_center**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_draw_center_enabled**\ (\ )
Active l'affichage de l'intérieur de la stylebox.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_expand_margin_bottom:
.. rst-class:: classref-property
:ref:`float<class_float>` **expand_margin_bottom** = ``0.0`` :ref:`🔗<class_StyleBoxFlat_property_expand_margin_bottom>`
.. rst-class:: classref-property-setget
- |void| **set_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, size\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const|
Étend la boite en dehors du rectangle du contrôle pour la bordure du bas. Utile avec :ref:`border_width_bottom<class_StyleBoxFlat_property_border_width_bottom>` pour afficher une bordure en dehors du rectangle du contrôle.
\ **Note :** Contrairement à :ref:`StyleBox.content_margin_bottom<class_StyleBox_property_content_margin_bottom>`, :ref:`expand_margin_bottom<class_StyleBoxFlat_property_expand_margin_bottom>` n'étend *pas* la taille de la zone qui peut être cliquée du :ref:`Control<class_Control>`. Ça peut avoir un impact négatif sur l’accessibilité si c'est mal réglé, puisque l'utilisateur peut vouloir cliquer sur cette zone de la boite qui ne reçoit pas les clics.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_expand_margin_left:
.. rst-class:: classref-property
:ref:`float<class_float>` **expand_margin_left** = ``0.0`` :ref:`🔗<class_StyleBoxFlat_property_expand_margin_left>`
.. rst-class:: classref-property-setget
- |void| **set_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, size\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const|
Étend la boite en dehors du rectangle du contrôle pour la bordure de gauche. Utile avec :ref:`border_width_left<class_StyleBoxFlat_property_border_width_left>` pour afficher une bordure en dehors du rectangle du contrôle.
\ **Note :** Contrairement à :ref:`StyleBox.content_margin_left<class_StyleBox_property_content_margin_left>`, :ref:`expand_margin_left<class_StyleBoxFlat_property_expand_margin_left>` n'étend *pas* la taille de la zone qui peut être cliquée du :ref:`Control<class_Control>`. Ça peut avoir un impact négatif sur l’accessibilité si c'est mal réglé, puisque l'utilisateur peut vouloir cliquer sur cette zone de la boite qui ne reçoit pas les clics.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_expand_margin_right:
.. rst-class:: classref-property
:ref:`float<class_float>` **expand_margin_right** = ``0.0`` :ref:`🔗<class_StyleBoxFlat_property_expand_margin_right>`
.. rst-class:: classref-property-setget
- |void| **set_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, size\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const|
Étend la boite en dehors du rectangle du contrôle pour la bordure de droite. Utile avec :ref:`border_width_right<class_StyleBoxFlat_property_border_width_right>` pour afficher une bordure en dehors du rectangle du contrôle.
\ **Note :** Contrairement à :ref:`StyleBox.content_margin_right<class_StyleBox_property_content_margin_right>`, :ref:`expand_margin_right<class_StyleBoxFlat_property_expand_margin_right>` n'étend *pas* la taille de la zone qui peut être cliquée du :ref:`Control<class_Control>`. Ça peut avoir un impact négatif sur l’accessibilité si c'est mal réglé, puisque l'utilisateur peut vouloir cliquer sur cette zone de la boite qui ne reçoit pas les clics.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_expand_margin_top:
.. rst-class:: classref-property
:ref:`float<class_float>` **expand_margin_top** = ``0.0`` :ref:`🔗<class_StyleBoxFlat_property_expand_margin_top>`
.. rst-class:: classref-property-setget
- |void| **set_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, size\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const|
Étend la boite en dehors du rectangle du contrôle pour la bordure du haut. Utile avec :ref:`border_width_top<class_StyleBoxFlat_property_border_width_top>` pour afficher une bordure en dehors du rectangle du contrôle.
\ **Note :** Contrairement à :ref:`StyleBox.content_margin_top<class_StyleBox_property_content_margin_top>`, :ref:`expand_margin_top<class_StyleBoxFlat_property_expand_margin_top>` n'étend *pas* la taille de la zone qui peut être cliquée du :ref:`Control<class_Control>`. Ça peut avoir un impact négatif sur l’accessibilité si c'est mal réglé, puisque l'utilisateur peut vouloir cliquer sur cette zone de la boite qui ne reçoit pas les clics.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_shadow_color:
.. rst-class:: classref-property
:ref:`Color<class_Color>` **shadow_color** = ``Color(0, 0, 0, 0.6)`` :ref:`🔗<class_StyleBoxFlat_property_shadow_color>`
.. rst-class:: classref-property-setget
- |void| **set_shadow_color**\ (\ value\: :ref:`Color<class_Color>`\ )
- :ref:`Color<class_Color>` **get_shadow_color**\ (\ )
La couleur de l'ombre. Ça n'a aucun effet si :ref:`shadow_size<class_StyleBoxFlat_property_shadow_size>` est inférieur à 1.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_shadow_offset:
.. rst-class:: classref-property
:ref:`Vector2<class_Vector2>` **shadow_offset** = ``Vector2(0, 0)`` :ref:`🔗<class_StyleBoxFlat_property_shadow_offset>`
.. rst-class:: classref-property-setget
- |void| **set_shadow_offset**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
- :ref:`Vector2<class_Vector2>` **get_shadow_offset**\ (\ )
Le décalage de l'ombre en pixels. Ajuste la position de l'ombre relativement à la boîte de style.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_shadow_size:
.. rst-class:: classref-property
:ref:`int<class_int>` **shadow_size** = ``0`` :ref:`🔗<class_StyleBoxFlat_property_shadow_size>`
.. rst-class:: classref-property-setget
- |void| **set_shadow_size**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_shadow_size**\ (\ )
La taille de l'ombre en pixels.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_property_skew:
.. rst-class:: classref-property
:ref:`Vector2<class_Vector2>` **skew** = ``Vector2(0, 0)`` :ref:`🔗<class_StyleBoxFlat_property_skew>`
.. rst-class:: classref-property-setget
- |void| **set_skew**\ (\ value\: :ref:`Vector2<class_Vector2>`\ )
- :ref:`Vector2<class_Vector2>` **get_skew**\ (\ )
Si défini à une valeur non nulle sur l'un des axes, :ref:`skew<class_StyleBoxFlat_property_skew>` déforme la StyleBox horizontalement et/ou verticalement. Cela peut être utilisé pour les UIs de style "futuriste". Les valeurs positives cisaillent la StyleBox vers la droite (axe X) et vers le haut (axe Y), tandis que les valeurs négatives cisaillent la StyleBox vers la gauche (axe X) et vers le bas (axe Y).
\ **Note :** Pour garantir que le texte ne touche pas les bords de la StyleBox, envisagez d'augmenter la marge du contenu de la :ref:`StyleBox<class_StyleBox>` (voir :ref:`StyleBox.content_margin_bottom<class_StyleBox_property_content_margin_bottom>`). Il est préférable d'augmenter la marge du contenu au lieu de la marge d'extension (voir :ref:`expand_margin_bottom<class_StyleBoxFlat_property_expand_margin_bottom>`), car augmenter la marge d'extension n'augmente pas la taille de la zone cliquable pour les :ref:`Control<class_Control>`\ s.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Descriptions des méthodes
--------------------------------------------------
.. _class_StyleBoxFlat_method_get_border_width:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const| :ref:`🔗<class_StyleBoxFlat_method_get_border_width>`
Renvoie la largeur de la bordure du côté :ref:`Side<enum_@GlobalScope_Side>` spécifié.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_get_border_width_min:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_border_width_min**\ (\ ) |const| :ref:`🔗<class_StyleBoxFlat_method_get_border_width_min>`
Renvoie la plus fine bordure parmi les quatre bordures.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_get_corner_radius:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`\ ) |const| :ref:`🔗<class_StyleBoxFlat_method_get_corner_radius>`
Renvoie le rayon du coin ``corner`` donné.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_get_expand_margin:
.. rst-class:: classref-method
:ref:`float<class_float>` **get_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`\ ) |const| :ref:`🔗<class_StyleBoxFlat_method_get_expand_margin>`
Renvoie la taille de la marge d'extension du côté :ref:`Side<enum_@GlobalScope_Side>` spécifié.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_set_border_width:
.. rst-class:: classref-method
|void| **set_border_width**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, width\: :ref:`int<class_int>`\ ) :ref:`🔗<class_StyleBoxFlat_method_set_border_width>`
Définit la largeur de la bordure du côté :ref:`Side<enum_@GlobalScope_Side>` spécifié à ``width`` pixels.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_set_border_width_all:
.. rst-class:: classref-method
|void| **set_border_width_all**\ (\ width\: :ref:`int<class_int>`\ ) :ref:`🔗<class_StyleBoxFlat_method_set_border_width_all>`
Définit la largeur de la bordure à ``width`` pixels pour tous les côtés.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_set_corner_radius:
.. rst-class:: classref-method
|void| **set_corner_radius**\ (\ corner\: :ref:`Corner<enum_@GlobalScope_Corner>`, radius\: :ref:`int<class_int>`\ ) :ref:`🔗<class_StyleBoxFlat_method_set_corner_radius>`
Définit le rayon de coin à ``radius`` pixels pour le coin ``corner`` donné.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_set_corner_radius_all:
.. rst-class:: classref-method
|void| **set_corner_radius_all**\ (\ radius\: :ref:`int<class_int>`\ ) :ref:`🔗<class_StyleBoxFlat_method_set_corner_radius_all>`
Définit le rayon de coin à ``radius`` pixels pour tous les coins.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_set_expand_margin:
.. rst-class:: classref-method
|void| **set_expand_margin**\ (\ margin\: :ref:`Side<enum_@GlobalScope_Side>`, size\: :ref:`float<class_float>`\ ) :ref:`🔗<class_StyleBoxFlat_method_set_expand_margin>`
Définit la marge d'élargissement à ``size`` pixels pour le côté :ref:`Side<enum_@GlobalScope_Side>` spécifié.
.. rst-class:: classref-item-separator
----
.. _class_StyleBoxFlat_method_set_expand_margin_all:
.. rst-class:: classref-method
|void| **set_expand_margin_all**\ (\ size\: :ref:`float<class_float>`\ ) :ref:`🔗<class_StyleBoxFlat_method_set_expand_margin_all>`
Définit la marge d'élargissement à ``size`` pixels pour tous les côtés.
.. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)`
.. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)`
.. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)`
.. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)`
.. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)`
.. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)`
.. |void| replace:: :abbr:`void (Aucune valeur de retour.)`
Reference in New Issue View Git Blame Copy Permalink