mirror of
https://github.com/godotengine/godot-docs.git
synced 2026-01-04 14:11:02 +03:00
99 lines
5.3 KiB
ReStructuredText
99 lines
5.3 KiB
ReStructuredText
.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
|
|
.. DO NOT EDIT THIS FILE, but the NodePath.xml source instead.
|
|
.. The source is found in doc/classes or modules/<name>/doc_classes.
|
|
|
|
.. _class_NodePath:
|
|
|
|
NodePath
|
|
========
|
|
|
|
**Category:** Built-In Types
|
|
|
|
Brief Description
|
|
-----------------
|
|
|
|
Pre-parsed scene tree path.
|
|
|
|
Member Functions
|
|
----------------
|
|
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
| :ref:`NodePath<class_nodepath>` | :ref:`NodePath<class_NodePath_NodePath>` **(** :ref:`String<class_string>` from **)** |
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_name<class_NodePath_get_name>` **(** :ref:`int<class_int>` idx **)** |
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_name_count<class_NodePath_get_name_count>` **(** **)** |
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_property<class_NodePath_get_property>` **(** **)** |
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_subname<class_NodePath_get_subname>` **(** :ref:`int<class_int>` idx **)** |
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_subname_count<class_NodePath_get_subname_count>` **(** **)** |
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_absolute<class_NodePath_is_absolute>` **(** **)** |
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_empty<class_NodePath_is_empty>` **(** **)** |
|
|
+----------------------------------+-----------------------------------------------------------------------------------------+
|
|
|
|
Description
|
|
-----------
|
|
|
|
A pre-parsed relative or absolute path in a scene tree, for use with :ref:`Node.get_node<class_Node_get_node>` and similar functions. It can reference a node, a resource within a node, or a property of a node or resource. For instance, ``"Path2D/PathFollow2D/Sprite:texture:size"`` would refer to the size property of the texture resource on the node named "Sprite" which is a child of the other named nodes in the path. Note that if you want to get a resource, you must end the path with a colon, otherwise the last element will be used as a property name.
|
|
|
|
You will usually just pass a string to :ref:`Node.get_node<class_Node_get_node>` and it will be automatically converted, but you may occasionally want to parse a path ahead of time with :ref:`NodePath<class_nodepath>` or the literal syntax ``@"path"``. Exporting a :ref:`NodePath<class_nodepath>` variable will give you a node selection widget in the properties panel of the editor, which can often be useful.
|
|
|
|
A :ref:`NodePath<class_nodepath>` is made up of a list of node names, a list of "subnode" (resource) names, and the name of a property in the final node or resource.
|
|
|
|
Member Function Description
|
|
---------------------------
|
|
|
|
.. _class_NodePath_NodePath:
|
|
|
|
- :ref:`NodePath<class_nodepath>` **NodePath** **(** :ref:`String<class_string>` from **)**
|
|
|
|
Create a NodePath from a string, e.g. "Path2D/PathFollow2D/Sprite:texture:size". A path is absolute if it starts with a slash. Absolute paths are only valid in the global scene tree, not within individual scenes. In a relative path, ``"."`` and ``".."`` indicate the current node and its parent.
|
|
|
|
.. _class_NodePath_get_name:
|
|
|
|
- :ref:`String<class_string>` **get_name** **(** :ref:`int<class_int>` idx **)**
|
|
|
|
Get the node name indicated by ``idx`` (0 to :ref:`get_name_count<class_NodePath_get_name_count>`)
|
|
|
|
.. _class_NodePath_get_name_count:
|
|
|
|
- :ref:`int<class_int>` **get_name_count** **(** **)**
|
|
|
|
Get the number of node names which make up the path.
|
|
|
|
.. _class_NodePath_get_property:
|
|
|
|
- :ref:`String<class_string>` **get_property** **(** **)**
|
|
|
|
Get the path's property name, or an empty string if the path doesn't have a property.
|
|
|
|
.. _class_NodePath_get_subname:
|
|
|
|
- :ref:`String<class_string>` **get_subname** **(** :ref:`int<class_int>` idx **)**
|
|
|
|
Get the resource name indicated by ``idx`` (0 to :ref:`get_subname_count<class_NodePath_get_subname_count>`)
|
|
|
|
.. _class_NodePath_get_subname_count:
|
|
|
|
- :ref:`int<class_int>` **get_subname_count** **(** **)**
|
|
|
|
Get the number of resource names in the path.
|
|
|
|
.. _class_NodePath_is_absolute:
|
|
|
|
- :ref:`bool<class_bool>` **is_absolute** **(** **)**
|
|
|
|
Return true if the node path is absolute (not relative).
|
|
|
|
.. _class_NodePath_is_empty:
|
|
|
|
- :ref:`bool<class_bool>` **is_empty** **(** **)**
|
|
|
|
Return true if the node path is empty.
|
|
|
|
|