virtualx-engine/doc/classes/ClassDB.xml
Hugo Locurcio f7f6115f76
Proofread and improve the whole class reference
- Document a few more properties and methods
- Add more information to many classes
- Fix lots of typos and gramar mistakes
- Use [code] tags for parameters consistently
- Use [b] and [i] tags consistently
- Put "Warning:" and "Note:" on their own line to be more visible,
  and make them always bold
- Tweak formatting in code examples to be more readable
- Use double quotes consistently
- Add more links to third-party technologies
2019-06-27 22:30:19 +02:00

221 lines
7.9 KiB
XML

<?xml version="1.0" encoding="UTF-8" ?>
<class name="ClassDB" inherits="Object" category="Core" version="3.2">
<brief_description>
Class information repository.
</brief_description>
<description>
Provides access to metadata stored for every available class.
</description>
<tutorials>
</tutorials>
<methods>
<method name="can_instance" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="class" type="String">
</argument>
<description>
Returns [code]true[/code] if you can instance objects from the specified [code]class[/code], [code]false[/code] in other case.
</description>
</method>
<method name="class_exists" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="class" type="String">
</argument>
<description>
Returns whether the specified [code]class[/code] is available or not.
</description>
</method>
<method name="class_get_category" qualifiers="const">
<return type="String">
</return>
<argument index="0" name="class" type="String">
</argument>
<description>
Returns a category associated with the class for use in documentation and the Asset Library. Debug mode required.
</description>
</method>
<method name="class_get_integer_constant" qualifiers="const">
<return type="int">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="name" type="String">
</argument>
<description>
Returns the value of the integer constant [code]name[/code] of [code]class[/code] or its ancestry. Always returns 0 when the constant could not be found.
</description>
</method>
<method name="class_get_integer_constant_list" qualifiers="const">
<return type="PoolStringArray">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="no_inheritance" type="bool" default="false">
</argument>
<description>
Returns an array with the names all the integer constants of [code]class[/code] or its ancestry.
</description>
</method>
<method name="class_get_method_list" qualifiers="const">
<return type="Array">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="no_inheritance" type="bool" default="false">
</argument>
<description>
Returns an array with all the methods of [code]class[/code] or its ancestry if [code]no_inheritance[/code] is [code]false[/code]. Every element of the array is a [Dictionary] with the following keys: [code]args[/code], [code]default_args[/code], [code]flags[/code], [code]id[/code], [code]name[/code], [code]return: (class_name, hint, hint_string, name, type, usage)[/code].
</description>
</method>
<method name="class_get_property" qualifiers="const">
<return type="Variant">
</return>
<argument index="0" name="object" type="Object">
</argument>
<argument index="1" name="property" type="String">
</argument>
<description>
Returns the value of [code]property[/code] of [code]class[/code] or its ancestry.
</description>
</method>
<method name="class_get_property_list" qualifiers="const">
<return type="Array">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="no_inheritance" type="bool" default="false">
</argument>
<description>
Returns an array with all the properties of [code]class[/code] or its ancestry if [code]no_inheritance[/code] is [code]false[/code].
</description>
</method>
<method name="class_get_signal" qualifiers="const">
<return type="Dictionary">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="signal" type="String">
</argument>
<description>
Returns the [code]signal[/code] data of [code]class[/code] or its ancestry. The returned value is a [Dictionary] with the following keys: [code]args[/code], [code]default_args[/code], [code]flags[/code], [code]id[/code], [code]name[/code], [code]return: (class_name, hint, hint_string, name, type, usage)[/code].
</description>
</method>
<method name="class_get_signal_list" qualifiers="const">
<return type="Array">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="no_inheritance" type="bool" default="false">
</argument>
<description>
Returns an array with all the signals of [code]class[/code] or its ancestry if [code]no_inheritance[/code] is [code]false[/code]. Every element of the array is a [Dictionary] as described in [method class_get_signal].
</description>
</method>
<method name="class_has_integer_constant" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="name" type="String">
</argument>
<description>
Returns whether [code]class[/code] or its ancestry has an integer constant called [code]name[/code] or not.
</description>
</method>
<method name="class_has_method" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="method" type="String">
</argument>
<argument index="2" name="no_inheritance" type="bool" default="false">
</argument>
<description>
Returns whether [code]class[/code] (or its ancestry if [code]no_inheritance[/code] is false) has a method called [code]method[/code] or not.
</description>
</method>
<method name="class_has_signal" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="signal" type="String">
</argument>
<description>
Returns whether [code]class[/code] or its ancestry has a signal called [code]signal[/code] or not.
</description>
</method>
<method name="class_set_property" qualifiers="const">
<return type="int" enum="Error">
</return>
<argument index="0" name="object" type="Object">
</argument>
<argument index="1" name="property" type="String">
</argument>
<argument index="2" name="value" type="Variant">
</argument>
<description>
Sets [code]property[/code] value of [code]class[/code] to [code]value[/code].
</description>
</method>
<method name="get_class_list" qualifiers="const">
<return type="PoolStringArray">
</return>
<description>
Returns the names of all the classes available.
</description>
</method>
<method name="get_inheriters_from_class" qualifiers="const">
<return type="PoolStringArray">
</return>
<argument index="0" name="class" type="String">
</argument>
<description>
Returns the names of all the classes that directly or indirectly inherit from [code]class[/code].
</description>
</method>
<method name="get_parent_class" qualifiers="const">
<return type="String">
</return>
<argument index="0" name="class" type="String">
</argument>
<description>
Returns the parent class of [code]class[/code].
</description>
</method>
<method name="instance" qualifiers="const">
<return type="Variant">
</return>
<argument index="0" name="class" type="String">
</argument>
<description>
Creates an instance of [code]class[/code].
</description>
</method>
<method name="is_class_enabled" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="class" type="String">
</argument>
<description>
Returns whether this class is enabled or not.
</description>
</method>
<method name="is_parent_class" qualifiers="const">
<return type="bool">
</return>
<argument index="0" name="class" type="String">
</argument>
<argument index="1" name="inherits" type="String">
</argument>
<description>
Returns whether [code]inherits[/code] is an ancestor of [code]class[/code] or not.
</description>
</method>
</methods>
<constants>
</constants>
</class>