From f10432656ce3e44fa2a9035f547d9d5c7d803b06 Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Sat, 23 Nov 2024 18:31:16 +0100 Subject: [PATCH] Document focus StyleBox caveats in Introduction to GUI skinning --- tutorials/ui/gui_skinning.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/tutorials/ui/gui_skinning.rst b/tutorials/ui/gui_skinning.rst index 4ebefa18823..40edba6780e 100644 --- a/tutorials/ui/gui_skinning.rst +++ b/tutorials/ui/gui_skinning.rst @@ -86,6 +86,12 @@ a unique name and must be one of the following data types: not limited to the :ref:`Panel ` control, as styleboxes are used by many controls for their backgrounds and overlays. + Different controls will apply StyleBoxes in a different manner. Most notably, + ``focus`` styleboxes are drawn as an *overlay* to other styleboxes (such as + ``normal`` or ``pressed``) to allow the base stylebox to remain visible. + This means the focus stylebox should be designed as an outline or translucent + box, so that its background can remain visible. + Theme types ~~~~~~~~~~~