[GUI] Implement Properties that can Recursively Disable Child Controls' Focus Mode & Mouse Filter

[Delsin-Yu]

Closes godotengine/godot-proposals#8200

This mechanism makes it easier for developers to manipulate a group of controls under one single control, such as disabling elements under a panel while retaining their visibility.

QQ2024927-173954.mp4

Previous Design

Add two properties and methods to `Control`: |PropertyName|Description| |--|--| |`focus_none_recursive`|When set to true, all recursive child nodes will have their `focus_mode` overridden to `None`.| |`mouse_ignore_recursive`|When set to true, all recursive child nodes will have their `mouse_filter` overridden to `Ignore`.|

These two properties do not change the original values in the child nodes.

MethodName	Description
get_focus_mode_with_recursive	get_focus_mode but takes parent's focus_none_recursive property into account.
get_mouse_filter_with_recursive	get_mouse_filter but takes parent's mouse_ignore_recursive property into account.

The addition of this mechanism makes it easier for developers to manipulate a group of controls under one single control, such as disabling elements under a panel while retaining their visibility.

QQ2024926-224220.mp4

New Design

This new design enables child control to ignore the parent's recursive setting.
Added the following members to Control:

These two properties do not change the original values in the child nodes.

PropertyName	EnumType	Description
focus_recursive_behavior	RecursiveBehavior	Controls whether the recursive child nodes should have their focus_mode overridden to FOCUS_NONE when evaluating input.
mouse_recursive_behavior	RecursiveBehavior	Controls whether the recursive child nodes should have their mouse_filter overridden to MOUSE_FILTER_IGNORE when evaluating input.

MethodName	Description
get_focus_mode_with_recursive	get_focus_mode but takes parent's focus_recursive_behavior property into account.
get_mouse_filter_with_recursive	get_mouse_filter but takes parent's mouse_recursive_behavior property into account.

EnumType	Description
RECURSIVE_BEHAVIOR_INHERIT	Inherits the associated behavior from the control's parent. This is the default for any newly created control.
RECURSIVE_BEHAVIOR_DISABLED	The current control and all its recursive child controls have their associated behavior disabled, regardless of the parent control's configuration.
RECURSIVE_BEHAVIOR_ENABLED	The current control and all its recursive child controls have their associated behavior enabled, regardless of the parent control's configuration.

Script Attached to the Buttons

@tool
extends Button

func _ready():
	add_theme_font_size_override("font_size", 35)

func _process(_delta:float):
	text = get_focus_mode_str(get_focus_mode_with_recursive()) + "\n" + get_mouse_filter_str(get_mouse_filter_with_recursive());

func get_focus_mode_str(mode: FocusMode):
	if mode == FocusMode.FOCUS_NONE:
		return "FocusMode.NONE";
	if mode == FocusMode.FOCUS_CLICK:
		return "FocusMode.CLICK";
	if mode == FocusMode.FOCUS_ALL:
		return "FocusMode.ALL";
	return "???";

func get_mouse_filter_str(filter: MouseFilter):
	if filter == MouseFilter.MOUSE_FILTER_STOP:
		return "MouseFilter.STOP";
	if filter == MouseFilter.MOUSE_FILTER_PASS:
		return "MouseFilter.PASS";
	if filter == MouseFilter.MOUSE_FILTER_IGNORE:
		return "MouseFilter.IGNORE";
	return "???";

[Delsin-Yu]

I admit these properties can have a better naming