:github_url: hide .. _class_TextParagraph: TextParagraph ============= **Наследует:** :ref:`RefCounted` **<** :ref:`Object` Содержит абзац текста. .. rst-class:: classref-introduction-group Описание ---------------- Абстракция над :ref:`TextServer` для обработки одного абзаца текста. .. rst-class:: classref-reftable-group Свойства ---------------- .. table:: :widths: auto +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`HorizontalAlignment` | :ref:`alignment` | ``0`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | |bitfield|\[:ref:`LineBreakFlag`\] | :ref:`break_flags` | ``3`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`String` | :ref:`custom_punctuation` | ``""`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`Direction` | :ref:`direction` | ``0`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`String` | :ref:`ellipsis_char` | ``"…"`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | |bitfield|\[:ref:`JustificationFlag`\] | :ref:`justification_flags` | ``163`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`float` | :ref:`line_spacing` | ``0.0`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`int` | :ref:`max_lines_visible` | ``-1`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`Orientation` | :ref:`orientation` | ``0`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`preserve_control` | ``false`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`bool` | :ref:`preserve_invalid` | ``true`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`OverrunBehavior` | :ref:`text_overrun_behavior` | ``0`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ | :ref:`float` | :ref:`width` | ``-1.0`` | +---------------------------------------------------------------------------+----------------------------------------------------------------------------------+-----------+ .. rst-class:: classref-reftable-group Методы ------------ .. table:: :widths: auto +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`add_object`\ (\ key\: :ref:`Variant`, size\: :ref:`Vector2`, inline_align\: :ref:`InlineAlignment` = 5, length\: :ref:`int` = 1, baseline\: :ref:`float` = 0.0\ ) | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`add_string`\ (\ text\: :ref:`String`, font\: :ref:`Font`, font_size\: :ref:`int`, language\: :ref:`String` = "", meta\: :ref:`Variant` = null\ ) | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear`\ (\ ) | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`clear_dropcap`\ (\ ) | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw`\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, color\: :ref:`Color` = Color(1, 1, 1, 1), dc_color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_dropcap`\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_dropcap_outline`\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_line`\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, line\: :ref:`int`, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_line_outline`\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, line\: :ref:`int`, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`draw_outline`\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), dc_color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`TextParagraph` | :ref:`duplicate`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_dropcap_lines`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_dropcap_rid`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_dropcap_size`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Direction` | :ref:`get_inferred_direction`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_line_ascent`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`get_line_count`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_line_descent`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Rect2` | :ref:`get_line_object_rect`\ (\ line\: :ref:`int`, key\: :ref:`Variant`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Array` | :ref:`get_line_objects`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_line_range`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_line_rid`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_line_size`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_line_underline_position`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_line_underline_thickness`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`float` | :ref:`get_line_width`\ (\ line\: :ref:`int`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_non_wrapped_size`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2i` | :ref:`get_range`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_rid`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector2` | :ref:`get_size`\ (\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`has_object`\ (\ key\: :ref:`Variant`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`int` | :ref:`hit_test`\ (\ coords\: :ref:`Vector2`\ ) |const| | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`resize_object`\ (\ key\: :ref:`Variant`, size\: :ref:`Vector2`, inline_align\: :ref:`InlineAlignment` = 5, baseline\: :ref:`float` = 0.0\ ) | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_bidi_override`\ (\ override\: :ref:`Array`\ ) | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`set_dropcap`\ (\ text\: :ref:`String`, font\: :ref:`Font`, font_size\: :ref:`int`, dropcap_margins\: :ref:`Rect2` = Rect2(0, 0, 0, 0), language\: :ref:`String` = ""\ ) | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`tab_align`\ (\ tab_stops\: :ref:`PackedFloat32Array`\ ) | +---------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Описания свойств -------------------------------- .. _class_TextParagraph_property_alignment: .. rst-class:: classref-property :ref:`HorizontalAlignment` **alignment** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_alignment**\ (\ value\: :ref:`HorizontalAlignment`\ ) - :ref:`HorizontalAlignment` **get_alignment**\ (\ ) Горизонтальное выравнивание абзаца. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_break_flags: .. rst-class:: classref-property |bitfield|\[:ref:`LineBreakFlag`\] **break_flags** = ``3`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_break_flags**\ (\ value\: |bitfield|\[:ref:`LineBreakFlag`\]\ ) - |bitfield|\[:ref:`LineBreakFlag`\] **get_break_flags**\ (\ ) Правила переноса строк. Для получения дополнительной информации см. :ref:`TextServer`. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_custom_punctuation: .. rst-class:: classref-property :ref:`String` **custom_punctuation** = ``""`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_custom_punctuation**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_custom_punctuation**\ (\ ) Пользовательский список знаков препинания, используемый для разбиения слов. Если задана пустая строка, используются значения сервера по умолчанию. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_direction: .. rst-class:: classref-property :ref:`Direction` **direction** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_direction**\ (\ value\: :ref:`Direction`\ ) - :ref:`Direction` **get_direction**\ (\ ) Направление написания текста. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_ellipsis_char: .. rst-class:: classref-property :ref:`String` **ellipsis_char** = ``"…"`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_ellipsis_char**\ (\ value\: :ref:`String`\ ) - :ref:`String` **get_ellipsis_char**\ (\ ) Символ многоточия, используемый для обрезки текста. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_justification_flags: .. rst-class:: classref-property |bitfield|\[:ref:`JustificationFlag`\] **justification_flags** = ``163`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_justification_flags**\ (\ value\: |bitfield|\[:ref:`JustificationFlag`\]\ ) - |bitfield|\[:ref:`JustificationFlag`\] **get_justification_flags**\ (\ ) Правила выравнивания заливки линий. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_line_spacing: .. rst-class:: classref-property :ref:`float` **line_spacing** = ``0.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_line_spacing**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_line_spacing**\ (\ ) Дополнительный вертикальный интервал между строками (в пикселях), интервал добавляется к спуску строки. Это значение может быть отрицательным. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_max_lines_visible: .. rst-class:: classref-property :ref:`int` **max_lines_visible** = ``-1`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_max_lines_visible**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_max_lines_visible**\ (\ ) Ограничивает количество отображаемых строк текста. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_orientation: .. rst-class:: classref-property :ref:`Orientation` **orientation** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_orientation**\ (\ value\: :ref:`Orientation`\ ) - :ref:`Orientation` **get_orientation**\ (\ ) Ориентация текста. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_preserve_control: .. rst-class:: classref-property :ref:`bool` **preserve_control** = ``false`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_preserve_control**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_preserve_control**\ (\ ) Если установлено значение ``true``, текст будет отображать управляющие символы. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_preserve_invalid: .. rst-class:: classref-property :ref:`bool` **preserve_invalid** = ``true`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_preserve_invalid**\ (\ value\: :ref:`bool`\ ) - :ref:`bool` **get_preserve_invalid**\ (\ ) Если установлено значение ``true``, в тексте будут отображаться недопустимые символы. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_text_overrun_behavior: .. rst-class:: classref-property :ref:`OverrunBehavior` **text_overrun_behavior** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_text_overrun_behavior**\ (\ value\: :ref:`OverrunBehavior`\ ) - :ref:`OverrunBehavior` **get_text_overrun_behavior**\ (\ ) Поведение обрезки, когда текст превышает заданную ширину абзаца. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_property_width: .. rst-class:: classref-property :ref:`float` **width** = ``-1.0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_width**\ (\ value\: :ref:`float`\ ) - :ref:`float` **get_width**\ (\ ) Ширина абзаца. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Описания метода ------------------------------ .. _class_TextParagraph_method_add_object: .. rst-class:: classref-method :ref:`bool` **add_object**\ (\ key\: :ref:`Variant`, size\: :ref:`Vector2`, inline_align\: :ref:`InlineAlignment` = 5, length\: :ref:`int` = 1, baseline\: :ref:`float` = 0.0\ ) :ref:`🔗` Добавляет встроенный объект в текстовый буфер, ``key`` должен быть уникальным. В тексте объект представлен как ``length`` символов замены объекта. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_add_string: .. rst-class:: classref-method :ref:`bool` **add_string**\ (\ text\: :ref:`String`, font\: :ref:`Font`, font_size\: :ref:`int`, language\: :ref:`String` = "", meta\: :ref:`Variant` = null\ ) :ref:`🔗` Добавляет текстовый диапазон и шрифт для его отрисовки. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_clear: .. rst-class:: classref-method |void| **clear**\ (\ ) :ref:`🔗` Очищает текстовый абзац (удаляет текст и встроенные объекты). .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_clear_dropcap: .. rst-class:: classref-method |void| **clear_dropcap**\ (\ ) :ref:`🔗` Удаляет начальную букву капитель (dropcap). .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_draw: .. rst-class:: classref-method |void| **draw**\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, color\: :ref:`Color` = Color(1, 1, 1, 1), dc_color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| :ref:`🔗` Нарисуйте все строки текста и буквицы в элементе холста в заданной позиции с ``color``. ``pos`` указывает верхний левый угол ограничивающего прямоугольника. Если ``oversampling`` больше нуля, он используется как фактор передискретизации шрифта, в противном случае используются настройки передискретизации области просмотра. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_draw_dropcap: .. rst-class:: classref-method |void| **draw_dropcap**\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| :ref:`🔗` Нарисуйте буквицу в элементе холста в заданной позиции с ``color``. ``pos`` указывает верхний левый угол ограничивающего прямоугольника. Если ``oversampling`` больше нуля, он используется как фактор передискретизации шрифта, в противном случае используются настройки передискретизации области просмотра. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_draw_dropcap_outline: .. rst-class:: classref-method |void| **draw_dropcap_outline**\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| :ref:`🔗` Нарисуйте контур буквицы в элементе холста в заданной позиции с ``color``. ``pos`` указывает верхний левый угол ограничивающего прямоугольника. Если ``oversampling`` больше нуля, он используется как фактор передискретизации шрифта, в противном случае используются настройки передискретизации области просмотра. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_draw_line: .. rst-class:: classref-method |void| **draw_line**\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, line\: :ref:`int`, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| :ref:`🔗` Нарисуйте одну строку текста в элементе холста в заданной позиции с ``color``. ``pos`` указывает верхний левый угол ограничивающего прямоугольника. Если ``oversampling`` больше нуля, он используется как фактор передискретизации шрифта, в противном случае используются настройки передискретизации области просмотра. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_draw_line_outline: .. rst-class:: classref-method |void| **draw_line_outline**\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, line\: :ref:`int`, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| :ref:`🔗` Нарисовать контур одной строки текста в элементе холста в заданной позиции с ``color``. ``pos`` указывает верхний левый угол ограничивающего прямоугольника. Если ``oversampling`` больше нуля, он используется как фактор передискретизации шрифта, в противном случае используются настройки передискретизации области просмотра. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_draw_outline: .. rst-class:: classref-method |void| **draw_outline**\ (\ canvas\: :ref:`RID`, pos\: :ref:`Vector2`, outline_size\: :ref:`int` = 1, color\: :ref:`Color` = Color(1, 1, 1, 1), dc_color\: :ref:`Color` = Color(1, 1, 1, 1), oversampling\: :ref:`float` = 0.0\ ) |const| :ref:`🔗` Нарисовать контуры всех строк текста и буквицы в элементе холста в заданной позиции с ``color``. ``pos`` указывает верхний левый угол ограничивающего прямоугольника. Если ``oversampling`` больше нуля, он используется как фактор передискретизации шрифта, в противном случае используются настройки передискретизации области просмотра. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_duplicate: .. rst-class:: classref-method :ref:`TextParagraph` **duplicate**\ (\ ) |const| :ref:`🔗` Duplicates this **TextParagraph**. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_dropcap_lines: .. rst-class:: classref-method :ref:`int` **get_dropcap_lines**\ (\ ) |const| :ref:`🔗` Возвращает количество строк, используемых в dropcap (буквицей). .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_dropcap_rid: .. rst-class:: classref-method :ref:`RID` **get_dropcap_rid**\ (\ ) |const| :ref:`🔗` Возвращает RID текстового буфера буквицы. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_dropcap_size: .. rst-class:: classref-method :ref:`Vector2` **get_dropcap_size**\ (\ ) |const| :ref:`🔗` Возвращает размер ограничивающего прямоугольника буквицы. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_inferred_direction: .. rst-class:: classref-method :ref:`Direction` **get_inferred_direction**\ (\ ) |const| :ref:`🔗` Возвращает направление написания текста, выведенное алгоритмом BiDi. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_ascent: .. rst-class:: classref-method :ref:`float` **get_line_ascent**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает высоту текстовой строки (количество пикселей над базовой линией для горизонтальной компоновки или слева от базовой линии для вертикальной). .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_count: .. rst-class:: classref-method :ref:`int` **get_line_count**\ (\ ) |const| :ref:`🔗` Возвращает количество строк в абзаце. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_descent: .. rst-class:: classref-method :ref:`float` **get_line_descent**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает смещение текстовой строки (количество пикселей ниже базовой линии для горизонтальной компоновки или справа от базовой линии для вертикальной). .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_object_rect: .. rst-class:: classref-method :ref:`Rect2` **get_line_object_rect**\ (\ line\: :ref:`int`, key\: :ref:`Variant`\ ) |const| :ref:`🔗` Возвращает ограничивающий прямоугольник встроенного объекта. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_objects: .. rst-class:: classref-method :ref:`Array` **get_line_objects**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает массив встроенных объектов в строке. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_range: .. rst-class:: classref-method :ref:`Vector2i` **get_line_range**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает диапазон символов строки. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_rid: .. rst-class:: classref-method :ref:`RID` **get_line_rid**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает RID буфера строки TextServer. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_size: .. rst-class:: classref-method :ref:`Vector2` **get_line_size**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает размер ограничивающего прямоугольника строки текста. Возвращаемый размер округляется в большую сторону. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_underline_position: .. rst-class:: classref-method :ref:`float` **get_line_underline_position**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает смещение подчеркивания в пикселях относительно базовой линии. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_underline_thickness: .. rst-class:: classref-method :ref:`float` **get_line_underline_thickness**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает толщину подчеркивания. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_line_width: .. rst-class:: classref-method :ref:`float` **get_line_width**\ (\ line\: :ref:`int`\ ) |const| :ref:`🔗` Возвращает ширину (для горизонтального расположения) или высоту (для вертикального расположения) строки текста. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_non_wrapped_size: .. rst-class:: classref-method :ref:`Vector2` **get_non_wrapped_size**\ (\ ) |const| :ref:`🔗` Возвращает размер ограничивающей рамки абзаца без переносов строк. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_range: .. rst-class:: classref-method :ref:`Vector2i` **get_range**\ (\ ) |const| :ref:`🔗` Возвращает диапазон символов абзаца/параграфа. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_rid: .. rst-class:: classref-method :ref:`RID` **get_rid**\ (\ ) |const| :ref:`🔗` Возвращает полный строковый буфер RID TextServer. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_get_size: .. rst-class:: classref-method :ref:`Vector2` **get_size**\ (\ ) |const| :ref:`🔗` Возвращает размер ограничивающей рамки абзаца. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_has_object: .. rst-class:: classref-method :ref:`bool` **has_object**\ (\ key\: :ref:`Variant`\ ) |const| :ref:`🔗` Returns ``true`` if an object with ``key`` is embedded in this shaped text buffer. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_hit_test: .. rst-class:: classref-method :ref:`int` **hit_test**\ (\ coords\: :ref:`Vector2`\ ) |const| :ref:`🔗` Возвращает смещение символа каретки в указанных координатах. Эта функция всегда возвращает допустимую позицию. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_resize_object: .. rst-class:: classref-method :ref:`bool` **resize_object**\ (\ key\: :ref:`Variant`, size\: :ref:`Vector2`, inline_align\: :ref:`InlineAlignment` = 5, baseline\: :ref:`float` = 0.0\ ) :ref:`🔗` Устанавливает новый размер и выравнивание внедренного объекта. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_set_bidi_override: .. rst-class:: classref-method |void| **set_bidi_override**\ (\ override\: :ref:`Array`\ ) :ref:`🔗` Переопределяет BiDi для структурированного текста. Диапазоны переопределения должны охватывать весь исходный текст без перекрытий. Алгоритм BiDi будет использоваться для каждого диапазона отдельно. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_set_dropcap: .. rst-class:: classref-method :ref:`bool` **set_dropcap**\ (\ text\: :ref:`String`, font\: :ref:`Font`, font_size\: :ref:`int`, dropcap_margins\: :ref:`Rect2` = Rect2(0, 0, 0, 0), language\: :ref:`String` = ""\ ) :ref:`🔗` Устанавливает буквицу, переопределяет ранее установленную буквицу. Буквица — декоративный элемент в начале абзаца, который больше остального текста. .. rst-class:: classref-item-separator ---- .. _class_TextParagraph_method_tab_align: .. rst-class:: classref-method |void| **tab_align**\ (\ tab_stops\: :ref:`PackedFloat32Array`\ ) :ref:`🔗` Выравнивает абзац по указанным позициям табуляции. .. |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 (Нет возвращаемого значения.)`