2017-09-13 04:42:36 +08:00
<?xml version="1.0" encoding="UTF-8" ?>
2023-07-06 16:08:05 +08:00
<class name= "SplitContainer" inherits= "Container" xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation= "../class.xsd" >
2017-09-13 04:42:36 +08:00
<brief_description >
2023-04-30 22:26:09 +08:00
A container that splits two child controls horizontally or vertically and provides a grabber for adjusting the split ratio.
2017-09-13 04:42:36 +08:00
</brief_description>
<description >
2023-04-30 22:26:09 +08:00
A container that accepts only two child controls, then arranges them horizontally or vertically and creates a divisor between them. The divisor can be dragged around to change the size relation between the child controls.
2017-09-13 04:42:36 +08:00
</description>
<tutorials >
2023-04-30 22:26:09 +08:00
<link title= "Using Containers" > $DOCS_URL/tutorials/ui/gui_containers.html</link>
2017-09-13 04:42:36 +08:00
</tutorials>
<methods >
2018-11-23 08:06:24 +08:00
<method name= "clamp_split_offset" >
2021-07-30 21:28:05 +08:00
<return type= "void" />
2018-11-23 08:06:24 +08:00
<description >
2020-01-06 05:19:08 +08:00
Clamps the [member split_offset] value to not go outside the currently possible minimal and maximum values.
2018-11-23 08:06:24 +08:00
</description>
</method>
2017-09-13 04:42:36 +08:00
</methods>
<members >
2019-06-29 18:38:01 +08:00
<member name= "collapsed" type= "bool" setter= "set_collapsed" getter= "is_collapsed" default= "false" >
2020-01-06 05:19:08 +08:00
If [code]true[/code], the area of the first [Control] will be collapsed and the dragger will be disabled.
2017-09-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "dragger_visibility" type= "int" setter= "set_dragger_visibility" getter= "get_dragger_visibility" enum= "SplitContainer.DraggerVisibility" default= "0" >
2020-01-06 05:19:08 +08:00
Determines the dragger's visibility. See [enum DraggerVisibility] for details.
2017-09-13 04:42:36 +08:00
</member>
2019-06-29 18:38:01 +08:00
<member name= "split_offset" type= "int" setter= "set_split_offset" getter= "get_split_offset" default= "0" >
2020-01-06 05:19:08 +08:00
The initial offset of the splitting between the two [Control]s, with [code]0[/code] being at the end of the first [Control].
2017-09-13 04:42:36 +08:00
</member>
2022-08-22 19:08:57 +08:00
<member name= "vertical" type= "bool" setter= "set_vertical" getter= "is_vertical" default= "false" >
If [code]true[/code], the [SplitContainer] will arrange its children vertically, rather than horizontally.
Can't be changed when using [HSplitContainer] and [VSplitContainer].
</member>
2017-09-13 04:42:36 +08:00
</members>
<signals >
<signal name= "dragged" >
2022-08-07 02:11:48 +08:00
<param index= "0" name= "offset" type= "int" />
2017-09-13 04:42:36 +08:00
<description >
Emitted when the dragger is dragged by user.
</description>
</signal>
</signals>
<constants >
2017-11-25 06:16:30 +08:00
<constant name= "DRAGGER_VISIBLE" value= "0" enum= "DraggerVisibility" >
2020-01-06 05:19:08 +08:00
The split dragger is visible when the cursor hovers it.
2017-09-13 04:42:36 +08:00
</constant>
2017-11-25 06:16:30 +08:00
<constant name= "DRAGGER_HIDDEN" value= "1" enum= "DraggerVisibility" >
2020-01-06 05:19:08 +08:00
The split dragger is never visible.
2017-09-13 04:42:36 +08:00
</constant>
2017-11-25 06:16:30 +08:00
<constant name= "DRAGGER_HIDDEN_COLLAPSED" value= "2" enum= "DraggerVisibility" >
2020-01-06 05:19:08 +08:00
The split dragger is never visible and its space collapsed.
2017-09-13 04:42:36 +08:00
</constant>
</constants>
2022-08-22 19:08:57 +08:00
<theme_items >
<theme_item name= "autohide" data_type= "constant" type= "int" default= "1" >
Boolean value. If 1 ([code]true[/code]), the grabber will hide automatically when it isn't under the cursor. If 0 ([code]false[/code]), it's always visible.
</theme_item>
2022-09-02 23:59:36 +08:00
<theme_item name= "minimum_grab_thickness" data_type= "constant" type= "int" default= "6" >
The minimum thickness of the area users can click on to grab the splitting line. If [theme_item separation] or [theme_item h_grabber] / [theme_item v_grabber]'s thickness are too small, this ensure that the splitting line can still be dragged.
</theme_item>
2022-08-22 19:08:57 +08:00
<theme_item name= "separation" data_type= "constant" type= "int" default= "12" >
The space between sides of the container.
</theme_item>
2023-09-26 22:41:24 +08:00
<theme_item name= "grabber" data_type= "icon" type= "Texture2D" >
The icon used for the grabber drawn in the middle area.
</theme_item>
2022-08-22 19:08:57 +08:00
<theme_item name= "h_grabber" data_type= "icon" type= "Texture2D" >
The icon used for the grabber drawn in the middle area when [member vertical] is [code]false[/code].
</theme_item>
<theme_item name= "v_grabber" data_type= "icon" type= "Texture2D" >
The icon used for the grabber drawn in the middle area when [member vertical] is [code]true[/code].
</theme_item>
</theme_items>
2017-09-13 04:42:36 +08:00
</class>