# 类: ForwardMessageNodeList

[(返回目录)](/api.md)

**继承自:** [MessageAPI](/api/messageapi.md)

RainyBot的转发消息列表类，通常代表一个对应实例，储存了某条合并转发消息中的所有单条转发消息

## 描述

这是RainyBot的转发消息列表类，通常代表一个对应实例，储存了某条合并转发消息中的所有单条转发消息\
你可以像数组/字典一样直接使用for x in x的语法来循环列表中的所有单条转发消息(将返回ForwardMessageNode类实例)

## 方法

* static [ForwardMessageNodeList](/api/forwardmessagenodelist.md) **init (** [Variant](https://docs.godotengine.org/en/latest/classes/class_variant.html) msg\_node **)**

手动构造一个ForwardMessageNodeList类的实例，以便将多个单条转发消息进行合并转发

传入的参数可以是以下类型:

* 单条转发消息实例(将其作为列表中的第一个单条转发消息实例)
* 包含单条转发消息实例的数组(将按照上方规则将数组中的实例依次添加至此转发列表)

***

* static [ForwardMessageNodeList](/api/forwardmessagenodelist.md) **init\_meta (** [Array](https://docs.godotengine.org/en/latest/classes/class_array.html) arr **)**

通过机器人协议后端的元数据数组构造一个此类的实例，仅当你知道自己在做什么时才使用

***

* [Array](https://docs.godotengine.org/en/latest/classes/class_array.html) **get\_metadata ( )**

获取实例中的元数据数组，仅当你知道自己在做什么时才使用

***

* void **set\_metadata (** [Array](https://docs.godotengine.org/en/latest/classes/class_array.html) arr **)**

使用指定数组覆盖实例中的元数据数组，仅当你知道自己在做什么时才使用

***

* [ForwardMessageNode](/api/forwardmessagenode.md) **get\_from\_index (** [int](https://docs.godotengine.org/en/latest/classes/class_int.html) index **)**

根据指定的序号来从此实例中获取对应的ForwardMessageNode实例

若序号不存在则返回null

***

* [int](https://docs.godotengine.org/en/latest/classes/class_int.html) **get\_size ( )**

获取转发消息列表中单条转发消息的总数

***

* [ForwardMessageNodeList](/api/forwardmessagenodelist.md) **append (** [Variant](https://docs.godotengine.org/en/latest/classes/class_variant.html) msg\_node **)**

将参数中的内容添加到此消息链实例中，并返回此消息链实例自身，以便于进行连续操作

传入的参数可以是以下类型:

* 单条转发消息实例(将其作为列表中的第一个单条转发消息实例)
* 包含单条转发消息实例的数组(将按照上方规则将数组中的实例依次添加至此转发列表)

***

* [ForwardMessageNode](/api/forwardmessagenode.md) **get\_from\_message\_id (** [int](https://docs.godotengine.org/en/latest/classes/class_int.html) message\_id **)**

基于指定的消息ID来查找并返回第一个找到的单条转发消息实例

***

* [ForwardMessageNode](/api/forwardmessagenode.md) **get\_from\_sender\_id (** [int](https://docs.godotengine.org/en/latest/classes/class_int.html) sender\_id **)**

基于指定的发送者ID来查找并返回第一个找到的单条转发消息实例

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rainybot.dev/api/forwardmessagenodelist.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.