d516aab8fa
Also enhance RigidBody docs as per https://github.com/godotengine/godot-docs/pull/1018 and fix the version tag in all files (not really stable yet, but it makes no sense to hardcode rc3 at this stage).
340 lines
12 KiB
XML
340 lines
12 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="RichTextLabel" inherits="Control" category="Core" version="3.0-stable">
|
|
<brief_description>
|
|
Label that displays rich text.
|
|
</brief_description>
|
|
<description>
|
|
Rich text can contain custom text, fonts, images and some basic formatting. The label manages these as an internal tag stack. It also adapts itself to given width/heights.
|
|
Note that assignments to [member bbcode_text] clear the tag stack and reconstruct it from the property's contents. Any edits made to [member bbcode_text] will erase previous edits made from other manual sources such as [method append_bbcode] and the [code]push_*[/code] / [method pop] methods.
|
|
</description>
|
|
<tutorials>
|
|
http://docs.godotengine.org/en/3.0/learning/features/gui/bbcode_in_richtextlabel.html
|
|
</tutorials>
|
|
<demos>
|
|
</demos>
|
|
<methods>
|
|
<method name="add_image">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="image" type="Texture">
|
|
</argument>
|
|
<description>
|
|
Adds an image's opening and closing tags to the tag stack.
|
|
</description>
|
|
</method>
|
|
<method name="add_text">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="text" type="String">
|
|
</argument>
|
|
<description>
|
|
Adds raw non-bbcode-parsed text to the tag stack.
|
|
</description>
|
|
</method>
|
|
<method name="append_bbcode">
|
|
<return type="int" enum="Error">
|
|
</return>
|
|
<argument index="0" name="bbcode" type="String">
|
|
</argument>
|
|
<description>
|
|
Parses [code]bbcode[/code] and adds tags to the tag stack as needed. Returns the result of the parsing, [code]OK[/code] if successful.
|
|
</description>
|
|
</method>
|
|
<method name="clear">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Clears the tag stack and sets [member bbcode_text] to an empty string.
|
|
</description>
|
|
</method>
|
|
<method name="get_line_count" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the total number of newlines in the tag stack's text tags. Considers wrapped text as one line.
|
|
</description>
|
|
</method>
|
|
<method name="get_total_character_count" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the total number of characters from text tags. Does not include bbcodes.
|
|
</description>
|
|
</method>
|
|
<method name="get_v_scroll">
|
|
<return type="VScrollBar">
|
|
</return>
|
|
<description>
|
|
Returns the vertical scrollbar.
|
|
</description>
|
|
</method>
|
|
<method name="get_visible_line_count" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the number of visible lines.
|
|
</description>
|
|
</method>
|
|
<method name="newline">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Adds a newline tag to the tag stack.
|
|
</description>
|
|
</method>
|
|
<method name="parse_bbcode">
|
|
<return type="int" enum="Error">
|
|
</return>
|
|
<argument index="0" name="bbcode" type="String">
|
|
</argument>
|
|
<description>
|
|
The assignment version of [method append_bbcode]. Clears the tag stack and inserts the new content. Returns [code]OK[/code] if parses [code]bbcode[/code] successfully.
|
|
</description>
|
|
</method>
|
|
<method name="pop">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Terminates the current tag. Use after [code]push_*[/code] methods to close bbcodes manually. Does not need to follow [code]add_*[/code] methods.
|
|
</description>
|
|
</method>
|
|
<method name="push_align">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="align" type="int" enum="RichTextLabel.Align">
|
|
</argument>
|
|
<description>
|
|
Adds a [code][right][/code] tag to the tag stack.
|
|
</description>
|
|
</method>
|
|
<method name="push_cell">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Adds a [code][cell][/code] tag to the tag stack. Must be inside a [table] tag. See [method push_table] for details.
|
|
</description>
|
|
</method>
|
|
<method name="push_color">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="color" type="Color">
|
|
</argument>
|
|
<description>
|
|
Adds a [code][color][/code] tag to the tag stack.
|
|
</description>
|
|
</method>
|
|
<method name="push_font">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="font" type="Font">
|
|
</argument>
|
|
<description>
|
|
Adds a [code][font][/code] tag to the tag stack. Overrides default fonts for its duration.
|
|
</description>
|
|
</method>
|
|
<method name="push_indent">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="level" type="int">
|
|
</argument>
|
|
<description>
|
|
Adds an [code][indent][/code] tag to the tag stack. Multiplies "level" by current tab_size to determine new margin length.
|
|
</description>
|
|
</method>
|
|
<method name="push_list">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="type" type="int" enum="RichTextLabel.ListType">
|
|
</argument>
|
|
<description>
|
|
Adds a list tag to the tag stack. Similar to the bbcodes [code][ol][/code] or [code][ul][/code], but supports more list types. Not fully implemented!
|
|
</description>
|
|
</method>
|
|
<method name="push_meta">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="data" type="Variant">
|
|
</argument>
|
|
<description>
|
|
Adds a meta tag to the tag stack. Similar to the bbcode [code][url=something]{text}[/url][/code], but supports non-[String] metadata types.
|
|
</description>
|
|
</method>
|
|
<method name="push_table">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="columns" type="int">
|
|
</argument>
|
|
<description>
|
|
Adds a [code][table=columns][/code] tag to the tag stack.
|
|
</description>
|
|
</method>
|
|
<method name="push_underline">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Adds a [code][u][/code] tag to the tag stack.
|
|
</description>
|
|
</method>
|
|
<method name="remove_line">
|
|
<return type="bool">
|
|
</return>
|
|
<argument index="0" name="line" type="int">
|
|
</argument>
|
|
<description>
|
|
Removes a line of content from the label. Returns [code]true[/code] if the line exists.
|
|
</description>
|
|
</method>
|
|
<method name="scroll_to_line">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="line" type="int">
|
|
</argument>
|
|
<description>
|
|
Scrolls the window's top line to match [code]line[/code].
|
|
</description>
|
|
</method>
|
|
<method name="set_table_column_expand">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="column" type="int">
|
|
</argument>
|
|
<argument index="1" name="expand" type="bool">
|
|
</argument>
|
|
<argument index="2" name="ratio" type="int">
|
|
</argument>
|
|
<description>
|
|
Edits the selected columns expansion options. If [code]expand[/code] is [code]true[/code], the column expands in proportion to its expansion ratio versus the other columns' ratios.
|
|
For example, 2 columns with ratios 3 and 4 plus 70 pixels in available width would expand 30 and 40 pixels, respectively.
|
|
Columns with a [code]false[/code] expand will not contribute to the total ratio.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="bbcode_enabled" type="bool" setter="set_use_bbcode" getter="is_using_bbcode">
|
|
If [code]true[/code] the label uses BBCode formatting. Default value: [code]false[/code].
|
|
</member>
|
|
<member name="bbcode_text" type="String" setter="set_bbcode" getter="get_bbcode">
|
|
The label's text in BBCode format. Is not representative of manual modifications to the internal tag stack. Erases changes made by other methods when edited.
|
|
</member>
|
|
<member name="meta_underlined" type="bool" setter="set_meta_underline" getter="is_meta_underlined">
|
|
If [code]true[/code], the label underlines meta tags such as [url]{text}[/url]. Default value: [code]true[/code].
|
|
</member>
|
|
<member name="override_selected_font_color" type="bool" setter="set_override_selected_font_color" getter="is_overriding_selected_font_color">
|
|
If [code]true[/code] the label uses the custom font color. Default value: [code]false[/code].
|
|
</member>
|
|
<member name="percent_visible" type="float" setter="set_percent_visible" getter="get_percent_visible">
|
|
The text's visibility, as a [float] between 0.0 and 1.0.
|
|
</member>
|
|
<member name="scroll_active" type="bool" setter="set_scroll_active" getter="is_scroll_active">
|
|
If [code]true[/code], the scrollbar is visible. Does not block scrolling completely. See [method scroll_to_line]. Default value: [code]true[/code].
|
|
</member>
|
|
<member name="scroll_following" type="bool" setter="set_scroll_follow" getter="is_scroll_following">
|
|
If [code]true[/code], the window scrolls down to display new content automatically. Default value: [code]false[/code].
|
|
</member>
|
|
<member name="selection_enabled" type="bool" setter="set_selection_enabled" getter="is_selection_enabled">
|
|
If [code]true[/code], the label allows text selection.
|
|
</member>
|
|
<member name="tab_size" type="int" setter="set_tab_size" getter="get_tab_size">
|
|
The number of spaces associated with a single tab length. Does not affect "\t" in text tags, only indent tags.
|
|
</member>
|
|
<member name="text" type="String" setter="set_text" getter="get_text">
|
|
The raw text of the label.
|
|
When set, clears the tag stack and adds a raw text tag to the top of it. Does not parse bbcodes. Does not modify [member bbcode_text].
|
|
</member>
|
|
<member name="visible_characters" type="int" setter="set_visible_characters" getter="get_visible_characters">
|
|
The restricted number of characters to display in the label.
|
|
</member>
|
|
</members>
|
|
<signals>
|
|
<signal name="meta_clicked">
|
|
<argument index="0" name="meta" type="Nil">
|
|
</argument>
|
|
<description>
|
|
Triggered when the user clicks on content between [url] tags. If the meta is defined in text, e.g. [code][url={"data"="hi"}]hi[/url][/code], then the parameter for this signal will be a [String] type. If a particular type or an object is desired, the [method push_meta] method must be used to manually insert the data into the tag stack.
|
|
</description>
|
|
</signal>
|
|
<signal name="meta_hover_ended">
|
|
<argument index="0" name="meta" type="Nil">
|
|
</argument>
|
|
<description>
|
|
Triggers when the mouse exits a meta tag.
|
|
</description>
|
|
</signal>
|
|
<signal name="meta_hover_started">
|
|
<argument index="0" name="meta" type="Nil">
|
|
</argument>
|
|
<description>
|
|
Triggers when the mouse enters a meta tag.
|
|
</description>
|
|
</signal>
|
|
</signals>
|
|
<constants>
|
|
<constant name="ALIGN_LEFT" value="0" enum="Align">
|
|
</constant>
|
|
<constant name="ALIGN_CENTER" value="1" enum="Align">
|
|
</constant>
|
|
<constant name="ALIGN_RIGHT" value="2" enum="Align">
|
|
</constant>
|
|
<constant name="ALIGN_FILL" value="3" enum="Align">
|
|
</constant>
|
|
<constant name="LIST_NUMBERS" value="0" enum="ListType">
|
|
</constant>
|
|
<constant name="LIST_LETTERS" value="1" enum="ListType">
|
|
</constant>
|
|
<constant name="LIST_DOTS" value="2" enum="ListType">
|
|
</constant>
|
|
<constant name="ITEM_FRAME" value="0" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_TEXT" value="1" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_IMAGE" value="2" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_NEWLINE" value="3" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_FONT" value="4" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_COLOR" value="5" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_UNDERLINE" value="6" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_ALIGN" value="7" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_INDENT" value="8" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_LIST" value="9" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_TABLE" value="10" enum="ItemType">
|
|
</constant>
|
|
<constant name="ITEM_META" value="11" enum="ItemType">
|
|
</constant>
|
|
</constants>
|
|
<theme_items>
|
|
<theme_item name="bold_font" type="Font">
|
|
</theme_item>
|
|
<theme_item name="bold_italics_font" type="Font">
|
|
</theme_item>
|
|
<theme_item name="default_color" type="Color">
|
|
</theme_item>
|
|
<theme_item name="focus" type="StyleBox">
|
|
</theme_item>
|
|
<theme_item name="font_color_selected" type="Color">
|
|
</theme_item>
|
|
<theme_item name="italics_font" type="Font">
|
|
</theme_item>
|
|
<theme_item name="line_separation" type="int">
|
|
</theme_item>
|
|
<theme_item name="mono_font" type="Font">
|
|
</theme_item>
|
|
<theme_item name="normal" type="StyleBox">
|
|
</theme_item>
|
|
<theme_item name="normal_font" type="Font">
|
|
</theme_item>
|
|
<theme_item name="selection_color" type="Color">
|
|
</theme_item>
|
|
<theme_item name="table_hseparation" type="int">
|
|
</theme_item>
|
|
<theme_item name="table_vseparation" type="int">
|
|
</theme_item>
|
|
</theme_items>
|
|
</class>
|