mirror of
				https://github.com/godotengine/godot.git
				synced 2025-10-31 13:41:03 +00:00 
			
		
		
		
	 a7ac8ec876
			
		
	
	
		a7ac8ec876
		
	
	
	
	
		
			
			Follow-up to #31925, `<member />` tags just before `</members>` would cause a parsing issue, and we'd never notice that we're no longer parsing members. Also added space before closing `/>`.
		
			
				
	
	
		
			252 lines
		
	
	
	
		
			7.7 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			252 lines
		
	
	
	
		
			7.7 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
| <?xml version="1.0" encoding="UTF-8" ?>
 | |
| <class name="OptionButton" inherits="Button" category="Core" version="3.2">
 | |
| 	<brief_description>
 | |
| 		Button control that provides selectable options when pressed.
 | |
| 	</brief_description>
 | |
| 	<description>
 | |
| 		OptionButton is a type button that provides a selectable list of items when pressed. The item selected becomes the "current" item and is displayed as the button text.
 | |
| 	</description>
 | |
| 	<tutorials>
 | |
| 	</tutorials>
 | |
| 	<methods>
 | |
| 		<method name="add_icon_item">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="texture" type="Texture">
 | |
| 			</argument>
 | |
| 			<argument index="1" name="label" type="String">
 | |
| 			</argument>
 | |
| 			<argument index="2" name="id" type="int" default="-1">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Adds an item, with a [code]texture[/code] icon, text [code]label[/code] and (optionally) [code]id[/code]. If no [code]id[/code] is passed, [code]id[/code] becomes the item index. New items are appended at the end.
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="add_item">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="label" type="String">
 | |
| 			</argument>
 | |
| 			<argument index="1" name="id" type="int" default="-1">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Adds an item, with text [code]label[/code] and (optionally) [code]id[/code]. If no [code]id[/code] is passed, [code]id[/code] becomes the item index. New items are appended at the end.
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="add_separator">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<description>
 | |
| 				Adds a separator to the list of items. Separators help to group items. Separator also takes up an index and is appended at the end.
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="clear">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<description>
 | |
| 				Clear all the items in the [OptionButton].
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_item_count" qualifiers="const">
 | |
| 			<return type="int">
 | |
| 			</return>
 | |
| 			<description>
 | |
| 				Returns the amount of items in the OptionButton.
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_item_icon" qualifiers="const">
 | |
| 			<return type="Texture">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Returns the icon of the item at index [code]idx[/code].
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_item_id" qualifiers="const">
 | |
| 			<return type="int">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Returns the ID of the item at index [code]idx[/code].
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_item_index" qualifiers="const">
 | |
| 			<return type="int">
 | |
| 			</return>
 | |
| 			<argument index="0" name="id" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Returns the index of the item with the given [code]id[/code].
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_item_metadata" qualifiers="const">
 | |
| 			<return type="Variant">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_item_text" qualifiers="const">
 | |
| 			<return type="String">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Returns the text of the item at index [code]idx[/code].
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_popup" qualifiers="const">
 | |
| 			<return type="PopupMenu">
 | |
| 			</return>
 | |
| 			<description>
 | |
| 				Returns the [PopupMenu] contained in this button.
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_selected_id" qualifiers="const">
 | |
| 			<return type="int">
 | |
| 			</return>
 | |
| 			<description>
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="get_selected_metadata" qualifiers="const">
 | |
| 			<return type="Variant">
 | |
| 			</return>
 | |
| 			<description>
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="is_item_disabled" qualifiers="const">
 | |
| 			<return type="bool">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="remove_item">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="select">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Select an item by index and make it the current item.
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="set_item_disabled">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<argument index="1" name="disabled" type="bool">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="set_item_icon">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<argument index="1" name="texture" type="Texture">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Sets the icon of an item at index [code]idx[/code].
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="set_item_id">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<argument index="1" name="id" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Sets the ID of an item at index [code]idx[/code].
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="set_item_metadata">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<argument index="1" name="metadata" type="Variant">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 			</description>
 | |
| 		</method>
 | |
| 		<method name="set_item_text">
 | |
| 			<return type="void">
 | |
| 			</return>
 | |
| 			<argument index="0" name="idx" type="int">
 | |
| 			</argument>
 | |
| 			<argument index="1" name="text" type="String">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Sets the text of an item at index [code]idx[/code].
 | |
| 			</description>
 | |
| 		</method>
 | |
| 	</methods>
 | |
| 	<members>
 | |
| 		<member name="action_mode" type="int" setter="set_action_mode" getter="get_action_mode" override="true" enum="BaseButton.ActionMode" default="0" />
 | |
| 		<member name="align" type="int" setter="set_text_align" getter="get_text_align" override="true" enum="Button.TextAlign" default="0" />
 | |
| 		<member name="selected" type="int" setter="_select_int" getter="get_selected" default="-1">
 | |
| 		</member>
 | |
| 		<member name="toggle_mode" type="bool" setter="set_toggle_mode" getter="is_toggle_mode" override="true" default="true" />
 | |
| 	</members>
 | |
| 	<signals>
 | |
| 		<signal name="item_focused">
 | |
| 			<argument index="0" name="id" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Emitted the when user navigates to an item using the [code]ui_up[/code] or [code]ui_down[/code] actions. The index of the item selected is passed as argument.
 | |
| 			</description>
 | |
| 		</signal>
 | |
| 		<signal name="item_selected">
 | |
| 			<argument index="0" name="id" type="int">
 | |
| 			</argument>
 | |
| 			<description>
 | |
| 				Emitted when the current item has been changed by the user. The index of the item selected is passed as argument.
 | |
| 			</description>
 | |
| 		</signal>
 | |
| 	</signals>
 | |
| 	<constants>
 | |
| 	</constants>
 | |
| 	<theme_items>
 | |
| 		<theme_item name="arrow" type="Texture">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="arrow_margin" type="int" default="2">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="disabled" type="StyleBox">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="focus" type="StyleBox">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="font" type="Font">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="font_color" type="Color" default="Color( 0.88, 0.88, 0.88, 1 )">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="font_color_disabled" type="Color" default="Color( 0.9, 0.9, 0.9, 0.2 )">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="font_color_hover" type="Color" default="Color( 0.94, 0.94, 0.94, 1 )">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="font_color_pressed" type="Color" default="Color( 1, 1, 1, 1 )">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="hover" type="StyleBox">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="hseparation" type="int" default="2">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="normal" type="StyleBox">
 | |
| 		</theme_item>
 | |
| 		<theme_item name="pressed" type="StyleBox">
 | |
| 		</theme_item>
 | |
| 	</theme_items>
 | |
| </class>
 |