Files
godot-docs-l10n/classes/zh_Hans/class_foldablecontainer.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

594 lines
28 KiB
ReStructuredText

:github_url: hide
.. meta::
:keywords: expandable, collapsible, collapse, accordion, details
.. _class_FoldableContainer:
FoldableContainer
=================
**继承:** :ref:`Container<class_Container>` **<** :ref:`Control<class_Control>` **<** :ref:`CanvasItem<class_CanvasItem>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
能够展开、折叠的容器。
.. rst-class:: classref-introduction-group
描述
----
A container that can be expanded/collapsed, with a title that can be filled with controls, such as buttons. This is also called an accordion.
The title can be positioned at the top or bottom of the container. The container can be expanded or collapsed by clicking the title or by pressing ``ui_accept`` when focused. Child control nodes are hidden when the container is collapsed. Ignores non-control children.
A FoldableContainer can be grouped with other FoldableContainers so that only one of them can be opened at a time; see :ref:`foldable_group<class_FoldableContainer_property_foldable_group>` and :ref:`FoldableGroup<class_FoldableGroup>`.
.. rst-class:: classref-reftable-group
属性
----
.. table::
:widths: auto
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`FocusMode<enum_Control_FocusMode>` | focus_mode | ``2`` (overrides :ref:`Control<class_Control_property_focus_mode>`) |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`FoldableGroup<class_FoldableGroup>` | :ref:`foldable_group<class_FoldableContainer_property_foldable_group>` | |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`folded<class_FoldableContainer_property_folded>` | ``false`` |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`language<class_FoldableContainer_property_language>` | ``""`` |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`MouseFilter<enum_Control_MouseFilter>` | mouse_filter | ``0`` (overrides :ref:`Control<class_Control_property_mouse_filter>`) |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`title<class_FoldableContainer_property_title>` | ``""`` |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` | :ref:`title_alignment<class_FoldableContainer_property_title_alignment>` | ``0`` |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`TitlePosition<enum_FoldableContainer_TitlePosition>` | :ref:`title_position<class_FoldableContainer_property_title_position>` | ``0`` |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`TextDirection<enum_Control_TextDirection>` | :ref:`title_text_direction<class_FoldableContainer_property_title_text_direction>` | ``0`` |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
| :ref:`OverrunBehavior<enum_TextServer_OverrunBehavior>` | :ref:`title_text_overrun_behavior<class_FoldableContainer_property_title_text_overrun_behavior>` | ``0`` |
+-------------------------------------------------------------------+--------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
方法
----
.. table::
:widths: auto
+--------+-----------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`add_title_bar_control<class_FoldableContainer_method_add_title_bar_control>`\ (\ control\: :ref:`Control<class_Control>`\ ) |
+--------+-----------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`expand<class_FoldableContainer_method_expand>`\ (\ ) |
+--------+-----------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`fold<class_FoldableContainer_method_fold>`\ (\ ) |
+--------+-----------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`remove_title_bar_control<class_FoldableContainer_method_remove_title_bar_control>`\ (\ control\: :ref:`Control<class_Control>`\ ) |
+--------+-----------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
主题属性
--------
.. table::
:widths: auto
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`collapsed_font_color<class_FoldableContainer_theme_color_collapsed_font_color>` | ``Color(1, 1, 1, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_color<class_FoldableContainer_theme_color_font_color>` | ``Color(0.875, 0.875, 0.875, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`font_outline_color<class_FoldableContainer_theme_color_font_outline_color>` | ``Color(1, 1, 1, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Color<class_Color>` | :ref:`hover_font_color<class_FoldableContainer_theme_color_hover_font_color>` | ``Color(0.95, 0.95, 0.95, 1)`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`h_separation<class_FoldableContainer_theme_constant_h_separation>` | ``2`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`outline_size<class_FoldableContainer_theme_constant_outline_size>` | ``0`` |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Font<class_Font>` | :ref:`font<class_FoldableContainer_theme_font_font>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`int<class_int>` | :ref:`font_size<class_FoldableContainer_theme_font_size_font_size>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`expanded_arrow<class_FoldableContainer_theme_icon_expanded_arrow>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`expanded_arrow_mirrored<class_FoldableContainer_theme_icon_expanded_arrow_mirrored>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`folded_arrow<class_FoldableContainer_theme_icon_folded_arrow>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`Texture2D<class_Texture2D>` | :ref:`folded_arrow_mirrored<class_FoldableContainer_theme_icon_folded_arrow_mirrored>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`focus<class_FoldableContainer_theme_style_focus>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`panel<class_FoldableContainer_theme_style_panel>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`title_collapsed_hover_panel<class_FoldableContainer_theme_style_title_collapsed_hover_panel>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`title_collapsed_panel<class_FoldableContainer_theme_style_title_collapsed_panel>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`title_hover_panel<class_FoldableContainer_theme_style_title_hover_panel>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
| :ref:`StyleBox<class_StyleBox>` | :ref:`title_panel<class_FoldableContainer_theme_style_title_panel>` | |
+-----------------------------------+-----------------------------------------------------------------------------------------------------+-----------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
信号
----
.. _class_FoldableContainer_signal_folding_changed:
.. rst-class:: classref-signal
**folding_changed**\ (\ is_folded\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_FoldableContainer_signal_folding_changed>`
容器折叠/展开时发出。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
枚举
----
.. _enum_FoldableContainer_TitlePosition:
.. rst-class:: classref-enumeration
enum **TitlePosition**: :ref:`🔗<enum_FoldableContainer_TitlePosition>`
.. _class_FoldableContainer_constant_POSITION_TOP:
.. rst-class:: classref-enumeration-constant
:ref:`TitlePosition<enum_FoldableContainer_TitlePosition>` **POSITION_TOP** = ``0``
标题出现在容器顶部。
.. _class_FoldableContainer_constant_POSITION_BOTTOM:
.. rst-class:: classref-enumeration-constant
:ref:`TitlePosition<enum_FoldableContainer_TitlePosition>` **POSITION_BOTTOM** = ``1``
标题出现在容器底部。同时会让所有 StyleBox 垂直翻转。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
属性说明
--------
.. _class_FoldableContainer_property_foldable_group:
.. rst-class:: classref-property
:ref:`FoldableGroup<class_FoldableGroup>` **foldable_group** :ref:`🔗<class_FoldableContainer_property_foldable_group>`
.. rst-class:: classref-property-setget
- |void| **set_foldable_group**\ (\ value\: :ref:`FoldableGroup<class_FoldableGroup>`\ )
- :ref:`FoldableGroup<class_FoldableGroup>` **get_foldable_group**\ (\ )
与容器关联的 :ref:`FoldableGroup<class_FoldableGroup>`\ 。多个 **FoldableContainer** 节点具有相同的分组时,只允许有一个处于展开状态。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_property_folded:
.. rst-class:: classref-property
:ref:`bool<class_bool>` **folded** = ``false`` :ref:`🔗<class_FoldableContainer_property_folded>`
.. rst-class:: classref-property-setget
- |void| **set_folded**\ (\ value\: :ref:`bool<class_bool>`\ )
- :ref:`bool<class_bool>` **is_folded**\ (\ )
如果为 ``true``\ ,则会折叠容器折叠,隐藏所有子节点。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_property_language:
.. rst-class:: classref-property
:ref:`String<class_String>` **language** = ``""`` :ref:`🔗<class_FoldableContainer_property_language>`
.. rst-class:: classref-property-setget
- |void| **set_language**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_language**\ (\ )
Language code used for text shaping algorithms. If left empty, the current locale is used instead.
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_property_title:
.. rst-class:: classref-property
:ref:`String<class_String>` **title** = ``""`` :ref:`🔗<class_FoldableContainer_property_title>`
.. rst-class:: classref-property-setget
- |void| **set_title**\ (\ value\: :ref:`String<class_String>`\ )
- :ref:`String<class_String>` **get_title**\ (\ )
容器的标题文本。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_property_title_alignment:
.. rst-class:: classref-property
:ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **title_alignment** = ``0`` :ref:`🔗<class_FoldableContainer_property_title_alignment>`
.. rst-class:: classref-property-setget
- |void| **set_title_alignment**\ (\ value\: :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>`\ )
- :ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **get_title_alignment**\ (\ )
标题的水平文本对齐方式。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_property_title_position:
.. rst-class:: classref-property
:ref:`TitlePosition<enum_FoldableContainer_TitlePosition>` **title_position** = ``0`` :ref:`🔗<class_FoldableContainer_property_title_position>`
.. rst-class:: classref-property-setget
- |void| **set_title_position**\ (\ value\: :ref:`TitlePosition<enum_FoldableContainer_TitlePosition>`\ )
- :ref:`TitlePosition<enum_FoldableContainer_TitlePosition>` **get_title_position**\ (\ )
标题的位置。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_property_title_text_direction:
.. rst-class:: classref-property
:ref:`TextDirection<enum_Control_TextDirection>` **title_text_direction** = ``0`` :ref:`🔗<class_FoldableContainer_property_title_text_direction>`
.. rst-class:: classref-property-setget
- |void| **set_title_text_direction**\ (\ value\: :ref:`TextDirection<enum_Control_TextDirection>`\ )
- :ref:`TextDirection<enum_Control_TextDirection>` **get_title_text_direction**\ (\ )
标题的文本书写方向。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_property_title_text_overrun_behavior:
.. rst-class:: classref-property
:ref:`OverrunBehavior<enum_TextServer_OverrunBehavior>` **title_text_overrun_behavior** = ``0`` :ref:`🔗<class_FoldableContainer_property_title_text_overrun_behavior>`
.. rst-class:: classref-property-setget
- |void| **set_title_text_overrun_behavior**\ (\ value\: :ref:`OverrunBehavior<enum_TextServer_OverrunBehavior>`\ )
- :ref:`OverrunBehavior<enum_TextServer_OverrunBehavior>` **get_title_text_overrun_behavior**\ (\ )
定义标题在文本比可用空间更长时的行为。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
方法说明
--------
.. _class_FoldableContainer_method_add_title_bar_control:
.. rst-class:: classref-method
|void| **add_title_bar_control**\ (\ control\: :ref:`Control<class_Control>`\ ) :ref:`🔗<class_FoldableContainer_method_add_title_bar_control>`
添加放置在容器标题旁的 :ref:`Control<class_Control>`\ ,遮挡可点击区域。主要用途是添加 :ref:`Button<class_Button>` 节点,但可以是任何 :ref:`Control<class_Control>`\ 。
控件会被添加为该容器的子节点,必要时会从之前的父节点中移除。这些控件是右对齐的,最先添加的控件位于最左侧。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_method_expand:
.. rst-class:: classref-method
|void| **expand**\ (\ ) :ref:`🔗<class_FoldableContainer_method_expand>`
展开容器,发出 :ref:`folding_changed<class_FoldableContainer_signal_folding_changed>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_method_fold:
.. rst-class:: classref-method
|void| **fold**\ (\ ) :ref:`🔗<class_FoldableContainer_method_fold>`
折叠容器,发出 :ref:`folding_changed<class_FoldableContainer_signal_folding_changed>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_method_remove_title_bar_control:
.. rst-class:: classref-method
|void| **remove_title_bar_control**\ (\ control\: :ref:`Control<class_Control>`\ ) :ref:`🔗<class_FoldableContainer_method_remove_title_bar_control>`
移除使用 :ref:`add_title_bar_control()<class_FoldableContainer_method_add_title_bar_control>` 添加的 :ref:`Control<class_Control>`\ 。该节点不会自动释放,你需要使用 :ref:`Node.queue_free()<class_Node_method_queue_free>`\ 。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
主题属性说明
------------
.. _class_FoldableContainer_theme_color_collapsed_font_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **collapsed_font_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_FoldableContainer_theme_color_collapsed_font_color>`
折叠时的标题字体颜色。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_color_font_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_color** = ``Color(0.875, 0.875, 0.875, 1)`` :ref:`🔗<class_FoldableContainer_theme_color_font_color>`
展开时的标题字体颜色。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_color_font_outline_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **font_outline_color** = ``Color(1, 1, 1, 1)`` :ref:`🔗<class_FoldableContainer_theme_color_font_outline_color>`
标题字体轮廓颜色。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_color_hover_font_color:
.. rst-class:: classref-themeproperty
:ref:`Color<class_Color>` **hover_font_color** = ``Color(0.95, 0.95, 0.95, 1)`` :ref:`🔗<class_FoldableContainer_theme_color_hover_font_color>`
标题字体悬停颜色。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_constant_h_separation:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **h_separation** = ``2`` :ref:`🔗<class_FoldableContainer_theme_constant_h_separation>`
标题的图标和文本之间以及标题栏控件之间的水平间距。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_constant_outline_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **outline_size** = ``0`` :ref:`🔗<class_FoldableContainer_theme_constant_outline_size>`
标题字体轮廓大小。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_font_font:
.. rst-class:: classref-themeproperty
:ref:`Font<class_Font>` **font** :ref:`🔗<class_FoldableContainer_theme_font_font>`
标题字体。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_font_size_font_size:
.. rst-class:: classref-themeproperty
:ref:`int<class_int>` **font_size** :ref:`🔗<class_FoldableContainer_theme_font_size_font_size>`
标题字体大小。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_icon_expanded_arrow:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **expanded_arrow** :ref:`🔗<class_FoldableContainer_theme_icon_expanded_arrow>`
展开时使用的标题图标。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_icon_expanded_arrow_mirrored:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **expanded_arrow_mirrored** :ref:`🔗<class_FoldableContainer_theme_icon_expanded_arrow_mirrored>`
展开时使用的标题图标(用于底部标题)。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_icon_folded_arrow:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **folded_arrow** :ref:`🔗<class_FoldableContainer_theme_icon_folded_arrow>`
折叠时使用的标题图标(用于从左至右布局)。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_icon_folded_arrow_mirrored:
.. rst-class:: classref-themeproperty
:ref:`Texture2D<class_Texture2D>` **folded_arrow_mirrored** :ref:`🔗<class_FoldableContainer_theme_icon_folded_arrow_mirrored>`
展开时使用的标题图标(用于从右至左布局)。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_style_focus:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **focus** :ref:`🔗<class_FoldableContainer_theme_style_focus>`
**FoldableContainer** 拥有 GUI 焦点时使用的背景。\ :ref:`focus<class_FoldableContainer_theme_style_focus>` :ref:`StyleBox<class_StyleBox>` 显示在基础 :ref:`StyleBox<class_StyleBox>` *之上*\ ,所以应该使用部分透明的 :ref:`StyleBox<class_StyleBox>`\ ,确保基础 :ref:`StyleBox<class_StyleBox>` 仍然可见。代表轮廓或下划线的 :ref:`StyleBox<class_StyleBox>` 可以很好地实现这个目的。要禁用聚焦的视觉效果,请指定 :ref:`StyleBoxEmpty<class_StyleBoxEmpty>` 资源。请注意,禁用聚焦的视觉效果会影响使用键盘/手柄进行导航的可用性,所以出于可访问性的原因,不建议这样做。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_style_panel:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **panel** :ref:`🔗<class_FoldableContainer_theme_style_panel>`
**FoldableContainer** 的默认背景。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_style_title_collapsed_hover_panel:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **title_collapsed_hover_panel** :ref:`🔗<class_FoldableContainer_theme_style_title_collapsed_hover_panel>`
处于折叠状态下,鼠标光标进入标题区域时使用的背景。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_style_title_collapsed_panel:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **title_collapsed_panel** :ref:`🔗<class_FoldableContainer_theme_style_title_collapsed_panel>`
处于折叠状态下,\ **FoldableContainer** 标题的默认背景。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_style_title_hover_panel:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **title_hover_panel** :ref:`🔗<class_FoldableContainer_theme_style_title_hover_panel>`
处于展开状态下,鼠标光标进入标题区域时使用的背景。
.. rst-class:: classref-item-separator
----
.. _class_FoldableContainer_theme_style_title_panel:
.. rst-class:: classref-themeproperty
:ref:`StyleBox<class_StyleBox>` **title_panel** :ref:`🔗<class_FoldableContainer_theme_style_title_panel>`
处于展开状态下,\ **FoldableContainer** 标题的默认背景。
.. |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 (无返回值。)`