Improve Control and Label documentation about mouse filtering
Fixes #9657.
This commit is contained in:
parent
52165fa12d
commit
7251c5b582
2 changed files with 7 additions and 6 deletions
|
@ -632,7 +632,7 @@
|
||||||
Distance between the node's top edge and its parent container, based on [member anchor_top].
|
Distance between the node's top edge and its parent container, based on [member anchor_top].
|
||||||
</member>
|
</member>
|
||||||
<member name="mouse_filter" type="int" setter="set_mouse_filter" getter="get_mouse_filter" enum="Control.MouseFilter">
|
<member name="mouse_filter" type="int" setter="set_mouse_filter" getter="get_mouse_filter" enum="Control.MouseFilter">
|
||||||
Controls whether the control will be able to receive mouse button input events through [Control._gui_input] and how these events should be handled. Use one of the [code]MOUSE_FILTER_*[/code] constants. See the constants to learn what each does.
|
Controls whether the control will be able to receive mouse button input events through [method _gui_input] and how these events should be handled. Use one of the [code]MOUSE_FILTER_*[/code] constants. See the constants to learn what each does.
|
||||||
</member>
|
</member>
|
||||||
<member name="rect_clip_content" type="bool" setter="set_clip_contents" getter="is_clipping_contents">
|
<member name="rect_clip_content" type="bool" setter="set_clip_contents" getter="is_clipping_contents">
|
||||||
</member>
|
</member>
|
||||||
|
@ -697,12 +697,12 @@
|
||||||
</signal>
|
</signal>
|
||||||
<signal name="mouse_entered">
|
<signal name="mouse_entered">
|
||||||
<description>
|
<description>
|
||||||
Emitted when the mouse enters the control's [code]Rect[/code] area.
|
Emitted when the mouse enters the control's [code]Rect[/code] area, provided its [member mouse_filter] lets the event reach it.
|
||||||
</description>
|
</description>
|
||||||
</signal>
|
</signal>
|
||||||
<signal name="mouse_exited">
|
<signal name="mouse_exited">
|
||||||
<description>
|
<description>
|
||||||
Emitted when the mouse leaves the control's [code]Rect[/code] area.
|
Emitted when the mouse leaves the control's [code]Rect[/code] area, provided its [member mouse_filter] lets the event reach it.
|
||||||
</description>
|
</description>
|
||||||
</signal>
|
</signal>
|
||||||
<signal name="resized">
|
<signal name="resized">
|
||||||
|
@ -870,13 +870,13 @@
|
||||||
Tells the parent [Container] to align the node with its end, either the bottom or the right edge. It doesn't work with the fill or expand size flags. Use with [member size_flags_horizontal] and [member size_flags_vertical].
|
Tells the parent [Container] to align the node with its end, either the bottom or the right edge. It doesn't work with the fill or expand size flags. Use with [member size_flags_horizontal] and [member size_flags_vertical].
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="MOUSE_FILTER_STOP" value="0" enum="MouseFilter">
|
<constant name="MOUSE_FILTER_STOP" value="0" enum="MouseFilter">
|
||||||
The control will receive mouse button input events through [method Control._gui_input] if clicked on. These events are automatically marked as handled and they will not propogate further to other controls.
|
The control will receive mouse button input events through [method _gui_input] if clicked on. These events are automatically marked as handled and they will not propagate further to other controls.
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="MOUSE_FILTER_PASS" value="1" enum="MouseFilter">
|
<constant name="MOUSE_FILTER_PASS" value="1" enum="MouseFilter">
|
||||||
The control will receive mouse button input events through [method Control._gui_input] if clicked on. If this control does not handle the event, the parent control (if any) will be considered for a mouse click, and so on until there is no more parent control to potentially handle it. Even if no control handled it at all, the event will still be handled automatically.
|
The control will receive mouse button input events through [method _gui_input] if clicked on. If this control does not handle the event, the parent control (if any) will be considered for a mouse click, and so on until there is no more parent control to potentially handle it. Even if no control handled it at all, the event will still be handled automatically.
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="MOUSE_FILTER_IGNORE" value="2" enum="MouseFilter">
|
<constant name="MOUSE_FILTER_IGNORE" value="2" enum="MouseFilter">
|
||||||
The control will not receive mouse button input events through [method Control._gui_input] and will not block other controls from receiving these events. These events will also not be handled automatically.
|
The control will not receive mouse button input events through [method _gui_input] and will not block other controls from receiving these events. These events will also not be handled automatically.
|
||||||
</constant>
|
</constant>
|
||||||
<constant name="GROW_DIRECTION_BEGIN" value="0" enum="GrowDirection">
|
<constant name="GROW_DIRECTION_BEGIN" value="0" enum="GrowDirection">
|
||||||
</constant>
|
</constant>
|
||||||
|
|
|
@ -5,6 +5,7 @@
|
||||||
</brief_description>
|
</brief_description>
|
||||||
<description>
|
<description>
|
||||||
Label displays plain text on the screen. It gives you control over the horizontal and vertical alignment, and can wrap the text inside the node's bounding rectangle. It doesn't support bold, italics or other formatting. For that, use [RichTextLabel] instead.
|
Label displays plain text on the screen. It gives you control over the horizontal and vertical alignment, and can wrap the text inside the node's bounding rectangle. It doesn't support bold, italics or other formatting. For that, use [RichTextLabel] instead.
|
||||||
|
Note that contrarily to most other [Control]s, Label's [member Control.mouse_filter] defaults to MOUSE_FILTER_IGNORE (i.e. it doesn't react to mouse input events).
|
||||||
</description>
|
</description>
|
||||||
<tutorials>
|
<tutorials>
|
||||||
</tutorials>
|
</tutorials>
|
||||||
|
|
Loading…
Reference in a new issue