Files
godot-docs-l10n/classes/ru/class_window.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

2937 lines
185 KiB
ReStructuredText
Raw Permalink Blame History

This file contains ambiguous Unicode characters

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_Window:
Window
======
**Наследует:** :ref:`Viewport<class_Viewport>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
**Наследуется от:** :ref:`AcceptDialog<class_AcceptDialog>`, :ref:`Popup<class_Popup>`
Базовый класс для всех окон, диалоговых окон и всплывающих окон.
.. rst-class:: classref-introduction-group
Описание
----------------
Узел, создающий окно. Окно может быть как собственным системным окном, так и встроенным в другое **Window** (см. :ref:`Viewport.gui_embed_subwindows<class_Viewport_property_gui_embed_subwindows>`).
Во время выполнения **Window** не будут автоматически закрываться при запросе. Вам нужно обработать это вручную с помощью сигнала :ref:`close_requested<class_Window_signal_close_requested>` (это применимо как к нажатию кнопки закрытия, так и к щелчку за пределами всплывающего окна).
.. rst-class:: classref-reftable-group
Свойства
----------------
.. table::
:widths: auto
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`String<class_String>` | :ref:`accessibility_description<class_Window_property_accessibility_description>` | ``""`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`String<class_String>` | :ref:`accessibility_name<class_Window_property_accessibility_name>` | ``""`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`always_on_top<class_Window_property_always_on_top>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`auto_translate<class_Window_property_auto_translate>` | |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`borderless<class_Window_property_borderless>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>` | :ref:`content_scale_aspect<class_Window_property_content_scale_aspect>` | ``0`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`float<class_float>` | :ref:`content_scale_factor<class_Window_property_content_scale_factor>` | ``1.0`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`ContentScaleMode<enum_Window_ContentScaleMode>` | :ref:`content_scale_mode<class_Window_property_content_scale_mode>` | ``0`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`content_scale_size<class_Window_property_content_scale_size>` | ``Vector2i(0, 0)`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`ContentScaleStretch<enum_Window_ContentScaleStretch>` | :ref:`content_scale_stretch<class_Window_property_content_scale_stretch>` | ``0`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`int<class_int>` | :ref:`current_screen<class_Window_property_current_screen>` | |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`exclude_from_capture<class_Window_property_exclude_from_capture>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`exclusive<class_Window_property_exclusive>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`extend_to_title<class_Window_property_extend_to_title>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`force_native<class_Window_property_force_native>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` | :ref:`initial_position<class_Window_property_initial_position>` | ``0`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`keep_title_visible<class_Window_property_keep_title_visible>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`max_size<class_Window_property_max_size>` | ``Vector2i(0, 0)`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`maximize_disabled<class_Window_property_maximize_disabled>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`min_size<class_Window_property_min_size>` | ``Vector2i(0, 0)`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`minimize_disabled<class_Window_property_minimize_disabled>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Mode<enum_Window_Mode>` | :ref:`mode<class_Window_property_mode>` | ``0`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`mouse_passthrough<class_Window_property_mouse_passthrough>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`PackedVector2Array<class_PackedVector2Array>` | :ref:`mouse_passthrough_polygon<class_Window_property_mouse_passthrough_polygon>` | ``PackedVector2Array()`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Rect2i<class_Rect2i>` | :ref:`nonclient_area<class_Window_property_nonclient_area>` | ``Rect2i(0, 0, 0, 0)`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`popup_window<class_Window_property_popup_window>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`popup_wm_hint<class_Window_property_popup_wm_hint>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`position<class_Window_property_position>` | ``Vector2i(0, 0)`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`sharp_corners<class_Window_property_sharp_corners>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`size<class_Window_property_size>` | ``Vector2i(100, 100)`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`Theme<class_Theme>` | :ref:`theme<class_Window_property_theme>` | |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`StringName<class_StringName>` | :ref:`theme_type_variation<class_Window_property_theme_type_variation>` | ``&""`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`String<class_String>` | :ref:`title<class_Window_property_title>` | ``""`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`transient<class_Window_property_transient>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`transient_to_focused<class_Window_property_transient_to_focused>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`transparent<class_Window_property_transparent>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`unfocusable<class_Window_property_unfocusable>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`unresizable<class_Window_property_unresizable>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`visible<class_Window_property_visible>` | ``true`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
| :ref:`bool<class_bool>` | :ref:`wrap_controls<class_Window_property_wrap_controls>` | ``false`` |
+-----------------------------------------------------------------+-----------------------------------------------------------------------------------+--------------------------+
.. rst-class:: classref-reftable-group
Методы
------------
.. table::
:widths: auto
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`_get_contents_minimum_size<class_Window_private_method__get_contents_minimum_size>`\ (\ ) |virtual| |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_theme_color_override<class_Window_method_add_theme_color_override>`\ (\ name\: :ref:`StringName<class_StringName>`, color\: :ref:`Color<class_Color>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_theme_constant_override<class_Window_method_add_theme_constant_override>`\ (\ name\: :ref:`StringName<class_StringName>`, constant\: :ref:`int<class_int>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_theme_font_override<class_Window_method_add_theme_font_override>`\ (\ name\: :ref:`StringName<class_StringName>`, font\: :ref:`Font<class_Font>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_theme_font_size_override<class_Window_method_add_theme_font_size_override>`\ (\ name\: :ref:`StringName<class_StringName>`, font_size\: :ref:`int<class_int>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_theme_icon_override<class_Window_method_add_theme_icon_override>`\ (\ name\: :ref:`StringName<class_StringName>`, texture\: :ref:`Texture2D<class_Texture2D>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_theme_stylebox_override<class_Window_method_add_theme_stylebox_override>`\ (\ name\: :ref:`StringName<class_StringName>`, stylebox\: :ref:`StyleBox<class_StyleBox>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`begin_bulk_theme_override<class_Window_method_begin_bulk_theme_override>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`can_draw<class_Window_method_can_draw>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`child_controls_changed<class_Window_method_child_controls_changed>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`end_bulk_theme_override<class_Window_method_end_bulk_theme_override>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2<class_Vector2>` | :ref:`get_contents_minimum_size<class_Window_method_get_contents_minimum_size>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`get_flag<class_Window_method_get_flag>`\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Window<class_Window>` | :ref:`get_focused_window<class_Window_method_get_focused_window>`\ (\ ) |static| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`LayoutDirection<enum_Window_LayoutDirection>` | :ref:`get_layout_direction<class_Window_method_get_layout_direction>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`get_position_with_decorations<class_Window_method_get_position_with_decorations>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Vector2i<class_Vector2i>` | :ref:`get_size_with_decorations<class_Window_method_get_size_with_decorations>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Color<class_Color>` | :ref:`get_theme_color<class_Window_method_get_theme_color>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_theme_constant<class_Window_method_get_theme_constant>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`get_theme_default_base_scale<class_Window_method_get_theme_default_base_scale>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Font<class_Font>` | :ref:`get_theme_default_font<class_Window_method_get_theme_default_font>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_theme_default_font_size<class_Window_method_get_theme_default_font_size>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Font<class_Font>` | :ref:`get_theme_font<class_Window_method_get_theme_font>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_theme_font_size<class_Window_method_get_theme_font_size>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`get_theme_icon<class_Window_method_get_theme_icon>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`get_theme_stylebox<class_Window_method_get_theme_stylebox>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`get_window_id<class_Window_method_get_window_id>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`grab_focus<class_Window_method_grab_focus>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_focus<class_Window_method_has_focus>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_color<class_Window_method_has_theme_color>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_color_override<class_Window_method_has_theme_color_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_constant<class_Window_method_has_theme_constant>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_constant_override<class_Window_method_has_theme_constant_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_font<class_Window_method_has_theme_font>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_font_override<class_Window_method_has_theme_font_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_font_size<class_Window_method_has_theme_font_size>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_font_size_override<class_Window_method_has_theme_font_size_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_icon<class_Window_method_has_theme_icon>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_icon_override<class_Window_method_has_theme_icon_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_stylebox<class_Window_method_has_theme_stylebox>`\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`has_theme_stylebox_override<class_Window_method_has_theme_stylebox_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`hide<class_Window_method_hide>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_embedded<class_Window_method_is_embedded>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_layout_rtl<class_Window_method_is_layout_rtl>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_maximize_allowed<class_Window_method_is_maximize_allowed>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_using_font_oversampling<class_Window_method_is_using_font_oversampling>`\ (\ ) |const| |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`move_to_center<class_Window_method_move_to_center>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`move_to_foreground<class_Window_method_move_to_foreground>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup<class_Window_method_popup>`\ (\ rect\: :ref:`Rect2i<class_Rect2i>` = Rect2i(0, 0, 0, 0)\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_centered<class_Window_method_popup_centered>`\ (\ minsize\: :ref:`Vector2i<class_Vector2i>` = Vector2i(0, 0)\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_centered_clamped<class_Window_method_popup_centered_clamped>`\ (\ minsize\: :ref:`Vector2i<class_Vector2i>` = Vector2i(0, 0), fallback_ratio\: :ref:`float<class_float>` = 0.75\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_centered_ratio<class_Window_method_popup_centered_ratio>`\ (\ ratio\: :ref:`float<class_float>` = 0.8\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_exclusive<class_Window_method_popup_exclusive>`\ (\ from_node\: :ref:`Node<class_Node>`, rect\: :ref:`Rect2i<class_Rect2i>` = Rect2i(0, 0, 0, 0)\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_exclusive_centered<class_Window_method_popup_exclusive_centered>`\ (\ from_node\: :ref:`Node<class_Node>`, minsize\: :ref:`Vector2i<class_Vector2i>` = Vector2i(0, 0)\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_exclusive_centered_clamped<class_Window_method_popup_exclusive_centered_clamped>`\ (\ from_node\: :ref:`Node<class_Node>`, minsize\: :ref:`Vector2i<class_Vector2i>` = Vector2i(0, 0), fallback_ratio\: :ref:`float<class_float>` = 0.75\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_exclusive_centered_ratio<class_Window_method_popup_exclusive_centered_ratio>`\ (\ from_node\: :ref:`Node<class_Node>`, ratio\: :ref:`float<class_float>` = 0.8\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_exclusive_on_parent<class_Window_method_popup_exclusive_on_parent>`\ (\ from_node\: :ref:`Node<class_Node>`, parent_rect\: :ref:`Rect2i<class_Rect2i>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`popup_on_parent<class_Window_method_popup_on_parent>`\ (\ parent_rect\: :ref:`Rect2i<class_Rect2i>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_theme_color_override<class_Window_method_remove_theme_color_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_theme_constant_override<class_Window_method_remove_theme_constant_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_theme_font_override<class_Window_method_remove_theme_font_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_theme_font_size_override<class_Window_method_remove_theme_font_size_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_theme_icon_override<class_Window_method_remove_theme_icon_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_theme_stylebox_override<class_Window_method_remove_theme_stylebox_override>`\ (\ name\: :ref:`StringName<class_StringName>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`request_attention<class_Window_method_request_attention>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`reset_size<class_Window_method_reset_size>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_flag<class_Window_method_set_flag>`\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_ime_active<class_Window_method_set_ime_active>`\ (\ active\: :ref:`bool<class_bool>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_ime_position<class_Window_method_set_ime_position>`\ (\ position\: :ref:`Vector2i<class_Vector2i>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_layout_direction<class_Window_method_set_layout_direction>`\ (\ direction\: :ref:`LayoutDirection<enum_Window_LayoutDirection>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_unparent_when_invisible<class_Window_method_set_unparent_when_invisible>`\ (\ unparent\: :ref:`bool<class_bool>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`set_use_font_oversampling<class_Window_method_set_use_font_oversampling>`\ (\ enable\: :ref:`bool<class_bool>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`show<class_Window_method_show>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`start_drag<class_Window_method_start_drag>`\ (\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`start_resize<class_Window_method_start_resize>`\ (\ edge\: :ref:`WindowResizeEdge<enum_DisplayServer_WindowResizeEdge>`\ ) |
+-----------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
Свойства темы
--------------------------
.. table::
:widths: auto
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`title_color<class_Window_theme_color_title_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`title_outline_modulate<class_Window_theme_color_title_outline_modulate>` | ``Color(0, 0, 0, 1)`` |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`close_h_offset<class_Window_theme_constant_close_h_offset>` | ``18`` |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`close_v_offset<class_Window_theme_constant_close_v_offset>` | ``24`` |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`resize_margin<class_Window_theme_constant_resize_margin>` | ``4`` |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`title_height<class_Window_theme_constant_title_height>` | ``36`` |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`title_outline_size<class_Window_theme_constant_title_outline_size>` | ``0`` |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Font<class_Font>` | :ref:`title_font<class_Window_theme_font_title_font>` | |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`title_font_size<class_Window_theme_font_size_title_font_size>` | |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`close<class_Window_theme_icon_close>` | |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`close_pressed<class_Window_theme_icon_close_pressed>` | |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`embedded_border<class_Window_theme_style_embedded_border>` | |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`embedded_unfocused_border<class_Window_theme_style_embedded_unfocused_border>` | |
+-----------------------------------+--------------------------------------------------------------------------------------+-----------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Сигналы
--------------
.. _class_Window_signal_about_to_popup:
.. rst-class:: classref-signal
**about_to_popup**\ (\ ) :ref:`🔗<class_Window_signal_about_to_popup>`
Вызывается сразу после вызова :ref:`popup()<class_Window_method_popup>`, до того, как появится **Window** или произойдет что-либо еще.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_close_requested:
.. rst-class:: classref-signal
**close_requested**\ (\ ) :ref:`🔗<class_Window_signal_close_requested>`
Выдается при нажатии кнопки закрытия **Window**, или когда :ref:`popup_window<class_Window_property_popup_window>` включен и пользователь щелкает за пределами окна.
Этот сигнал можно использовать для обработки закрытия окна, например, подключив его к :ref:`hide()<class_Window_method_hide>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_dpi_changed:
.. rst-class:: classref-signal
**dpi_changed**\ (\ ) :ref:`🔗<class_Window_signal_dpi_changed>`
Выдается, когда DPI **Window** изменяется в результате изменений на уровне ОС (например, перемещение окна с дисплея Retina на дисплей с более низким разрешением).
\ **Примечание:** Реализовано только в macOS и Linux (Wayland).
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_files_dropped:
.. rst-class:: classref-signal
**files_dropped**\ (\ files\: :ref:`PackedStringArray<class_PackedStringArray>`\ ) :ref:`🔗<class_Window_signal_files_dropped>`
Выдается при перетаскивании файлов из файлового менеджера ОС в окно игры. Аргумент — список путей к файлам.
::
func _ready():
get_window().files_dropped.connect(on_files_dropped)
func on_files_dropped(files):
print(files)
\ **Примечание:** Этот сигнал работает только с собственными окнами, т. е. главным окном и производными от **Window** узла, и когда :ref:`Viewport.gui_embed_subwindows<class_Viewport_property_gui_embed_subwindows>` отключен в главном окне просмотра.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_focus_entered:
.. rst-class:: classref-signal
**focus_entered**\ (\ ) :ref:`🔗<class_Window_signal_focus_entered>`
Вызывается, когда **Window** получает фокус.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_focus_exited:
.. rst-class:: classref-signal
**focus_exited**\ (\ ) :ref:`🔗<class_Window_signal_focus_exited>`
Возникает, когда **Window** теряет фокус.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_go_back_requested:
.. rst-class:: classref-signal
**go_back_requested**\ (\ ) :ref:`🔗<class_Window_signal_go_back_requested>`
Вызывается при отправке запроса на возврат (например, при нажатии кнопки "Назад" на Android), сразу после :ref:`Node.NOTIFICATION_WM_GO_BACK_REQUEST<class_Node_constant_NOTIFICATION_WM_GO_BACK_REQUEST>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_mouse_entered:
.. rst-class:: classref-signal
**mouse_entered**\ (\ ) :ref:`🔗<class_Window_signal_mouse_entered>`
Вызывается, когда курсор мыши попадает в видимую область **Window**, которая не перекрыта другими :ref:`Control<class_Control>` или окнами, при условии, что его :ref:`Viewport.gui_disable_input<class_Viewport_property_gui_disable_input>` имеет значение ``false`` и независимо от того, находится ли он в данный момент в фокусе или нет.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_mouse_exited:
.. rst-class:: classref-signal
**mouse_exited**\ (\ ) :ref:`🔗<class_Window_signal_mouse_exited>`
Вызывается, когда курсор мыши покидает видимую область **Window**, которая не перекрыта другими :ref:`Control<class_Control>` или окнами, при условии, что его :ref:`Viewport.gui_disable_input<class_Viewport_property_gui_disable_input>` имеет значение ``false`` и независимо от того, находится ли он в данный момент в фокусе или нет.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_nonclient_window_input:
.. rst-class:: classref-signal
**nonclient_window_input**\ (\ event\: :ref:`InputEvent<class_InputEvent>`\ ) :ref:`🔗<class_Window_signal_nonclient_window_input>`
Emitted when the mouse event is received by the custom decoration area defined by :ref:`nonclient_area<class_Window_property_nonclient_area>`, and normal input to the window is blocked (such as when it has an exclusive child opened). ``event``'s position is in the embedder's coordinate system.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_theme_changed:
.. rst-class:: classref-signal
**theme_changed**\ (\ ) :ref:`🔗<class_Window_signal_theme_changed>`
Вызывается при отправке уведомления :ref:`NOTIFICATION_THEME_CHANGED<class_Window_constant_NOTIFICATION_THEME_CHANGED>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_title_changed:
.. rst-class:: classref-signal
**title_changed**\ (\ ) :ref:`🔗<class_Window_signal_title_changed>`
Выдается при изменении текста заголовка окна.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_titlebar_changed:
.. rst-class:: classref-signal
**titlebar_changed**\ (\ ) :ref:`🔗<class_Window_signal_titlebar_changed>`
Генерируется при изменении оформления заголовка окна, например, при входе/выходе окна macOS из полноэкранного режима или при изменении флага расширения до заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_visibility_changed:
.. rst-class:: classref-signal
**visibility_changed**\ (\ ) :ref:`🔗<class_Window_signal_visibility_changed>`
Выдается, когда **Window** становится видимым или исчезает.
.. rst-class:: classref-item-separator
----
.. _class_Window_signal_window_input:
.. rst-class:: classref-signal
**window_input**\ (\ event\: :ref:`InputEvent<class_InputEvent>`\ ) :ref:`🔗<class_Window_signal_window_input>`
Генерируется, когда **Window** в данный момент сфокусировано и принимает какие-либо входные данные, передавая полученное событие в качестве аргумента. Положение события, если оно присутствует, находится в системе координат внедренца.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Перечисления
------------------------
.. _enum_Window_Mode:
.. rst-class:: classref-enumeration
enum **Mode**: :ref:`🔗<enum_Window_Mode>`
.. _class_Window_constant_MODE_WINDOWED:
.. rst-class:: classref-enumeration-constant
:ref:`Mode<enum_Window_Mode>` **MODE_WINDOWED** = ``0``
Оконный режим, т. е. **Window** не занимает весь экран (если не установлен размер экрана).
.. _class_Window_constant_MODE_MINIMIZED:
.. rst-class:: classref-enumeration-constant
:ref:`Mode<enum_Window_Mode>` **MODE_MINIMIZED** = ``1``
Режим минимизированного окна, т.е. **Window** не отображается и недоступно в списке окон оконного менеджера. Обычно происходит при нажатии кнопки минимизации.
.. _class_Window_constant_MODE_MAXIMIZED:
.. rst-class:: classref-enumeration-constant
:ref:`Mode<enum_Window_Mode>` **MODE_MAXIMIZED** = ``2``
Режим развернутого окна, т. е. **Window** займет всю область экрана, кроме панели задач, и по-прежнему будет отображать ее границы. Обычно это происходит при нажатии кнопки развертывания.
.. _class_Window_constant_MODE_FULLSCREEN:
.. rst-class:: classref-enumeration-constant
:ref:`Mode<enum_Window_Mode>` **MODE_FULLSCREEN** = ``3``
Полноэкранный режим с полной поддержкой многооконности.
Полноэкранное окно охватывает всю область отображения экрана и не имеет украшений. Видеорежим дисплея не изменяется.
\ **На Android:** Это включает режим погружения.
\ **На macOS:** Новый рабочий стол используется для отображения запущенного проекта.
\ **Примечание:** Независимо от платформы, включение полноэкранного режима изменит размер окна в соответствии с размером монитора. Поэтому убедитесь, что ваш проект поддерживает :doc:`несколько разрешений <../tutorials/rendering/multiple_resolutions>` при включении полноэкранного режима.
.. _class_Window_constant_MODE_EXCLUSIVE_FULLSCREEN:
.. rst-class:: classref-enumeration-constant
:ref:`Mode<enum_Window_Mode>` **MODE_EXCLUSIVE_FULLSCREEN** = ``4``
Однооконный полноэкранный режим. Этот режим менее нагружает систему, но на данном экране одновременно может быть открыто только одно окно (открытие дочернего окна или переключение приложений запускает полноэкранный переход).
Полноэкранное окно занимает всю область экрана без рамки или декоративных элементов. Видеорежим дисплея не изменяется.
\ **Примечание:** Этот режим может не работать с программами для записи экрана.
\ **На Android:** Это включает режим погружения.
\ **На Windows:** В зависимости от видеодрайвера, полноэкранный переход может привести к кратковременному потемнению экрана.
\ **На macOS:** Для отображения запущенного проекта используется новый рабочий стол. Эксклюзивный полноэкранный режим предотвращает отображение Dock и меню при наведении указателя мыши на край экрана.
\ **На Linux (X11):** Эксклюзивный полноэкранный режим обходит композитора.
\ **В Linux (Wayland):** Эквивалентно :ref:`MODE_FULLSCREEN<class_Window_constant_MODE_FULLSCREEN>`.
\ **Примечание:** Независимо от платформы, включение полноэкранного режима изменит размер окна в соответствии с размером монитора. Поэтому убедитесь, что ваш проект поддерживает :doc:`множественные разрешения <../tutorials/rendering/multiple_resolutions>` при включении полноэкранного режима.
.. rst-class:: classref-item-separator
----
.. _enum_Window_Flags:
.. rst-class:: classref-enumeration
enum **Flags**: :ref:`🔗<enum_Window_Flags>`
.. _class_Window_constant_FLAG_RESIZE_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_RESIZE_DISABLED** = ``0``
Размер окна нельзя изменить, перетаскивая его ручку изменения размера. По-прежнему можно изменить размер окна, используя :ref:`size<class_Window_property_size>`. Этот флаг игнорируется для полноэкранных окон. Устанавливается с помощью :ref:`unresizable<class_Window_property_unresizable>`.
.. _class_Window_constant_FLAG_BORDERLESS:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_BORDERLESS** = ``1``
Окно не имеет встроенной строки заголовка и другого декора. Этот флаг игнорируется для полноэкранных окон. Устанавливается с помощью :ref:`borderless<class_Window_property_borderless>`.
.. _class_Window_constant_FLAG_ALWAYS_ON_TOP:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_ALWAYS_ON_TOP** = ``2``
Окно плавает поверх всех остальных окон. Этот флаг игнорируется для полноэкранных окон. Устанавливается с помощью :ref:`always_on_top<class_Window_property_always_on_top>`.
.. _class_Window_constant_FLAG_TRANSPARENT:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_TRANSPARENT** = ``3``
Фон окна может быть прозрачным. Задается с помощью :ref:`transparent<class_Window_property_transparent>`.
\ **Примечание:** Этот флаг не действует, если :ref:`ProjectSettings.display/window/per_pixel_transparency/allowed<class_ProjectSettings_property_display/window/per_pixel_transparency/allowed>`, либо для окна :ref:`Viewport.transparent_bg<class_Viewport_property_transparent_bg>` установлено значение ``false``.
.. _class_Window_constant_FLAG_NO_FOCUS:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_NO_FOCUS** = ``4``
Окно не может быть сфокусировано. Окно без фокуса будет игнорировать все вводимые данные, кроме щелчков мыши. Задано с помощью :ref:`unfocusable<class_Window_property_unfocusable>`.
.. _class_Window_constant_FLAG_POPUP:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_POPUP** = ``5``
Window является частью выпадающего списка меню или кнопки выбора :ref:`OptionButton<class_OptionButton>`. Этот флаг нельзя изменить, когда окно видно. Активное всплывающее окно будет получать все вводимые данные единолично, не отвлекая внимание от своего родительского элемента. Всплывающие окна автоматически закрываются, когда пользователь нажимает за их пределами или когда приложение переключается. У всплывающего окна должен быть установлен временный родительский набор (см. :ref:`transient<class_Window_property_transient>`).
\ **Примечание:** Этот флаг не действует во встроенных окнах (если только указанное окно не является всплывающим :ref:`Popup<class_Popup>`).
.. _class_Window_constant_FLAG_EXTEND_TO_TITLE:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_EXTEND_TO_TITLE** = ``6``
Содержимое окна расширяется до полного размера окна. В отличие от окна без полей, рамка остается нетронутой и может использоваться для изменения размера окна, строка заголовка прозрачна, но имеет кнопки сворачивания/максимизации/закрытия. Устанавливается с помощью :ref:`extend_to_title<class_Window_property_extend_to_title>`.
\ **Примечание:** Этот флаг реализован только в macOS.
\ ** Примечание:** Этот флаг не действует во встроенной Windows.
.. _class_Window_constant_FLAG_MOUSE_PASSTHROUGH:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_MOUSE_PASSTHROUGH** = ``7``
Все события мыши передаются в базовое окно того же приложения.
\ **Примечание:** Этот флаг не действует во встроенных окнах.
.. _class_Window_constant_FLAG_SHARP_CORNERS:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_SHARP_CORNERS** = ``8``
Стиль окна переопределен, что приводит к появлению острых углов.
\ **Примечание:** Этот флаг не действует во встроенных окнах.
\ **Примечание:** Этот флаг реализован только в Windows (11).
.. _class_Window_constant_FLAG_EXCLUDE_FROM_CAPTURE:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_EXCLUDE_FROM_CAPTURE** = ``9``
Окно Windows не учитывается при создании снимков экрана с помощью :ref:`DisplayServer.screen_get_image()<class_DisplayServer_method_screen_get_image>`, :ref:`DisplayServer.screen_get_image_rect()<class_DisplayServer_method_screen_get_image_rect>` и :ref:`DisplayServer.screen_get_pixel()<class_DisplayServer_method_screen_get_pixel>`.
\ **Примечание:** Этот флаг не действует во встроенных окнах.
\ **Примечание:** Этот флаг реализован в macOS и Windows (10, 20H1).
\ **Примечание:** Установка этого флага предотвратит захват изображения окна стандартными методами, но **НЕ** гарантирует, что другие приложения не смогут сделать снимок. Его не следует использовать в качестве DRM-защиты или меры безопасности.
.. _class_Window_constant_FLAG_POPUP_WM_HINT:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_POPUP_WM_HINT** = ``10``
Сообщает диспетчеру окон, что данное окно должно быть «всплывающим» окном, определяемым реализацией (обычно плавающим, безрамочным, неразворачиваемым и неподвижным дочерним окном).
.. _class_Window_constant_FLAG_MINIMIZE_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_MINIMIZE_DISABLED** = ``11``
Кнопка минимизации окна отключена.
\ **Примечание:** Этот флаг реализован в macOS и Windows.
.. _class_Window_constant_FLAG_MAXIMIZE_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_MAXIMIZE_DISABLED** = ``12``
Кнопка максимизации окна отключена.
\ **Примечание:** Этот флаг реализован в macOS и Windows.
.. _class_Window_constant_FLAG_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`Flags<enum_Window_Flags>` **FLAG_MAX** = ``13``
Максимальное значение :ref:`Flags<enum_Window_Flags>`.
.. rst-class:: classref-item-separator
----
.. _enum_Window_ContentScaleMode:
.. rst-class:: classref-enumeration
enum **ContentScaleMode**: :ref:`🔗<enum_Window_ContentScaleMode>`
.. _class_Window_constant_CONTENT_SCALE_MODE_DISABLED:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleMode<enum_Window_ContentScaleMode>` **CONTENT_SCALE_MODE_DISABLED** = ``0``
Содержимое не будет масштабироваться в соответствии с размером **Window**.
.. _class_Window_constant_CONTENT_SCALE_MODE_CANVAS_ITEMS:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleMode<enum_Window_ContentScaleMode>` **CONTENT_SCALE_MODE_CANVAS_ITEMS** = ``1``
Содержимое будет отображаться в целевом размере. Это более затратно по производительности, чем :ref:`CONTENT_SCALE_MODE_VIEWPORT<class_Window_constant_CONTENT_SCALE_MODE_VIEWPORT>`, но обеспечивает лучшие результаты.
.. _class_Window_constant_CONTENT_SCALE_MODE_VIEWPORT:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleMode<enum_Window_ContentScaleMode>` **CONTENT_SCALE_MODE_VIEWPORT** = ``2``
Содержимое будет отображено в базовом размере, а затем масштабировано до целевого размера. Более производительно, чем :ref:`CONTENT_SCALE_MODE_CANVAS_ITEMS<class_Window_constant_CONTENT_SCALE_MODE_CANVAS_ITEMS>`, но приводит к пикселизации изображения.
.. rst-class:: classref-item-separator
----
.. _enum_Window_ContentScaleAspect:
.. rst-class:: classref-enumeration
enum **ContentScaleAspect**: :ref:`🔗<enum_Window_ContentScaleAspect>`
.. _class_Window_constant_CONTENT_SCALE_ASPECT_IGNORE:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>` **CONTENT_SCALE_ASPECT_IGNORE** = ``0``
Аспект будет проигнорирован. Масштабирование просто растянет содержимое в соответствии с целевым размером.
.. _class_Window_constant_CONTENT_SCALE_ASPECT_KEEP:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>` **CONTENT_SCALE_ASPECT_KEEP** = ``1``
Формат содержимого будет сохранен. Если целевой размер отличается от базового, изображение будет отцентрировано, а с левой и правой сторон появятся черные полосы.
.. _class_Window_constant_CONTENT_SCALE_ASPECT_KEEP_WIDTH:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>` **CONTENT_SCALE_ASPECT_KEEP_WIDTH** = ``2``
Содержимое можно развернуть по вертикали. Масштабирование по горизонтали приведет к сохранению соотношения ширины, а затем черных полос с левой и правой сторон.
.. _class_Window_constant_CONTENT_SCALE_ASPECT_KEEP_HEIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>` **CONTENT_SCALE_ASPECT_KEEP_HEIGHT** = ``3``
Содержимое можно развернуть по горизонтали. Масштабирование по вертикали приведет к сохранению соотношения высот, а затем черных полос сверху и снизу.
.. _class_Window_constant_CONTENT_SCALE_ASPECT_EXPAND:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>` **CONTENT_SCALE_ASPECT_EXPAND** = ``4``
Формат содержимого будет сохранен. Если целевой размер отличается от базового, содержимое останется в верхнем левом углу и добавит дополнительную видимую область в растянутом пространстве.
.. rst-class:: classref-item-separator
----
.. _enum_Window_ContentScaleStretch:
.. rst-class:: classref-enumeration
enum **ContentScaleStretch**: :ref:`🔗<enum_Window_ContentScaleStretch>`
.. _class_Window_constant_CONTENT_SCALE_STRETCH_FRACTIONAL:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleStretch<enum_Window_ContentScaleStretch>` **CONTENT_SCALE_STRETCH_FRACTIONAL** = ``0``
Содержимое будет растянуто в соответствии с дробным коэффициентом. Это заполняет все доступное пространство в окне, но допускает "колебание пикселя" из-за неравномерного масштабирования пикселей.
.. _class_Window_constant_CONTENT_SCALE_STRETCH_INTEGER:
.. rst-class:: classref-enumeration-constant
:ref:`ContentScaleStretch<enum_Window_ContentScaleStretch>` **CONTENT_SCALE_STRETCH_INTEGER** = ``1``
Содержимое будет растянуто только в соответствии с целым коэффициентом, сохраняя четкие пиксели. В зависимости от размера окна по краям окна может быть виден черный фон.
.. rst-class:: classref-item-separator
----
.. _enum_Window_LayoutDirection:
.. rst-class:: classref-enumeration
enum **LayoutDirection**: :ref:`🔗<enum_Window_LayoutDirection>`
.. _class_Window_constant_LAYOUT_DIRECTION_INHERITED:
.. rst-class:: classref-enumeration-constant
:ref:`LayoutDirection<enum_Window_LayoutDirection>` **LAYOUT_DIRECTION_INHERITED** = ``0``
Автоматическое направление компоновки, определяемое по направлению компоновки родительского окна.
.. _class_Window_constant_LAYOUT_DIRECTION_APPLICATION_LOCALE:
.. rst-class:: classref-enumeration-constant
:ref:`LayoutDirection<enum_Window_LayoutDirection>` **LAYOUT_DIRECTION_APPLICATION_LOCALE** = ``1``
Автоматическое направление макета, определяемое на основе текущей локали.
.. _class_Window_constant_LAYOUT_DIRECTION_LTR:
.. rst-class:: classref-enumeration-constant
:ref:`LayoutDirection<enum_Window_LayoutDirection>` **LAYOUT_DIRECTION_LTR** = ``2``
Направление макета слева направо.
.. _class_Window_constant_LAYOUT_DIRECTION_RTL:
.. rst-class:: classref-enumeration-constant
:ref:`LayoutDirection<enum_Window_LayoutDirection>` **LAYOUT_DIRECTION_RTL** = ``3``
Направление раскладки справа налево.
.. _class_Window_constant_LAYOUT_DIRECTION_SYSTEM_LOCALE:
.. rst-class:: classref-enumeration-constant
:ref:`LayoutDirection<enum_Window_LayoutDirection>` **LAYOUT_DIRECTION_SYSTEM_LOCALE** = ``4``
Автоматическое направление макета, определяемое на основе локали системы.
.. _class_Window_constant_LAYOUT_DIRECTION_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`LayoutDirection<enum_Window_LayoutDirection>` **LAYOUT_DIRECTION_MAX** = ``5``
Представляет размер перечисления :ref:`LayoutDirection<enum_Window_LayoutDirection>`.
.. _class_Window_constant_LAYOUT_DIRECTION_LOCALE:
.. rst-class:: classref-enumeration-constant
:ref:`LayoutDirection<enum_Window_LayoutDirection>` **LAYOUT_DIRECTION_LOCALE** = ``1``
**Устарело:** Use :ref:`LAYOUT_DIRECTION_APPLICATION_LOCALE<class_Window_constant_LAYOUT_DIRECTION_APPLICATION_LOCALE>` instead.
.. rst-class:: classref-item-separator
----
.. _enum_Window_WindowInitialPosition:
.. rst-class:: classref-enumeration
enum **WindowInitialPosition**: :ref:`🔗<enum_Window_WindowInitialPosition>`
.. _class_Window_constant_WINDOW_INITIAL_POSITION_ABSOLUTE:
.. rst-class:: classref-enumeration-constant
:ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` **WINDOW_INITIAL_POSITION_ABSOLUTE** = ``0``
Начальное положение окна определяется :ref:`position<class_Window_property_position>`.
.. _class_Window_constant_WINDOW_INITIAL_POSITION_CENTER_PRIMARY_SCREEN:
.. rst-class:: classref-enumeration-constant
:ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` **WINDOW_INITIAL_POSITION_CENTER_PRIMARY_SCREEN** = ``1``
Начальное положение окна — центр основного экрана.
.. _class_Window_constant_WINDOW_INITIAL_POSITION_CENTER_MAIN_WINDOW_SCREEN:
.. rst-class:: classref-enumeration-constant
:ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` **WINDOW_INITIAL_POSITION_CENTER_MAIN_WINDOW_SCREEN** = ``2``
Начальное положение окна — центр экрана главного окна.
.. _class_Window_constant_WINDOW_INITIAL_POSITION_CENTER_OTHER_SCREEN:
.. rst-class:: classref-enumeration-constant
:ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` **WINDOW_INITIAL_POSITION_CENTER_OTHER_SCREEN** = ``3``
Начальная позиция окна - это центр экрана :ref:`current_screen<class_Window_property_current_screen>`.
.. _class_Window_constant_WINDOW_INITIAL_POSITION_CENTER_SCREEN_WITH_MOUSE_FOCUS:
.. rst-class:: classref-enumeration-constant
:ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` **WINDOW_INITIAL_POSITION_CENTER_SCREEN_WITH_MOUSE_FOCUS** = ``4``
Начальным положением окна является центр экрана, на котором находится указатель мыши.
.. _class_Window_constant_WINDOW_INITIAL_POSITION_CENTER_SCREEN_WITH_KEYBOARD_FOCUS:
.. rst-class:: classref-enumeration-constant
:ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` **WINDOW_INITIAL_POSITION_CENTER_SCREEN_WITH_KEYBOARD_FOCUS** = ``5``
Начальное положение окна - это центр экрана, содержащий окно с фокусом клавиатуры.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Константы
------------------
.. _class_Window_constant_NOTIFICATION_VISIBILITY_CHANGED:
.. rst-class:: classref-constant
**NOTIFICATION_VISIBILITY_CHANGED** = ``30`` :ref:`🔗<class_Window_constant_NOTIFICATION_VISIBILITY_CHANGED>`
Испускается при изменении видимости **Window**, непосредственно перед :ref:`visibility_changed<class_Window_signal_visibility_changed>`.
.. _class_Window_constant_NOTIFICATION_THEME_CHANGED:
.. rst-class:: classref-constant
**NOTIFICATION_THEME_CHANGED** = ``32`` :ref:`🔗<class_Window_constant_NOTIFICATION_THEME_CHANGED>`
Отправляется, когда узлу необходимо обновить элементы своей темы. Это происходит в одном из следующих случаев:
- Свойство :ref:`theme<class_Window_property_theme>` изменено на этом узле или любом из его предков.
- Свойство :ref:`theme_type_variation<class_Window_property_theme_type_variation>` изменено на этом узле.
- Узел входит в дерево сцен.
\ **Примечание:** В качестве оптимизации это уведомление не будет отправлено из-за изменений, которые происходят, когда этот узел находится за пределами дерева сцен. Вместо этого все обновления элементов темы могут быть применены сразу, когда узел входит в дерево сцены.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Описания свойств
--------------------------------
.. _class_Window_property_accessibility_description:
.. rst-class:: classref-property
:ref:`String<class_String>` **accessibility_description** = ``""`` :ref:`🔗<class_Window_property_accessibility_description>`
.. rst-class:: classref-property-setget
- |void| **set_accessibility_description**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_accessibility_description**\ (\ )
Удобочитаемое описание узла, которое передается вспомогательным приложениям.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_accessibility_name:
.. rst-class:: classref-property
:ref:`String<class_String>` **accessibility_name** = ``""`` :ref:`🔗<class_Window_property_accessibility_name>`
.. rst-class:: classref-property-setget
- |void| **set_accessibility_name**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_accessibility_name**\ (\ )
Удобочитаемое имя узла, которое сообщается вспомогательным приложениям.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_always_on_top:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **always_on_top** = ``false`` :ref:`🔗<class_Window_property_always_on_top>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, окно будет поверх всех других окон. Не работает, если включен :ref:`transient<class_Window_property_transient>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_auto_translate:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **auto_translate** :ref:`🔗<class_Window_property_auto_translate>`
.. rst-class:: classref-property-setget
- |void| **set_auto_translate**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_auto_translating**\ (\ )
**Устарело:** Use :ref:`Node.auto_translate_mode<class_Node_property_auto_translate_mode>` and :ref:`Node.can_auto_translate()<class_Node_method_can_auto_translate>` instead.
Включает/выключает автоматическую замену текста на переведенную версию в зависимости от текущей локали.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_borderless:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **borderless** = ``false`` :ref:`🔗<class_Window_property_borderless>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, окно не будет иметь границ.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_content_scale_aspect:
.. rst-class:: classref-property
:ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>` **content_scale_aspect** = ``0`` :ref:`🔗<class_Window_property_content_scale_aspect>`
.. rst-class:: classref-property-setget
- |void| **set_content_scale_aspect**\ (\ value\: :ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>`\ )
- :ref:`ContentScaleAspect<enum_Window_ContentScaleAspect>` **get_content_scale_aspect**\ (\ )
Указывает, как ведет себя аспект содержимого при изменении размера **Window**. Базовый аспект определяется :ref:`content_scale_size<class_Window_property_content_scale_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_content_scale_factor:
.. rst-class:: classref-property
:ref:`float<class_float>` **content_scale_factor** = ``1.0`` :ref:`🔗<class_Window_property_content_scale_factor>`
.. rst-class:: classref-property-setget
- |void| **set_content_scale_factor**\ (\ value\: :ref:`float<class_float>`\ )
- :ref:`float<class_float>` **get_content_scale_factor**\ (\ )
Указывает базовый масштаб содержимого **Window**, когда его :ref:`size<class_Window_property_size>` равен :ref:`content_scale_size<class_Window_property_content_scale_size>`. См. также :ref:`Viewport.get_stretch_transform()<class_Viewport_method_get_stretch_transform>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_content_scale_mode:
.. rst-class:: classref-property
:ref:`ContentScaleMode<enum_Window_ContentScaleMode>` **content_scale_mode** = ``0`` :ref:`🔗<class_Window_property_content_scale_mode>`
.. rst-class:: classref-property-setget
- |void| **set_content_scale_mode**\ (\ value\: :ref:`ContentScaleMode<enum_Window_ContentScaleMode>`\ )
- :ref:`ContentScaleMode<enum_Window_ContentScaleMode>` **get_content_scale_mode**\ (\ )
Указывает, как масштабируется содержимое при изменении размера **Window**.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_content_scale_size:
.. rst-class:: classref-property
:ref:`Vector2i<class_Vector2i>` **content_scale_size** = ``Vector2i(0, 0)`` :ref:`🔗<class_Window_property_content_scale_size>`
.. rst-class:: classref-property-setget
- |void| **set_content_scale_size**\ (\ value\: :ref:`Vector2i<class_Vector2i>`\ )
- :ref:`Vector2i<class_Vector2i>` **get_content_scale_size**\ (\ )
Базовый размер содержимого (т. е. узлов, которые рисуются внутри окна). Если не равно нулю, содержимое **Window** будет масштабироваться при изменении размера окна до другого размера.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_content_scale_stretch:
.. rst-class:: classref-property
:ref:`ContentScaleStretch<enum_Window_ContentScaleStretch>` **content_scale_stretch** = ``0`` :ref:`🔗<class_Window_property_content_scale_stretch>`
.. rst-class:: classref-property-setget
- |void| **set_content_scale_stretch**\ (\ value\: :ref:`ContentScaleStretch<enum_Window_ContentScaleStretch>`\ )
- :ref:`ContentScaleStretch<enum_Window_ContentScaleStretch>` **get_content_scale_stretch**\ (\ )
Политика, используемая для определения окончательного масштабного коэффициента для 2D-элементов. Это влияет на то, как применяется :ref:`content_scale_factor<class_Window_property_content_scale_factor>`, в дополнение к автоматическому масштабному коэффициенту, определяемому :ref:`content_scale_size<class_Window_property_content_scale_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_current_screen:
.. rst-class:: classref-property
:ref:`int<class_int>` **current_screen** :ref:`🔗<class_Window_property_current_screen>`
.. rst-class:: classref-property-setget
- |void| **set_current_screen**\ (\ value\: :ref:`int<class_int>`\ )
- :ref:`int<class_int>` **get_current_screen**\ (\ )
Экран, на котором в данный момент находится окно.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_exclude_from_capture:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **exclude_from_capture** = ``false`` :ref:`🔗<class_Window_property_exclude_from_capture>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, **Window** исключается из снимков экрана, сделанных с помощью :ref:`DisplayServer.screen_get_image()<class_DisplayServer_method_screen_get_image>`, :ref:`DisplayServer.screen_get_image_rect()<class_DisplayServer_method_screen_get_image_rect>` и :ref:`DisplayServer.screen_get_pixel()<class_DisplayServer_method_screen_get_pixel>`.
\ **Примечание:** Это свойство реализовано в macOS и Windows.
\ **Примечание:** Включение этого параметра предотвратит захват изображения окна стандартными методами создания снимков экрана, но **НЕ** гарантирует, что другие приложения не смогут сделать снимок. Это не следует использовать в качестве DRM или меры безопасности.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_exclusive:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **exclusive** = ``false`` :ref:`🔗<class_Window_property_exclusive>`
.. rst-class:: classref-property-setget
- |void| **set_exclusive**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_exclusive**\ (\ )
Если ``true``, **Window** будет в монопольном режиме. Монопольный режим всегда находится поверх родительского окна и блокирует весь ввод, идущий в родительское **Window**.
Для работы необходимо включить :ref:`transient<class_Window_property_transient>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_extend_to_title:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **extend_to_title** = ``false`` :ref:`🔗<class_Window_property_extend_to_title>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, содержимое **Window** расширяется до полного размера окна, строка заголовка окна становится прозрачной.
\ **Примечание:** Это свойство реализовано только в macOS.
\ ** Примечание:** Это свойство работает только в Windows.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_force_native:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **force_native** = ``false`` :ref:`🔗<class_Window_property_force_native>`
.. rst-class:: classref-property-setget
- |void| **set_force_native**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_force_native**\ (\ )
Если ``true``, будет использоваться собственное окно независимо от родительского окна просмотра и настроек проекта.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_initial_position:
.. rst-class:: classref-property
:ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` **initial_position** = ``0`` :ref:`🔗<class_Window_property_initial_position>`
.. rst-class:: classref-property-setget
- |void| **set_initial_position**\ (\ value\: :ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>`\ )
- :ref:`WindowInitialPosition<enum_Window_WindowInitialPosition>` **get_initial_position**\ (\ )
Указывает начальный тип положения для **Window**.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_keep_title_visible:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **keep_title_visible** = ``false`` :ref:`🔗<class_Window_property_keep_title_visible>`
.. rst-class:: classref-property-setget
- |void| **set_keep_title_visible**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_keep_title_visible**\ (\ )
Если ``true``, ширина **Window** увеличивается, чтобы текст заголовка был полностью виден.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_max_size:
.. rst-class:: classref-property
:ref:`Vector2i<class_Vector2i>` **max_size** = ``Vector2i(0, 0)`` :ref:`🔗<class_Window_property_max_size>`
.. rst-class:: classref-property-setget
- |void| **set_max_size**\ (\ value\: :ref:`Vector2i<class_Vector2i>`\ )
- :ref:`Vector2i<class_Vector2i>` **get_max_size**\ (\ )
Если не равно нулю, **Window** не может быть изменено, чтобы стать больше этого размера.
\ **Примечание:** Это свойство будет игнорироваться, если значение меньше, чем :ref:`min_size<class_Window_property_min_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_maximize_disabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **maximize_disabled** = ``false`` :ref:`🔗<class_Window_property_maximize_disabled>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, кнопка разворачивания **Window** отключена.
\ **Примечание:** Если отключены обе кнопки — сворачивания и разворачивания, — кнопки полностью скрыты, и видна только кнопка закрытия.
\ **Примечание:** Это свойство реализовано только в macOS и Windows.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_min_size:
.. rst-class:: classref-property
:ref:`Vector2i<class_Vector2i>` **min_size** = ``Vector2i(0, 0)`` :ref:`🔗<class_Window_property_min_size>`
.. rst-class:: classref-property-setget
- |void| **set_min_size**\ (\ value\: :ref:`Vector2i<class_Vector2i>`\ )
- :ref:`Vector2i<class_Vector2i>` **get_min_size**\ (\ )
Если не равно нулю, **Window** нельзя изменить, чтобы он стал меньше этого размера.
\ **Примечание:** Это свойство будет игнорироваться в пользу :ref:`get_contents_minimum_size()<class_Window_method_get_contents_minimum_size>`, если :ref:`wrap_controls<class_Window_property_wrap_controls>` включен и его размер больше.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_minimize_disabled:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **minimize_disabled** = ``false`` :ref:`🔗<class_Window_property_minimize_disabled>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, кнопка сворачивания **Window** отключена.
\ **Примечание:** Если отключены обе кнопки сворачивания и разворачивания, кнопки полностью скрыты, и видна только кнопка закрытия.
\ **Примечание:** Это свойство реализовано только в macOS и Windows.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_mode:
.. rst-class:: classref-property
:ref:`Mode<enum_Window_Mode>` **mode** = ``0`` :ref:`🔗<class_Window_property_mode>`
.. rst-class:: classref-property-setget
- |void| **set_mode**\ (\ value\: :ref:`Mode<enum_Window_Mode>`\ )
- :ref:`Mode<enum_Window_Mode>` **get_mode**\ (\ )
Устанавливает текущий режим окна.
\ **Примечание:** Полноэкранный режим не является исключительным полноэкранным режимом в Windows и Linux.
\ **Примечание:** Этот метод работает только с собственными окнами, т. е. главным окном и производными от **Window** узлами, когда :ref:`Viewport.gui_embed_subwindows<class_Viewport_property_gui_embed_subwindows>` отключен в главном окне просмотра.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_mouse_passthrough:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **mouse_passthrough** = ``false`` :ref:`🔗<class_Window_property_mouse_passthrough>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, все события, связанные с мышью, будут передаваться в основное окно того же приложения. Смотрите также :ref:`mouse_passthrough_polygon<class_Window_property_mouse_passthrough_polygon>`.
\ **Примечание:** Это свойство реализовано в Linux (X11), macOS и Windows.
\ ** Примечание:** Это свойство работает только в операционной системе Windows.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_mouse_passthrough_polygon:
.. rst-class:: classref-property
:ref:`PackedVector2Array<class_PackedVector2Array>` **mouse_passthrough_polygon** = ``PackedVector2Array()`` :ref:`🔗<class_Window_property_mouse_passthrough_polygon>`
.. rst-class:: classref-property-setget
- |void| **set_mouse_passthrough_polygon**\ (\ value\: :ref:`PackedVector2Array<class_PackedVector2Array>`\ )
- :ref:`PackedVector2Array<class_PackedVector2Array>` **get_mouse_passthrough_polygon**\ (\ )
Устанавливает многоугольную область окна, которая принимает события мыши. События мыши за пределами области будут пропущены.
Передача пустого массива отключит поддержку сквозной передачи (все события мыши будут перехвачены окном, что является поведением по умолчанию).
.. tabs::
.. code-tab:: gdscript
# Задайте регион, используя узел Path2D.
$Window.mouse_passthrough_polygon = $Path2D.curve.get_baked_points()
# Установить регион, используя узел Polygon2D.
$Window.mouse_passthrough_polygon = $Polygon2D.polygon
# сбросить регион по умолчанию.
$Window.mouse_passthrough_polygon = []
.. code-tab:: csharp
// Задайте регион, используя узел Path2D.
GetNode<Window>("Window").MousePassthroughPolygon = GetNode<Path2D>("Path2D").Curve.GetBakedPoints();
// Установить регион, используя узел Polygon2D.
GetNode<Window>("Window").MousePassthroughPolygon = GetNode<Polygon2D>("Polygon2D").Polygon;
// сбросить регион по умолчанию
GetNode<Window>("Window").MousePassthroughPolygon = [];
\ **Примечание:** Это свойство игнорируется, если :ref:`mouse_passthrough<class_Window_property_mouse_passthrough>` установлен в ``true``.
\ **Примечание:** В Windows часть окна, которая находится за пределами области, не отрисовывается, тогда как в Linux (X11) и macOS — отрисовывается.
\ **Примечание:** Это свойство реализовано в Linux (X11), macOS и Windows.
**Note:** The returned array is *copied* and any changes to it will not update the original property value. See :ref:`PackedVector2Array<class_PackedVector2Array>` for more details.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_nonclient_area:
.. rst-class:: classref-property
:ref:`Rect2i<class_Rect2i>` **nonclient_area** = ``Rect2i(0, 0, 0, 0)`` :ref:`🔗<class_Window_property_nonclient_area>`
.. rst-class:: classref-property-setget
- |void| **set_nonclient_area**\ (\ value\: :ref:`Rect2i<class_Rect2i>`\ )
- :ref:`Rect2i<class_Rect2i>` **get_nonclient_area**\ (\ )
If set, defines the window's custom decoration area which will receive mouse input, even if normal input to the window is blocked (such as when it has an exclusive child opened). See also :ref:`nonclient_window_input<class_Window_signal_nonclient_window_input>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_popup_window:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **popup_window** = ``false`` :ref:`🔗<class_Window_property_popup_window>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, **Window** будет считаться всплывающим. Всплывающие окна — это подокна, которые не отображаются как отдельные окна в списке окон системного менеджера окон и будут отправлять запрос на закрытие при щелчке по чему-либо за их пределами (если не включено :ref:`exclusive<class_Window_property_exclusive>`).
.. rst-class:: classref-item-separator
----
.. _class_Window_property_popup_wm_hint:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **popup_wm_hint** = ``false`` :ref:`🔗<class_Window_property_popup_wm_hint>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, **Window** будет сигнализировать оконному менеджеру, что оно должно быть «всплывающим» окном, определяемым реализацией (обычно плавающим, безрамочным, неразворачиваемым и неподвижным дочерним окном).
.. rst-class:: classref-item-separator
----
.. _class_Window_property_position:
.. rst-class:: classref-property
:ref:`Vector2i<class_Vector2i>` **position** = ``Vector2i(0, 0)`` :ref:`🔗<class_Window_property_position>`
.. rst-class:: classref-property-setget
- |void| **set_position**\ (\ value\: :ref:`Vector2i<class_Vector2i>`\ )
- :ref:`Vector2i<class_Vector2i>` **get_position**\ (\ )
Положение окна в пикселях.
Если :ref:`ProjectSettings.display/window/subwindows/embed_subwindows<class_ProjectSettings_property_display/window/subwindows/embed_subwindows>` равно ``false``, положение указывается в абсолютных координатах экрана. Обычно это относится к плагинам редактора. Если параметр равен ``true``, положение окна указывается в координатах его родительского :ref:`Viewport<class_Viewport>`.
\ **Примечание:** Это свойство работает, только если :ref:`initial_position<class_Window_property_initial_position>` равно :ref:`WINDOW_INITIAL_POSITION_ABSOLUTE<class_Window_constant_WINDOW_INITIAL_POSITION_ABSOLUTE>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_sharp_corners:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **sharp_corners** = ``false`` :ref:`🔗<class_Window_property_sharp_corners>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, **Window** переопределит стиль окна ОС для отображения острых углов.
\ **Примечание:** Это свойство реализовано только в Windows (11).
\ **Примечание:** Это свойство работает только с нативными окнами.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_size:
.. rst-class:: classref-property
:ref:`Vector2i<class_Vector2i>` **size** = ``Vector2i(100, 100)`` :ref:`🔗<class_Window_property_size>`
.. rst-class:: classref-property-setget
- |void| **set_size**\ (\ value\: :ref:`Vector2i<class_Vector2i>`\ )
- :ref:`Vector2i<class_Vector2i>` **get_size**\ (\ )
Размер окна в пикселях.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_theme:
.. rst-class:: classref-property
:ref:`Theme<class_Theme>` **theme** :ref:`🔗<class_Window_property_theme>`
.. rst-class:: classref-property-setget
- |void| **set_theme**\ (\ value\: :ref:`Theme<class_Theme>`\ )
- :ref:`Theme<class_Theme>` **get_theme**\ (\ )
Ресурс :ref:`Theme<class_Theme>`, который использует этот узел и все его дочерние элементы :ref:`Control<class_Control>` и **Window**. Если дочерний узел имеет свой собственный набор ресурсов :ref:`Theme<class_Theme>`, элементы темы объединяются с определениями дочернего элемента, имеющими более высокий приоритет.
\ **Примечание:** Стили **Window** не будут иметь никакого эффекта, если окно не встроено.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_theme_type_variation:
.. rst-class:: classref-property
:ref:`StringName<class_StringName>` **theme_type_variation** = ``&""`` :ref:`🔗<class_Window_property_theme_type_variation>`
.. rst-class:: classref-property-setget
- |void| **set_theme_type_variation**\ (\ value\: :ref:`StringName<class_StringName>`\ )
- :ref:`StringName<class_StringName>` **get_theme_type_variation**\ (\ )
Имя вариации типа темы, используемой этим **Window** для поиска собственных элементов темы. См. :ref:`Control.theme_type_variation<class_Control_property_theme_type_variation>` для получения более подробной информации.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_title:
.. rst-class:: classref-property
:ref:`String<class_String>` **title** = ``""`` :ref:`🔗<class_Window_property_title>`
.. rst-class:: classref-property-setget
- |void| **set_title**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_title**\ (\ )
Заголовок окна. Если **Window** является собственным, стили заголовка, заданные в :ref:`Theme<class_Theme>`, не будут иметь никакого эффекта.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_transient:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **transient** = ``false`` :ref:`🔗<class_Window_property_transient>`
.. rst-class:: classref-property-setget
- |void| **set_transient**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_transient**\ (\ )
Если ``true``, **Window** является переходным, т. е. оно считается дочерним элементом другого **Window**. Переходное окно будет уничтожено вместе со своим переходным родителем и вернет фокус родителю при закрытии. Переходное окно отображается поверх неисключительного полноэкранного родительского окна. Переходные окна не могут переходить в полноэкранный режим.
Обратите внимание, что поведение может отличаться в зависимости от платформы.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_transient_to_focused:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **transient_to_focused** = ``false`` :ref:`🔗<class_Window_property_transient_to_focused>`
.. rst-class:: classref-property-setget
- |void| **set_transient_to_focused**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_transient_to_focused**\ (\ )
Если ``true``, а **Window**:ref:`transient<class_Window_property_transient>`, это окно (в момент, когда становится видимым) станет переходным к текущему окну, находящемуся в фокусе, а не к непосредственному родительскому окну в иерархии. Обратите внимание, что переходный родитель назначается в момент, когда это окно становится видимым, поэтому его последующее изменение не оказывает никакого эффекта, пока не будет показано снова.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_transparent:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **transparent** = ``false`` :ref:`🔗<class_Window_property_transparent>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, фон **Window** может быть прозрачным. Лучше всего использовать это со встроенными окнами.
\ **Примечание:** Поддержка прозрачности реализована в Linux, macOS и Windows, но доступность может зависеть от драйвера графического процессора, диспетчера отображения и возможностей композитора.
\ **Примечание:** Это свойство не имеет эффекта, если :ref:`ProjectSettings.display/window/per_pixel_transparency/allowed<class_ProjectSettings_property_display/window/per_pixel_transparency/allowed>` установлено в ``false``.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_unfocusable:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **unfocusable** = ``false`` :ref:`🔗<class_Window_property_unfocusable>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, **Window** не может быть сфокусирован и с ним нельзя взаимодействовать. Он все еще может быть видимым.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_unresizable:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **unresizable** = ``false`` :ref:`🔗<class_Window_property_unresizable>`
.. rst-class:: classref-property-setget
- |void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const|
Если ``true``, размер окна изменить нельзя.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_visible:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **visible** = ``true`` :ref:`🔗<class_Window_property_visible>`
.. rst-class:: classref-property-setget
- |void| **set_visible**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_visible**\ (\ )
Если ``true``, окно видимо.
.. rst-class:: classref-item-separator
----
.. _class_Window_property_wrap_controls:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **wrap_controls** = ``false`` :ref:`🔗<class_Window_property_wrap_controls>`
.. rst-class:: classref-property-setget
- |void| **set_wrap_controls**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_wrapping_controls**\ (\ )
Если ``true``, размер окна будет автоматически обновляться при добавлении или удалении дочернего узла, игнорируя :ref:`min_size<class_Window_property_min_size>`, если новый размер больше.
Если ``false``, то вам необходимо вручную вызвать :ref:`child_controls_changed()<class_Window_method_child_controls_changed>`.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Описания метода
------------------------------
.. _class_Window_private_method__get_contents_minimum_size:
.. rst-class:: classref-method
:ref:`Vector2<class_Vector2>` **_get_contents_minimum_size**\ (\ ) |virtual| |const| :ref:`🔗<class_Window_private_method__get_contents_minimum_size>`
Виртуальный метод, реализуемый пользователем. Переопределяет значение, возвращаемое :ref:`get_contents_minimum_size()<class_Window_method_get_contents_minimum_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_add_theme_color_override:
.. rst-class:: classref-method
|void| **add_theme_color_override**\ (\ name\: :ref:`StringName<class_StringName>`, color\: :ref:`Color<class_Color>`\ ) :ref:`🔗<class_Window_method_add_theme_color_override>`
Создает локальное переопределение для темы :ref:`Color<class_Color>` с указанным ``name``. Локальные переопределения всегда имеют приоритет при извлечении элементов темы для элемента управления. Переопределение можно удалить с помощью :ref:`remove_theme_color_override()<class_Window_method_remove_theme_color_override>`.
См. также :ref:`get_theme_color()<class_Window_method_get_theme_color>` и :ref:`Control.add_theme_color_override()<class_Control_method_add_theme_color_override>` для получения дополнительных сведений.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_add_theme_constant_override:
.. rst-class:: classref-method
|void| **add_theme_constant_override**\ (\ name\: :ref:`StringName<class_StringName>`, constant\: :ref:`int<class_int>`\ ) :ref:`🔗<class_Window_method_add_theme_constant_override>`
Создает локальное переопределение для константы темы с указанным ``name``. Локальные переопределения всегда имеют приоритет при извлечении элементов темы для элемента управления. Переопределение можно удалить с помощью :ref:`remove_theme_constant_override()<class_Window_method_remove_theme_constant_override>`.
См. также :ref:`get_theme_constant()<class_Window_method_get_theme_constant>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_add_theme_font_override:
.. rst-class:: classref-method
|void| **add_theme_font_override**\ (\ name\: :ref:`StringName<class_StringName>`, font\: :ref:`Font<class_Font>`\ ) :ref:`🔗<class_Window_method_add_theme_font_override>`
Создает локальное переопределение для темы :ref:`Font<class_Font>` с указанным ``name``. Локальные переопределения всегда имеют приоритет при извлечении элементов темы для элемента управления. Переопределение можно удалить с помощью :ref:`remove_theme_font_override()<class_Window_method_remove_theme_font_override>`.
См. также :ref:`get_theme_font()<class_Window_method_get_theme_font>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_add_theme_font_size_override:
.. rst-class:: classref-method
|void| **add_theme_font_size_override**\ (\ name\: :ref:`StringName<class_StringName>`, font_size\: :ref:`int<class_int>`\ ) :ref:`🔗<class_Window_method_add_theme_font_size_override>`
Создает локальное переопределение для размера шрифта темы с указанным ``name``. Локальные переопределения всегда имеют приоритет при извлечении элементов темы для элемента управления. Переопределение можно удалить с помощью :ref:`remove_theme_font_size_override()<class_Window_method_remove_theme_font_size_override>`.
См. также :ref:`get_theme_font_size()<class_Window_method_get_theme_font_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_add_theme_icon_override:
.. rst-class:: classref-method
|void| **add_theme_icon_override**\ (\ name\: :ref:`StringName<class_StringName>`, texture\: :ref:`Texture2D<class_Texture2D>`\ ) :ref:`🔗<class_Window_method_add_theme_icon_override>`
Создает локальное переопределение для значка темы с указанным ``name``. Локальные переопределения всегда имеют приоритет при извлечении элементов темы для элемента управления. Переопределение можно удалить с помощью :ref:`remove_theme_icon_override()<class_Window_method_remove_theme_icon_override>`.
См. также :ref:`get_theme_icon()<class_Window_method_get_theme_icon>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_add_theme_stylebox_override:
.. rst-class:: classref-method
|void| **add_theme_stylebox_override**\ (\ name\: :ref:`StringName<class_StringName>`, stylebox\: :ref:`StyleBox<class_StyleBox>`\ ) :ref:`🔗<class_Window_method_add_theme_stylebox_override>`
Создает локальное переопределение для темы :ref:`StyleBox<class_StyleBox>` с указанным ``name``. Локальные переопределения всегда имеют приоритет при извлечении элементов темы для элемента управления. Переопределение можно удалить с помощью :ref:`remove_theme_stylebox_override()<class_Window_method_remove_theme_stylebox_override>`.
См. также :ref:`get_theme_stylebox()<class_Window_method_get_theme_stylebox>` и :ref:`Control.add_theme_stylebox_override()<class_Control_method_add_theme_stylebox_override>` для получения дополнительных сведений.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_begin_bulk_theme_override:
.. rst-class:: classref-method
|void| **begin_bulk_theme_override**\ (\ ) :ref:`🔗<class_Window_method_begin_bulk_theme_override>`
Запрещает методам ``*_theme_*_override`` выдавать :ref:`NOTIFICATION_THEME_CHANGED<class_Window_constant_NOTIFICATION_THEME_CHANGED>` до тех пор, пока не будет вызван :ref:`end_bulk_theme_override()<class_Window_method_end_bulk_theme_override>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_can_draw:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **can_draw**\ (\ ) |const| :ref:`🔗<class_Window_method_can_draw>`
Возвращает, отображается ли окно на экране.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_child_controls_changed:
.. rst-class:: classref-method
|void| **child_controls_changed**\ (\ ) :ref:`🔗<class_Window_method_child_controls_changed>`
Запрашивает обновление размера **Window** для соответствия базовым узлам :ref:`Control<class_Control>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_end_bulk_theme_override:
.. rst-class:: classref-method
|void| **end_bulk_theme_override**\ (\ ) :ref:`🔗<class_Window_method_end_bulk_theme_override>`
Завершает массовое обновление переопределения темы. См. :ref:`begin_bulk_theme_override()<class_Window_method_begin_bulk_theme_override>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_contents_minimum_size:
.. rst-class:: classref-method
:ref:`Vector2<class_Vector2>` **get_contents_minimum_size**\ (\ ) |const| :ref:`🔗<class_Window_method_get_contents_minimum_size>`
Возвращает объединенный минимальный размер из дочерних узлов :ref:`Control<class_Control>` окна. Используйте :ref:`child_controls_changed()<class_Window_method_child_controls_changed>`, чтобы обновить его при изменении дочерних узлов.
Значение, возвращаемое этим методом, можно переопределить с помощью :ref:`_get_contents_minimum_size()<class_Window_private_method__get_contents_minimum_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_flag:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **get_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`\ ) |const| :ref:`🔗<class_Window_method_get_flag>`
Возвращает ``true``, если установлен ``flag``.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_focused_window:
.. rst-class:: classref-method
:ref:`Window<class_Window>` **get_focused_window**\ (\ ) |static| :ref:`🔗<class_Window_method_get_focused_window>`
Возвращает фокусированное окно.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_layout_direction:
.. rst-class:: classref-method
:ref:`LayoutDirection<enum_Window_LayoutDirection>` **get_layout_direction**\ (\ ) |const| :ref:`🔗<class_Window_method_get_layout_direction>`
Возвращает направление макета и направление написания текста.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_position_with_decorations:
.. rst-class:: classref-method
:ref:`Vector2i<class_Vector2i>` **get_position_with_decorations**\ (\ ) |const| :ref:`🔗<class_Window_method_get_position_with_decorations>`
Возвращает позицию окна, включая его границу.
\ **Примечание:** Если :ref:`visible<class_Window_property_visible>` равно ``false``, этот метод возвращает то же значение, что и :ref:`position<class_Window_property_position>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_size_with_decorations:
.. rst-class:: classref-method
:ref:`Vector2i<class_Vector2i>` **get_size_with_decorations**\ (\ ) |const| :ref:`🔗<class_Window_method_get_size_with_decorations>`
Возвращает размер окна, включая его границу.
\ **Примечание:** Если :ref:`visible<class_Window_property_visible>` равно ``false``, этот метод возвращает то же значение, что и :ref:`size<class_Window_property_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_color:
.. rst-class:: classref-method
:ref:`Color<class_Color>` **get_theme_color**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_get_theme_color>`
Возвращает :ref:`Color<class_Color>` из первой соответствующей :ref:`Theme<class_Theme>` в дереве, если эта :ref:`Theme<class_Theme>` имеет элемент цвета с указанными ``name`` и ``theme_type``.
Подробнее см. :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_constant:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_theme_constant**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_get_theme_constant>`
Возвращает константу из первой совпадающей :ref:`Theme<class_Theme>` в дереве, если эта :ref:`Theme<class_Theme>` имеет константный элемент с указанными ``name`` и ``theme_type``.
Подробнее см. :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_default_base_scale:
.. rst-class:: classref-method
:ref:`float<class_float>` **get_theme_default_base_scale**\ (\ ) |const| :ref:`🔗<class_Window_method_get_theme_default_base_scale>`
Возвращает базовое значение масштаба по умолчанию из первой соответствующей :ref:`Theme<class_Theme>` в дереве, если эта :ref:`Theme<class_Theme>` имеет допустимое значение :ref:`Theme.default_base_scale<class_Theme_property_default_base_scale>`.
Подробнее см. в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_default_font:
.. rst-class:: classref-method
:ref:`Font<class_Font>` **get_theme_default_font**\ (\ ) |const| :ref:`🔗<class_Window_method_get_theme_default_font>`
Возвращает значение по умолчанию для font из первого подходящего :ref:`Theme<class_Theme>` в дереве, если :ref:`Theme<class_Theme>` имеет допустимое значение :ref:`Theme.default<class_Theme_property_default>`.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_default_font_size:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_theme_default_font_size**\ (\ ) |const| :ref:`🔗<class_Window_method_get_theme_default_font_size>`
Возвращает значение по умолчанию для font size из первого подходящего :ref:`Theme<class_Theme>` в дереве, если :ref:`Theme<class_Theme>` имеет допустимое значение :ref:`Theme.default_font_size<class_Theme_property_default_font_size>`.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_font:
.. rst-class:: classref-method
:ref:`Font<class_Font>` **get_theme_font**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_get_theme_font>`
Возвращает :ref:`Font<class_Font>` из первого подходящего :ref:`Theme<class_Theme>` в дереве, если в :ref:`Theme<class_Theme>` есть элемент font с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_font_size:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_theme_font_size**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_get_theme_font_size>`
Возвращает font size из первого подходящего :ref:`Theme<class_Theme>` в дереве, если в :ref:`Theme<class_Theme>` есть элемент font size с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_icon:
.. rst-class:: classref-method
:ref:`Texture2D<class_Texture2D>` **get_theme_icon**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_get_theme_icon>`
Возвращает icon из первого подходящего :ref:`Theme<class_Theme>` в дереве, если в :ref:`Theme<class_Theme>` есть элемент icon с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_theme_stylebox:
.. rst-class:: classref-method
:ref:`StyleBox<class_StyleBox>` **get_theme_stylebox**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_get_theme_stylebox>`
Возвращает :ref:`StyleBox<class_StyleBox>` из первого подходящего :ref:`Theme<class_Theme>` в дереве, если в :ref:`Theme<class_Theme>` есть элемент stylebox с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_get_window_id:
.. rst-class:: classref-method
:ref:`int<class_int>` **get_window_id**\ (\ ) |const| :ref:`🔗<class_Window_method_get_window_id>`
Возвращает ID окна.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_grab_focus:
.. rst-class:: classref-method
|void| **grab_focus**\ (\ ) :ref:`🔗<class_Window_method_grab_focus>`
Заставляет окно захватывать фокус, позволяя ему получать пользовательский ввод.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_focus:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_focus**\ (\ ) |const| :ref:`🔗<class_Window_method_has_focus>`
Возвращает ``true``, если окно находится в фокусе.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_color:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_color**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_has_theme_color>`
Возвращает ``true``, если в дереве есть соответствующий :ref:`Theme<class_Theme>`, в котором есть элемент color с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_color_override:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_color_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_Window_method_has_theme_color_override>`
Возвращает ``true``, если есть локальное переопределение для темы :ref:`Color<class_Color>` с указанным ``name`` в этом узле :ref:`Control<class_Control>`.
См. :ref:`add_theme_color_override()<class_Window_method_add_theme_color_override>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_constant:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_constant**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_has_theme_constant>`
Возвращает ``true``, если в дереве есть соответствующий :ref:`Theme<class_Theme>`, в котором есть элемент constant с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_constant_override:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_constant_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_Window_method_has_theme_constant_override>`
Возвращает ``true``, если есть локальное переопределение для константы темы с указанным ``name`` в этом узле :ref:`Control<class_Control>`.
См. :ref:`add_theme_constant_override()<class_Window_method_add_theme_constant_override>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_font:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_font**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_has_theme_font>`
Возвращает ``true``, если в дереве есть соответствующий :ref:`Theme<class_Theme>`, в котором есть элемент font с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_font_override:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_font_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_Window_method_has_theme_font_override>`
Возвращает ``true``, если есть локальное переопределение для темы :ref:`Font<class_Font>` с указанным ``name`` в этом узле :ref:`Control<class_Control>`.
См. :ref:`add_theme_font_override()<class_Window_method_add_theme_font_override>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_font_size:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_font_size**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_has_theme_font_size>`
Возвращает ``true``, если в дереве есть соответствующий :ref:`Theme<class_Theme>`, в котором есть элемент font size с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_font_size_override:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_font_size_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_Window_method_has_theme_font_size_override>`
Возвращает ``true``, если есть локальное переопределение для размера шрифта темы с указанным ``name`` в этом узле :ref:`Control<class_Control>`.
См. :ref:`add_theme_font_size_override()<class_Window_method_add_theme_font_size_override>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_icon:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_icon**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_has_theme_icon>`
Возвращает ``true``, если в дереве есть соответствующий :ref:`Theme<class_Theme>`, в котором есть элемент icon с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_icon_override:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_icon_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_Window_method_has_theme_icon_override>`
Возвращает ``true``, если есть локальное переопределение для значка темы с указанным ``name`` в этом узле :ref:`Control<class_Control>`.
См. :ref:`add_theme_icon_override()<class_Window_method_add_theme_icon_override>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_stylebox:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_stylebox**\ (\ name\: :ref:`StringName<class_StringName>`, theme_type\: :ref:`StringName<class_StringName>` = &""\ ) |const| :ref:`🔗<class_Window_method_has_theme_stylebox>`
Возвращает ``true``, если в дереве есть соответствующий :ref:`Theme<class_Theme>`, в котором есть элемент stylebox с указанными ``name`` и ``theme_type``.
Подробности смотрите в :ref:`Control.get_theme_color()<class_Control_method_get_theme_color>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_has_theme_stylebox_override:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **has_theme_stylebox_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) |const| :ref:`🔗<class_Window_method_has_theme_stylebox_override>`
Возвращает ``true``, если есть локальное переопределение для темы :ref:`StyleBox<class_StyleBox>` с указанным ``name`` в этом узле :ref:`Control<class_Control>`.
См. :ref:`add_theme_stylebox_override()<class_Window_method_add_theme_stylebox_override>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_hide:
.. rst-class:: classref-method
|void| **hide**\ (\ ) :ref:`🔗<class_Window_method_hide>`
Скрывает окно. Это не то же самое, что свернутое состояние. Со скрытым окном нельзя взаимодействовать, и его нужно сделать видимым с помощью :ref:`show()<class_Window_method_show>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_is_embedded:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_embedded**\ (\ ) |const| :ref:`🔗<class_Window_method_is_embedded>`
Возвращает ``true``, если окно в данный момент встроено в другое окно.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_is_layout_rtl:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_layout_rtl**\ (\ ) |const| :ref:`🔗<class_Window_method_is_layout_rtl>`
Возвращает ``true``, если макет расположения справа налево.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_is_maximize_allowed:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_maximize_allowed**\ (\ ) |const| :ref:`🔗<class_Window_method_is_maximize_allowed>`
Возвращает ``true``, если окно можно развернуть (кнопка развернуть включена).
.. rst-class:: classref-item-separator
----
.. _class_Window_method_is_using_font_oversampling:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_using_font_oversampling**\ (\ ) |const| :ref:`🔗<class_Window_method_is_using_font_oversampling>`
Возвращает ``true``, если включена передискретизация шрифта. См. :ref:`set_use_font_oversampling()<class_Window_method_set_use_font_oversampling>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_move_to_center:
.. rst-class:: classref-method
|void| **move_to_center**\ (\ ) :ref:`🔗<class_Window_method_move_to_center>`
Centers the window in the current screen. If the window is embedded, it is centered in the embedder :ref:`Viewport<class_Viewport>` instead.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_move_to_foreground:
.. rst-class:: classref-method
|void| **move_to_foreground**\ (\ ) :ref:`🔗<class_Window_method_move_to_foreground>`
**Устарело:** Use :ref:`grab_focus()<class_Window_method_grab_focus>` instead.
Заставляет окно захватывать фокус, позволяя ему получать пользовательский ввод.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup:
.. rst-class:: classref-method
|void| **popup**\ (\ rect\: :ref:`Rect2i<class_Rect2i>` = Rect2i(0, 0, 0, 0)\ ) :ref:`🔗<class_Window_method_popup>`
Показывает **Window** и делает его переходным (см. :ref:`transient<class_Window_property_transient>`). Если указан ``rect``, он будет установлен как размер **Window**. Не удается, если вызывается в главном окне.
Если :ref:`ProjectSettings.display/window/subwindows/embed_subwindows<class_ProjectSettings_property_display/window/subwindows/embed_subwindows>` равен ``true`` (режим одного окна), координаты ``rect`` являются глобальными и относятся к верхнему левому углу главного окна (исключая оформление окна). Если координаты позиции ``rect`` отрицательные, окно будет расположено за пределами главного окна и в результате может быть невидимым.
Если :ref:`ProjectSettings.display/window/subwindows/embed_subwindows<class_ProjectSettings_property_display/window/subwindows/embed_subwindows>` равен ``false`` (режим нескольких окон), координаты ``rect`` являются глобальными и относятся к верхнему левому углу самого левого экрана. Если координаты позиции ``rect`` отрицательные, окно будет размещено в верхнем левом углу экрана.
\ **Примечание:** ``rect`` должен быть в глобальных координатах, если указан.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_centered:
.. rst-class:: classref-method
|void| **popup_centered**\ (\ minsize\: :ref:`Vector2i<class_Vector2i>` = Vector2i(0, 0)\ ) :ref:`🔗<class_Window_method_popup_centered>`
Всплывает **Window** в центре текущего экрана с опционально заданным минимальным размером. Если **Window** встроено, оно будет центрировано в родительском :ref:`Viewport<class_Viewport>`.
\ **Примечание:** Вызов его со значением по умолчанию ``minsize`` эквивалентен вызову его с :ref:`size<class_Window_property_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_centered_clamped:
.. rst-class:: classref-method
|void| **popup_centered_clamped**\ (\ minsize\: :ref:`Vector2i<class_Vector2i>` = Vector2i(0, 0), fallback_ratio\: :ref:`float<class_float>` = 0.75\ ) :ref:`🔗<class_Window_method_popup_centered_clamped>`
Всплывает **Window**, центрированное внутри его родительского **Window**. ``fallback_ratio`` определяет максимальный размер **Window** по отношению к его родительскому элементу.
\ **Примечание:** Вызов его со значением по умолчанию ``minsize`` эквивалентен вызову его с :ref:`size<class_Window_property_size>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_centered_ratio:
.. rst-class:: classref-method
|void| **popup_centered_ratio**\ (\ ratio\: :ref:`float<class_float>` = 0.8\ ) :ref:`🔗<class_Window_method_popup_centered_ratio>`
Если **Window** встроено, всплывает **Window** по центру внутри своего встраиваемого устройства и устанавливает его размер как ``ratio`` размера встраиваемого устройства.
Если **Window** является собственным окном, всплывает **Window** по центру внутри экрана его родительского **Window** и устанавливает его размер как ``ratio`` размера экрана.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_exclusive:
.. rst-class:: classref-method
|void| **popup_exclusive**\ (\ from_node\: :ref:`Node<class_Node>`, rect\: :ref:`Rect2i<class_Rect2i>` = Rect2i(0, 0, 0, 0)\ ) :ref:`🔗<class_Window_method_popup_exclusive>`
Пытается сделать этот диалог родительским для последнего эксклюзивного окна относительно ``from_node``, а затем вызывает :ref:`popup()<class_Window_method_popup>` для него. Диалог не должен иметь текущего родителя, в противном случае метод не выполняется.
См. также :ref:`set_unparent_when_invisible()<class_Window_method_set_unparent_when_invisible>` и :ref:`Node.get_last_exclusive_window()<class_Node_method_get_last_exclusive_window>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_exclusive_centered:
.. rst-class:: classref-method
|void| **popup_exclusive_centered**\ (\ from_node\: :ref:`Node<class_Node>`, minsize\: :ref:`Vector2i<class_Vector2i>` = Vector2i(0, 0)\ ) :ref:`🔗<class_Window_method_popup_exclusive_centered>`
Пытается сделать этот диалог родительским для последнего эксклюзивного окна относительно ``from_node``, а затем вызывает :ref:`popup_centered()<class_Window_method_popup_centered>` для него. Диалог не должен иметь текущего родителя, в противном случае метод не выполняется.
См. также :ref:`set_unparent_when_invisible()<class_Window_method_set_unparent_when_invisible>` и :ref:`Node.get_last_exclusive_window()<class_Node_method_get_last_exclusive_window>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_exclusive_centered_clamped:
.. rst-class:: classref-method
|void| **popup_exclusive_centered_clamped**\ (\ from_node\: :ref:`Node<class_Node>`, minsize\: :ref:`Vector2i<class_Vector2i>` = Vector2i(0, 0), fallback_ratio\: :ref:`float<class_float>` = 0.75\ ) :ref:`🔗<class_Window_method_popup_exclusive_centered_clamped>`
Пытается сделать этот диалог родительским для последнего эксклюзивного окна относительно ``from_node``, а затем вызывает :ref:`popup_centered_clamped()<class_Window_method_popup_centered_clamped>` для него. Диалог не должен иметь текущего родителя, в противном случае метод не выполняется.
См. также :ref:`set_unparent_when_invisible()<class_Window_method_set_unparent_when_invisible>` и :ref:`Node.get_last_exclusive_window()<class_Node_method_get_last_exclusive_window>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_exclusive_centered_ratio:
.. rst-class:: classref-method
|void| **popup_exclusive_centered_ratio**\ (\ from_node\: :ref:`Node<class_Node>`, ratio\: :ref:`float<class_float>` = 0.8\ ) :ref:`🔗<class_Window_method_popup_exclusive_centered_ratio>`
Пытается сделать этот диалог родительским для последнего эксклюзивного окна относительно ``from_node``, а затем вызывает :ref:`popup_centered_ratio()<class_Window_method_popup_centered_ratio>` для него. Диалог не должен иметь текущего родителя, в противном случае метод не выполняется.
См. также :ref:`set_unparent_when_invisible()<class_Window_method_set_unparent_when_invisible>` и :ref:`Node.get_last_exclusive_window()<class_Node_method_get_last_exclusive_window>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_exclusive_on_parent:
.. rst-class:: classref-method
|void| **popup_exclusive_on_parent**\ (\ from_node\: :ref:`Node<class_Node>`, parent_rect\: :ref:`Rect2i<class_Rect2i>`\ ) :ref:`🔗<class_Window_method_popup_exclusive_on_parent>`
Пытается сделать этот диалог родительским для последнего эксклюзивного окна относительно ``from_node``, а затем вызывает :ref:`popup_on_parent()<class_Window_method_popup_on_parent>` для него. Диалог не должен иметь текущего родителя, в противном случае метод не выполняется.
См. также :ref:`set_unparent_when_invisible()<class_Window_method_set_unparent_when_invisible>` и :ref:`Node.get_last_exclusive_window()<class_Node_method_get_last_exclusive_window>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_popup_on_parent:
.. rst-class:: classref-method
|void| **popup_on_parent**\ (\ parent_rect\: :ref:`Rect2i<class_Rect2i>`\ ) :ref:`🔗<class_Window_method_popup_on_parent>`
Всплывает **Window** с позицией, смещенной на позицию родительского **Window**. Если **Window** встроено, имеет тот же эффект, что и :ref:`popup()<class_Window_method_popup>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_remove_theme_color_override:
.. rst-class:: classref-method
|void| **remove_theme_color_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Window_method_remove_theme_color_override>`
Удаляет локальное переопределение для темы :ref:`Color<class_Color>` с указанным ``name``, ранее добавленное с помощью :ref:`add_theme_color_override()<class_Window_method_add_theme_color_override>` или через панель инспектора.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_remove_theme_constant_override:
.. rst-class:: classref-method
|void| **remove_theme_constant_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Window_method_remove_theme_constant_override>`
Удаляет локальное переопределение для константы темы с указанным ``name``, ранее добавленное :ref:`add_theme_constant_override()<class_Window_method_add_theme_constant_override>` или через панель инспектора.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_remove_theme_font_override:
.. rst-class:: classref-method
|void| **remove_theme_font_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Window_method_remove_theme_font_override>`
Удаляет локальное переопределение для темы :ref:`Font<class_Font>` с указанным ``name``, ранее добавленное :ref:`add_theme_font_override()<class_Window_method_add_theme_font_override>` или через панель инспектора.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_remove_theme_font_size_override:
.. rst-class:: classref-method
|void| **remove_theme_font_size_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Window_method_remove_theme_font_size_override>`
Удаляет локальное переопределение размера шрифта темы с указанным ``name``, ранее добавленное :ref:`add_theme_font_size_override()<class_Window_method_add_theme_font_size_override>` или через панель инспектора.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_remove_theme_icon_override:
.. rst-class:: classref-method
|void| **remove_theme_icon_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Window_method_remove_theme_icon_override>`
Удаляет локальное переопределение для значка темы с указанным ``name``, ранее добавленное :ref:`add_theme_icon_override()<class_Window_method_add_theme_icon_override>` или через панель инспектора.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_remove_theme_stylebox_override:
.. rst-class:: classref-method
|void| **remove_theme_stylebox_override**\ (\ name\: :ref:`StringName<class_StringName>`\ ) :ref:`🔗<class_Window_method_remove_theme_stylebox_override>`
Удаляет локальное переопределение для темы :ref:`StyleBox<class_StyleBox>` с указанным ``name``, ранее добавленное :ref:`add_theme_stylebox_override()<class_Window_method_add_theme_stylebox_override>` или через панель инспектора.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_request_attention:
.. rst-class:: classref-method
|void| **request_attention**\ (\ ) :ref:`🔗<class_Window_method_request_attention>`
Сообщает ОС, что **Window** требует внимания. Это выделяет окно каким-либо образом в зависимости от системы, например, оно может мигать на панели задач.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_reset_size:
.. rst-class:: classref-method
|void| **reset_size**\ (\ ) :ref:`🔗<class_Window_method_reset_size>`
Сбрасывает размер до минимального размера, который является максимальным из :ref:`min_size<class_Window_property_min_size>` и (если включен :ref:`wrap_controls<class_Window_property_wrap_controls>`) :ref:`get_contents_minimum_size()<class_Window_method_get_contents_minimum_size>`. Это эквивалентно вызову ``set_size(Vector2i())`` (или любого размера ниже минимального).
.. rst-class:: classref-item-separator
----
.. _class_Window_method_set_flag:
.. rst-class:: classref-method
|void| **set_flag**\ (\ flag\: :ref:`Flags<enum_Window_Flags>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_Window_method_set_flag>`
Устанавливает указанный флаг окна.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_set_ime_active:
.. rst-class:: classref-method
|void| **set_ime_active**\ (\ active\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_Window_method_set_ime_active>`
Если ``active`` равен ``true``, включается собственный системный IME (редактор метода ввода).
.. rst-class:: classref-item-separator
----
.. _class_Window_method_set_ime_position:
.. rst-class:: classref-method
|void| **set_ime_position**\ (\ position\: :ref:`Vector2i<class_Vector2i>`\ ) :ref:`🔗<class_Window_method_set_ime_position>`
Перемещает IME в указанную позицию.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_set_layout_direction:
.. rst-class:: classref-method
|void| **set_layout_direction**\ (\ direction\: :ref:`LayoutDirection<enum_Window_LayoutDirection>`\ ) :ref:`🔗<class_Window_method_set_layout_direction>`
Устанавливает направление макета и направление написания текста. Для некоторых языков (например, арабского и иврита) необходимы макеты справа налево.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_set_unparent_when_invisible:
.. rst-class:: classref-method
|void| **set_unparent_when_invisible**\ (\ unparent\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_Window_method_set_unparent_when_invisible>`
Если ``unparent`` равен ``true``, окно автоматически теряет родительский статус при переходе в невидимое состояние.
\ **Примечание:** Обязательно сохраните ссылку на узел, иначе он станет осиротевшим. Вам также нужно вручную вызвать :ref:`Node.queue_free()<class_Node_method_queue_free>`, чтобы освободить окно, если оно не является родительским.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_set_use_font_oversampling:
.. rst-class:: classref-method
|void| **set_use_font_oversampling**\ (\ enable\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_Window_method_set_use_font_oversampling>`
Включает избыточную выборку шрифтов. Это позволяет шрифтам выглядеть лучше при увеличении масштаба.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_show:
.. rst-class:: classref-method
|void| **show**\ (\ ) :ref:`🔗<class_Window_method_show>`
Заставляет **Window** появиться. Это позволяет взаимодействовать с **Window** и не изменяет никаких его свойств, кроме видимости (в отличие, например, от :ref:`popup()<class_Window_method_popup>`).
.. rst-class:: classref-item-separator
----
.. _class_Window_method_start_drag:
.. rst-class:: classref-method
|void| **start_drag**\ (\ ) :ref:`🔗<class_Window_method_start_drag>`
Запускает интерактивную операцию перетаскивания в окне, используя текущую позицию мыши. Вызывайте этот метод при обработке нажатия кнопки мыши для имитации события нажатия в заголовке окна. Использование этого метода позволяет окну участвовать в переключении пространства, мозаичном размещении и других системных функциях.
.. rst-class:: classref-item-separator
----
.. _class_Window_method_start_resize:
.. rst-class:: classref-method
|void| **start_resize**\ (\ edge\: :ref:`WindowResizeEdge<enum_DisplayServer_WindowResizeEdge>`\ ) :ref:`🔗<class_Window_method_start_resize>`
Запускает интерактивную операцию изменения размера окна, используя текущую позицию мыши. Вызывайте этот метод при обработке нажатия кнопки мыши для имитации события нажатия на краю окна.
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
Описания свойств темы
------------------------------------------
.. _class_Window_theme_color_title_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **title_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_Window_theme_color_title_color>`
Цвет текста заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_color_title_outline_modulate:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **title_outline_modulate** = ``Color(0, 0, 0, 1)`` :ref:`🔗<class_Window_theme_color_title_outline_modulate>`
Цвет контура текста заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_constant_close_h_offset:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **close_h_offset** = ``18`` :ref:`🔗<class_Window_theme_constant_close_h_offset>`
Горизонтальное смещение положения кнопки закрытия относительно конца строки заголовка в сторону начала строки заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_constant_close_v_offset:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **close_v_offset** = ``24`` :ref:`🔗<class_Window_theme_constant_close_v_offset>`
Смещение вертикального положения кнопки закрытия относительно нижней части строки заголовка по направлению к верхней части строки заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_constant_resize_margin:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **resize_margin** = ``4`` :ref:`🔗<class_Window_theme_constant_resize_margin>`
Определяет внешнее поле, за которое можно захватить границу окна мышью и изменить ее размер.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_constant_title_height:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **title_height** = ``36`` :ref:`🔗<class_Window_theme_constant_title_height>`
Высота строки заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_constant_title_outline_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **title_outline_size** = ``0`` :ref:`🔗<class_Window_theme_constant_title_outline_size>`
Размер контура заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_font_title_font:
.. rst-class:: classref-themeproperty
:ref:`Font<class_Font>` **title_font** :ref:`🔗<class_Window_theme_font_title_font>`
Шрифт, используемый для заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_font_size_title_font_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **title_font_size** :ref:`🔗<class_Window_theme_font_size_title_font_size>`
Размер шрифта заголовка.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_icon_close:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **close** :ref:`🔗<class_Window_theme_icon_close>`
Значок кнопки закрытия.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_icon_close_pressed:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **close_pressed** :ref:`🔗<class_Window_theme_icon_close_pressed>`
Значок кнопки закрытия при нажатии.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_style_embedded_border:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **embedded_border** :ref:`🔗<class_Window_theme_style_embedded_border>`
Стиль фона, используемый при внедрении **Window**. Обратите внимание, что он рисуется только под содержимым окна, за исключением заголовка. Для правильных границ и стиля заголовка можно использовать свойства ``expand_margin_*`` :ref:`StyleBoxFlat<class_StyleBoxFlat>`.
\ **Примечание:** Фон содержимого не будет виден, если не включен параметр :ref:`transparent<class_Window_property_transparent>`.
.. rst-class:: classref-item-separator
----
.. _class_Window_theme_style_embedded_unfocused_border:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **embedded_unfocused_border** :ref:`🔗<class_Window_theme_style_embedded_unfocused_border>`
Стиль фона, используемый, когда **Window** встроено и не сфокусировано.
.. |virtual| replace:: :abbr:`virtual (Этот метод обычно должен быть переопределен пользователем, чтобы иметь какой-либо эффект.)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (Этот метод не имеет побочных эффектов. Он не изменяет ни одну из переменных-членов экземпляра.)`
.. |vararg| replace:: :abbr:`vararg (Этот метод принимает любое количество аргументов после описанных здесь.)`
.. |constructor| replace:: :abbr:`constructor (Этот метод используется для создания типа.)`
.. |static| replace:: :abbr:`static (Этот метод не нуждается в вызове экземпляра, поэтому его можно вызвать напрямую, используя имя класса.)`
.. |operator| replace:: :abbr:`operator (Этот метод описывает допустимый оператор для использования с этим типом в качестве левого операнда.)`
.. |bitfield| replace:: :abbr:`BitField (Это значение является целым числом, составленным как битовая маска следующих флагов.)`
.. |void| replace:: :abbr:`void (Нет возвращаемого значения.)`