Translation

繼承： Resource < RefCounted < Object

被繼承： OptimizedTranslation

語言翻譯，能夠將一組字串對應到對應的翻譯。

說明

Translation 是可以按需載入和解除安裝的資源，能夠將一組字串對應到對應的翻譯。還為複數形式提供了便捷方法。

教學

• 將遊戲國際化

• Localization using gettext

• 區域設定

屬性

String

locale

"en"

方法

StringName	_get_message(src_message: StringName, context: StringName) virtual const
StringName	_get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName) virtual const
void	add_message(src_message: StringName, xlated_message: StringName, context: StringName = &"")
void	add_plural_message(src_message: StringName, xlated_messages: PackedStringArray, context: StringName = &"")
void	erase_message(src_message: StringName, context: StringName = &"")
StringName	get_message(src_message: StringName, context: StringName = &"") const
int	get_message_count() const
PackedStringArray	get_message_list() const
StringName	get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName = &"") const
PackedStringArray	get_translated_message_list() const

---

屬性說明

String locale = "en" 🔗

• void set_locale(value: String)

• String get_locale()

翻譯的區域設定。

---

方法說明

StringName _get_message(src_message: StringName, context: StringName) virtual const 🔗

覆蓋 get_message() 的虛方法。

---

StringName _get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName) virtual const 🔗

覆蓋 get_plural_message() 的虛方法。

---

void add_message(src_message: StringName, xlated_message: StringName, context: StringName = &"") 🔗

如果不存在，則新增一條消息，後跟其翻譯。

可以使用一個額外的本文，來指定翻譯本文或區分多義詞。

---

void add_plural_message(src_message: StringName, xlated_messages: PackedStringArray, context: StringName = &"") 🔗

Adds a message involving plural translation if nonexistent, followed by its translation.

An additional context could be used to specify the translation context or differentiate polysemic words.

Note: Plurals are only supported in gettext-based translations (PO), not CSV.

---

void erase_message(src_message: StringName, context: StringName = &"") 🔗

刪除資訊。

---

StringName get_message(src_message: StringName, context: StringName = &"") const 🔗

返回資訊的翻譯。

---

int get_message_count() const 🔗

返回現有資訊的數量。

---

PackedStringArray get_message_list() const 🔗

返回所有的資訊（鍵值）。

---

StringName get_plural_message(src_message: StringName, src_plural_message: StringName, n: int, context: StringName = &"") const 🔗

Returns a message's translation involving plurals.

The number n is the number or quantity of the plural object. It will be used to guide the translation system to fetch the correct plural form for the selected language.

Note: Plurals are only supported in gettext-based translations (PO), not CSV.

---

PackedStringArray get_translated_message_list() const 🔗

返回所有資訊（翻譯後的文字）。