GuiMain

`Class.ScreenGui` là một container lưu trữ cho các `Class.GuiObject|GuiObjects` 2D
được hiển thị trên màn hình của người dùng. Một `Class.ScreenGui` chỉ hiển thị nếu được gán cho
`Class.PlayerGui` của người chơi; việc gán `Class.ScreenGui` cho
`Class.StarterGui` đảm bảo nó sẽ được sao chép vào `Class.PlayerGui` của mỗi người chơi khi
họ tham gia trải nghiệm và nhân vật của họ lần đầu xuất hiện. Xem
[On‑Screen UI Containers](/ui/on-screen-containers) để biết thêm chi tiết.

<img src="../../../assets/ui/ui-objects/ScreenGui-Example.jpg" width="840" alt="Ví dụ ScreenGui với các phần tử GuiObject con khác nhau, bao gồm một Frame, TextLabel, TextBox và ImageButton." />

Để cải thiện hiệu suất, hình dáng của `Class.ScreenGui` được lưu cache
cho đến khi một trong các sự kiện sau xảy ra:

- Một phần tử con được thêm vào hoặc xóa khỏi nó.
- Một thuộc tính của một phần tử con thay đổi.
- Một thuộc tính của chính `Class.ScreenGui` thay đổi.

Nếu bất kỳ sự kiện nào trong số này xảy ra, hình dáng của `Class.ScreenGui` sẽ được tính toán lại
trong khung tiếp theo mà nó được hiển thị.


ScreenGui

Nếu thuộc tính này là `true`, tất cả các phần tử con `Class.GuiObject` của
`Class.ScreenGui` sẽ được cắt theo khu vực an toàn của thiết bị (xem
`Enum.ScreenInsets`). Mặc định là `true` để duy trì tính tương thích ngược
của UI mà cố tình bị ẩn ngoài màn hình, chẳng hạn như
các đối tượng trượt vào hiển thị từ một cạnh màn hình khi chúng cần thiết.

<img
src="../../../assets/engine-api/classes/ScreenGui/ClipToDeviceSafeArea-True.png"
width="840" alt="Thiết bị di động hiển thị nút UI bị cắt theo khu vực an toàn của thiết bị" />

Nếu thuộc tính này là `false`, các phần tử con `Class.GuiObject` sẽ **không**
bị cắt theo khu vực an toàn của thiết bị và có thể bị che khuất bởi notch camera
hoặc các khuyết điểm khác trên màn hình.

<img
src="../../../assets/engine-api/classes/ScreenGui/ClipToDeviceSafeArea-False.png"
width="840" alt="Thiết bị di động hiển thị nút UI tràn ra khu vực an toàn của thiết bị, bị che khuất bởi notch camera trên màn hình" />

Lưu ý rằng thuộc tính này sẽ bị bỏ qua nếu bạn thiết lập
`Class.ScreenGui.ScreenInsets|ScreenInsets` thành `Enum.ScreenInsets|None`,
bởi vì làm như vậy có nghĩa là bạn cố tình muốn bỏ qua các lề an toàn của thiết bị.


ScreenGui.ClipToDeviceSafeArea

Liệu có cắt nội dung của `Class.ScreenGui` này theo khu vực an toàn của thiết bị hay không.


Thuộc tính này điều khiển thứ tự Z-index mà nhiều
`Class.ScreenGui` containers được vẽ. Những cái có
`Class.ScreenGui.DisplayOrder|DisplayOrder` cao hơn sẽ được vẽ trên
những cái có giá trị thấp hơn.


ScreenGui.DisplayOrder

Điều khiển thứ tự Z-index mà nhiều `Class.ScreenGui` container được vẽ.


Nếu thuộc tính này là `false` (mặc định),
`Class.ScreenGui.ScreenInsets|ScreenInsets` được đặt thành
`Enum.ScreenInsets|CoreUISafeInsets`, hiệu quả giữ các giới hạn bên dưới
UI cơ bản của thanh công cụ Roblox.

Nếu thuộc tính này được thay đổi thành `true` và
`Class.ScreenGui.ScreenInsets|ScreenInsets` hiện đang được đặt là
`Enum.ScreenInsets|CoreUISafeInsets`,
`Class.ScreenGui.ScreenInsets|ScreenInsets` sẽ được đặt thành
`Enum.ScreenInsets|DeviceSafeInsets`.

Xem `Class.ScreenGui.ScreenInsets|ScreenInsets` để biết chi tiết về cách các lề
mặt ảnh hưởng đến nội dung của `Class.ScreenGui`.


ScreenGui.IgnoreGuiInset

Xác định xem `Class.ScreenGui` có tràn vào các phần tử UI cơ bản của
Roblox hay không.


Thuộc tính này xác định xem có áp dụng các chuyển đổi tương thích UI tự động
cho các "toàn màn hình" `Class.GuiObject|GuiObjects` của
`Class.ScreenGui` trên các màn hình có khuyết điểm hay không. Điều kiện xảy ra nếu
khu vực tổng cộng của `Class.GuiObject` con (bao gồm các đường viền hay `Class.UIStroke` áp dụng)
có thể bao phủ khu vực an toàn của thiết bị cả theo chiều ngang và chiều dọc. Xem
tham chiếu `Enum.SafeAreaCompatibility` để biết thêm chi tiết.

Giá trị mặc định là `Enum.SafeAreaCompatibility|FullscreenExtension` nhằm
tự động cải thiện hình dáng của UI được tạo ra cho
các màn hình không có khuyết điểm nào. Tuy nhiên, việc sử dụng
các mở rộng toàn màn hình cho công việc mới là không được khuyến khích; thay vào đó,
bạn nên sử dụng thuộc tính `Class.ScreenGui.ScreenInsets|ScreenInsets` để xác định các
lề nào nên được tôn trọng cho các container `Class.ScreenGui` khác nhau.

Lưu ý rằng các đối tượng UI con sẽ tiếp tục bị cắt bởi khu vực an toàn của thiết bị nếu
`Class.ScreenGui.ClipToDeviceSafeArea|ClipToDeviceSafeArea` được đặt thành
`true`.


ScreenGui.SafeAreaCompatibility

Xác định xem có áp dụng chuyển đổi tương thích UI tự động cho các "toàn màn hình" `Class.GuiObject|GuiObjects`
trên các màn hình có khuyết điểm hay không.


Thuộc tính này điều khiển các lề khu vực an toàn được áp dụng cho
nội dung của `Class.ScreenGui`.

Giá trị mặc định của `Enum.ScreenInsets|CoreUISafeInsets` giữ tất cả các phần tử con
`Class.GuiObject|GuiObjects` bên trong khu vực an toàn của UI cơ bản, tránh khỏi
các nút trên thanh công cụ Roblox và các khuyết điểm khác trên màn hình như notch camera của thiết bị.

<img src="../../../assets/engine-api/enums/ScreenInsets/CoreUISafeInsets.png" width="840" alt="Thiết bị di động hiển thị các nút UI bên trong khu vực an toàn của UI cơ bản" />

Nếu bạn thiết lập thuộc tính này thành `Enum.ScreenInsets|None`, các đối tượng UI có thể bị
che khuất bởi các đối tượng UI cơ bản hoặc các khuyết điểm của thiết bị như notch camera.
Do đó, bạn chỉ nên sử dụng `Enum.ScreenInsets|None` cho một
`Class.ScreenGui` chứa nội dung không tương tác như hình nền.

Xem
[On-Screen UI Containers](/ui/on-screen-containers#screen-insets)
để có thêm ví dụ thay thế.


ScreenGui.ScreenInsets

Điều khiển các lề khu vực an toàn mà được áp dụng cho nội dung của
`Class.ScreenGui`.


Thành phần chính của các phần tử giao diện người dùng 2D trên màn hình.


**LayerCollector** là lớp cơ sở của các container UI 2D, hiển thị
các con cháu của `Class.GuiObject`, chẳng hạn như `Class.ScreenGui`.

Để cải thiện hiệu suất, hình thức của `Class.LayerCollector`
bị lưu trữ cho đến khi một trong các sự kiện sau xảy ra:

- Một con cháu được thêm vào hoặc xóa khỏi nó.
- Một thuộc tính của một con cháu thay đổi.
- Một thuộc tính của chính `Class.LayerCollector` thay đổi.

LayerCollector:GetLayoutNodeTree

LayerCollector

Chuyển đổi khả năng nhìn thấy của `Class.LayerCollector` này. Khi là `false`, các
nội dung UI sẽ không được hiển thị, không xử lý đầu vào của người dùng, hoặc cập nhật
theo phản ứng với các thay đổi.

LayerCollector.Enabled

Chuyển đổi khả năng nhìn thấy của `Class.LayerCollector` này.

Khi được đặt là `false` và `Class.LayerCollector` này là con trực tiếp của
`Class.StarterGui`, nó chỉ được sao chép vào `Class.PlayerGui` của mỗi người chơi một lần và sẽ không bị xóa khi nhân vật của người chơi
xuất hiện lại.

Khi được đặt là `true` (mặc định), hoặc nếu `Class.LayerCollector` này là một
con cháu **gián tiếp** của `Class.StarterGui`, nó sẽ được sao chép vào
`Class.PlayerGui` của mỗi người chơi khi nhân vật của họ xuất hiện lại và nó sẽ
xóa chính nó khi nhân vật của người chơi xuất hiện lại lần nữa.

LayerCollector.ResetOnSpawn

Xác định xem `Class.LayerCollector` có được đặt lại (xóa nó và
tạo lại vào `Class.PlayerGui` của người chơi) mỗi khi nhân vật của người chơi
xuất hiện lại hay không.

Điều khiển cách mà `Class.GuiObject.ZIndex` hoạt động trên tất cả các phần tử con của
`Class.LayerCollector`.

Với `Enum.ZIndexBehavior.Sibling` (mặc định), các phần tử con luôn được hiển thị trên
their cha, và `Class.GuiObject.ZIndex|ZIndex` được sử dụng để quyết định
t thứ tự mà các phần tử con của một đối tượng UI đơn lẻ sẽ được hiển thị chồng lên nhau.

`Enum.ZIndexBehavior.Global` sắp xếp tất cả các phần tử con theo
`Class.GuiObject.ZIndex|ZIndex`, sau đó giải quyết các trường hợp bằng cách sử dụng thứ tự
hệ thống. Do đó, các phần tử con của một `Class.GuiObject` cần có giá trị
`Class.GuiObject.ZIndex|ZIndex` ít nhất bằng với cha, nếu không chúng sẽ được hiển thị bên dưới cha của chúng.


LayerCollector.ZIndexBehavior

Điều khiển cách mà `Class.GuiObject.ZIndex` hoạt động trên tất cả các phần tử con của
`Class.LayerCollector`.


Lớp cơ sở của các container UI 2D, được sử dụng để hiển thị `Class.GuiObject|GuiObjects`
trong các lớp.

`Class.GuiBase2d` là một lớp trừu tượng được kế thừa bởi 2D
`Class.GuiObject|GuiObjects`.

Sự kiện này được kích hoạt khi việc chọn gamepad di chuyển đến, rời khỏi, hoặc thay đổi
trong `Class.GuiBase2d` kết nối hoặc bất kỳ phần tử con nào
`Class.GuiObject|GuiObjects`. Khi điểm nổi bật lựa chọn di chuyển đến một
`Class.GuiObject`, sự kiện sẽ nổi bọt từ `Class.GuiObject` đó đến tất cả các tổ tiên của nó,
thông báo cho họ rằng lựa chọn đã
thay đổi/nhập/xuất đến một `Class.GuiObject` trong cây con của họ.

GuiBase2d.SelectionChanged

amISelected

Đúng nếu lựa chọn mới khớp với GuiBase2d đính kèm.

previousSelection

`Class.GuiObject` đã được chọn trước đó trước khi
lựa chọn thay đổi, hoặc nil nếu không có gì được chọn.


newSelection

`Class.GuiObject` hiện đang được chọn sau khi lựa chọn
thay đổi, hoặc nil nếu không có gì được chọn.


Kích hoạt khi việc chọn gamepad di chuyển đến, rời khỏi, hoặc thay đổi trong
`Class.GuiBase2d` kết nối hoặc bất kỳ phần tử con nào
`Class.GuiObject|GuiObjects`.

GuiBase2d

`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` là một thuộc tính chỉ đọc
cung cấp vị trí trên màn hình của một phần tử `Class.GuiBase2d`
tính bằng pixel. Điều này đại diện cho vị trí pixel thực tế mà một phần tử
được hiển thị do kích thước và vị trí của các tổ tiên của nó. Lưu ý rằng
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` luôn đại diện cho
góc trên bên trái của phần tử `Class.GuiBase2d`.

Nếu `Class.GuiBase2d` nằm trong một `Class.ScreenGui`, thuộc tính
`Class.GuiBase2d.AbsolutePosition|AbsolutePosition` sử dụng hệ thống tọa độ
viewport `Enum.ScreenInsets|CoreUISafeInsets`. Điểm gốc của hệ thống tọa độ
này nằm ở góc dưới bên trái của thanh công cụ Roblox. Lưu ý rằng đây là
hệ thống tọa độ giống như được sử dụng bởi thuộc tính `Class.InputObject.Position`.

<img src="/assets/engine-api/classes/GuiBase2d/AbsolutePositionCoordinateSystem.png" width="840" alt="Sơ đồ cho thấy điểm gốc của hệ thống tọa độ AbsolutePosition." />

Xem thêm `Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` và
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.

GuiBase2d.AbsolutePosition

Mô tả vị trí thực tế trên màn hình của một phần tử `Class.GuiBase2d`, tính bằng
pixel.

`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation` là một thuộc tính chỉ đọc
mô tả độ xoay thực tế trên màn hình của một phần tử `Class.GuiBase2d`,
tính bằng độ. Nó **không** thực hiện kiểm tra giới hạn, vì vậy giá trị của nó
có thể không nằm trong khoảng `0` đến `360`.

Xem thêm `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` và
`Class.GuiBase2d.AbsoluteSize|AbsoluteSize`.

GuiBase2d.AbsoluteRotation

Mô tả độ xoay thực tế trên màn hình của một phần tử `Class.GuiBase2d`, tính bằng
độ.

`Class.GuiBase2d.AbsoluteSize|AbsoluteSize` là một thuộc tính chỉ đọc mô tả
kích thước thực tế trên màn hình của một phần tử `Class.GuiBase2d`, tính bằng
pixel.

Xem thêm `Class.GuiBase2d.AbsolutePosition|AbsolutePosition` và
`Class.GuiBase2d.AbsoluteRotation|AbsoluteRotation`.

GuiBase2d.AbsoluteSize

Mô tả kích thước thực tế trên màn hình của một phần tử `Class.GuiBase2d`, tính bằng
pixel.

Khi được đặt thành `true`, việc địa phương hóa sẽ được áp dụng cho `Class.GuiBase2d`
và các phần tử con của nó. Các mục được sử dụng cho việc địa phương hóa là cùng một tập hợp các
mục được trả về bởi `Class.LocalizationService:GetTableEntries()`. Các mục
có `Class.GuiBase2d.AutoLocalize|AutoLocalize` được bật sẽ tự động
được dịch lại sau khi bảng đám mây tải nếu cần thiết.

Xem thêm `Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable`.

GuiBase2d.AutoLocalize

Khi được đặt thành `true`, việc địa phương hóa sẽ được áp dụng cho `Class.GuiBase2d`
và các phần tử con của nó.

Thuộc tính này tự động được đặt thành true khi bảng địa phương hóa
`Class.LocalizationTable.Root` nhắm đến đối tượng này, hoặc một tổ tiên của đối tượng này. `Class.LocalizationTable|LocalizationTables` với thuộc tính
`Class.LocalizationTable.Root` của chúng chỉ vào một thể hiện sẽ
địa phương hóa tất cả `Class.TextLabel.TextButton` là các phần tử con của thể hiện gốc.

GuiBase2d.Localize

Tự động được đặt thành true khi bảng địa phương hóa
`Class.LocalizationTable.Root` nhắm đến đối tượng này, hoặc một tổ tiên của đối tượng này.

Một tham chiếu đến `Class.LocalizationTable` để được sử dụng để áp dụng
việc địa phương hóa tự động cho `Class.GuiBase2d` và các phần tử con của nó.
`Class.GuiBase2d.AutoLocalize|AutoLocalize` phải được đặt thành `true` trên
`Class.GuiBase2d` và các tổ tiên của nó để việc địa phương hóa tự động được
áp dụng.

Bạn có thể đặt điều này để tham chiếu đến một `Class.LocalizationTable` ở bất kỳ đâu trong
`Class.DataModel`. Đối tượng `Class.GuiBase2d` và tất cả các con của nó
sẽ cố gắng sử dụng bảng `Class.LocalizationTable` cụ thể đó và các tổ tiên của nó
để thay thế văn bản tự động trước khi sử dụng các bảng dưới
`Class.LocalizationService` theo thứ tự không xác định và bảng đám mây.

Nếu không có bản dịch nào có sẵn trong bảng được tham chiếu, nó sẽ tìm
kiếm một bản dịch trong cha của bảng đó, nếu nó cũng là một
`Class.LocalizationTable`, và cứ thế.

Xem thêm `Class.LocalizationService:GetTableEntries()` giải thích cách
`Class.GuiBase2d.RootLocalizationTable|RootLocalizationTable` được sử dụng
cho việc địa phương hóa tự động.

GuiBase2d.RootLocalizationTable

Một tham chiếu đến `Class.LocalizationTable` để được sử dụng để áp dụng
việc địa phương hóa tự động cho `Class.GuiBase2d` và các phần tử con của nó.

`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown` tùy chỉnh
cách di chuyển lựa chọn của gamepad theo hướng xuống ra khỏi một nhóm lựa chọn.
Nó chỉ có hiệu lực khi
`Class.GuiBase2d.SelectionGroup|SelectionGroup` là `true`;
`SelectionGroup` mặc định là `false`, và trong khi nó vẫn là `false`, thuộc tính này
không có hiệu lực.

Giá trị mặc định của nó là `Enum.SelectionBehavior.Escape`, ưu tiên
các nút trong nhóm lựa chọn nhưng cho phép lựa chọn di chuyển đến một
`Class.GuiObject` bên ngoài nhóm theo hướng xuống nếu không tìm thấy nút phù hợp
bên trong. Đặt nó thành `Enum.SelectionBehavior.Stop`
thay vào đó giới hạn lựa chọn trong nhóm, ngăn nó di chuyển
xuống dưới ra khỏi nhóm.

Xem thêm `Class.GuiBase2d.SelectionGroup|SelectionGroup`.


GuiBase2d.SelectionBehaviorDown

Tùy chỉnh hành vi chọn gamepad theo hướng xuống.

`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft` tùy chỉnh
cách di chuyển lựa chọn của gamepad theo hướng trái ra khỏi một nhóm lựa chọn.
Nó chỉ có hiệu lực khi
`Class.GuiBase2d.SelectionGroup|SelectionGroup` là `true`;
`SelectionGroup` mặc định là `false`, và trong khi nó vẫn là `false`, thuộc tính này
không có hiệu lực.

Giá trị mặc định của nó là `Enum.SelectionBehavior.Escape`, ưu tiên
các nút trong nhóm lựa chọn nhưng cho phép lựa chọn di chuyển đến một
`Class.GuiObject` bên ngoài nhóm theo hướng trái nếu không tìm thấy nút phù hợp
bên trong. Đặt nó thành `Enum.SelectionBehavior.Stop`
thay vào đó giới hạn lựa chọn trong nhóm, ngăn nó di chuyển
sang trái ra khỏi nhóm.

Xem thêm `Class.GuiBase2d.SelectionGroup|SelectionGroup`.


GuiBase2d.SelectionBehaviorLeft

Tùy chỉnh hành vi chọn gamepad theo hướng trái.

`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight` tùy chỉnh
cách di chuyển lựa chọn của gamepad theo hướng phải ra khỏi một nhóm lựa chọn.
Nó chỉ có hiệu lực khi
`Class.GuiBase2d.SelectionGroup|SelectionGroup` là `true`;
`SelectionGroup` mặc định là `false`, và trong khi nó vẫn là `false`, thuộc tính này
không có hiệu lực.

Giá trị mặc định của nó là `Enum.SelectionBehavior.Escape`, ưu tiên
các nút trong nhóm lựa chọn nhưng cho phép lựa chọn di chuyển đến một
`Class.GuiObject` bên ngoài nhóm theo hướng phải nếu không tìm thấy nút phù hợp
bên trong. Đặt nó thành `Enum.SelectionBehavior.Stop`
thay vào đó giới hạn lựa chọn trong nhóm, ngăn nó di chuyển
sang phải ra khỏi nhóm.

Xem thêm `Class.GuiBase2d.SelectionGroup|SelectionGroup`.


GuiBase2d.SelectionBehaviorRight

Tùy chỉnh hành vi chọn gamepad theo hướng phải.

`Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp` tùy chỉnh cách
di chuyển lựa chọn của gamepad theo hướng lên ra khỏi một nhóm lựa chọn. Nó
chỉ có hiệu lực khi `Class.GuiBase2d.SelectionGroup|SelectionGroup` là
`true`; `SelectionGroup` mặc định là `false`, và trong khi nó vẫn
`false`, thuộc tính này không có hiệu lực.

Giá trị mặc định của nó là `Enum.SelectionBehavior.Escape`, ưu tiên
các nút trong nhóm lựa chọn nhưng cho phép lựa chọn di chuyển đến một
`Class.GuiObject` bên ngoài nhóm theo hướng lên nếu không tìm thấy nút phù hợp
bên trong. Đặt nó thành `Enum.SelectionBehavior.Stop`
thay vào đó giới hạn lựa chọn trong nhóm, ngăn nó di chuyển
lên trên ra khỏi nhóm.

Xem thêm `Class.GuiBase2d.SelectionGroup|SelectionGroup`.


GuiBase2d.SelectionBehaviorUp

Tùy chỉnh hành vi chọn gamepad theo hướng lên.

Cho phép tùy chỉnh cách mà việc chọn gamepad có thể di chuyển giữa
các nút, là các phần tử con của nhóm chọn, rời khỏi nhóm,
và chọn các nút khác.

Đặt `Class.GuiBase2d.SelectionGroup|SelectionGroup` thành `true` sẽ hiển thị
các thuộc tính `Class.GuiBase2d.SelectionBehaviorUp|SelectionBehaviorUp`,
`Class.GuiBase2d.SelectionBehaviorDown|SelectionBehaviorDown`,
`Class.GuiBase2d.SelectionBehaviorLeft|SelectionBehaviorLeft`, và
`Class.GuiBase2d.SelectionBehaviorRight|SelectionBehaviorRight`.
Đối với các hành vi chọn này, một thiết lập của
`Enum.SelectionBehavior.Escape` (mặc định) có nghĩa là việc chọn gamepad
cố gắng tìm một lựa chọn trong nhóm chọn trước và chỉ di chuyển
ra ngoài nếu không tìm thấy nút phù hợp. Ngược lại, một thiết lập của
`Enum.SelectionBehavior.Stop` có nghĩa là việc chọn gamepad chỉ tìm kiếm trong
nhóm chọn và không di chuyển ra ngoài nhóm từ hướng hành vi chọn.

GuiBase2d.SelectionGroup

Cho phép tùy chỉnh chuyển động chọn gamepad.

Một lớp trừu tượng được kế thừa bởi 2D `Class.GuiObject|GuiObjects`.

GuiBase là một lớp trừu tượng mà hầu hết các đối tượng giao diện người dùng đồ họa
kế thừa từ nó.


GuiBase

`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp của Roblox
có thể là một phần của cây `Class.DataModel`.

Không thể tạo trực tiếp các đối tượng `Instance` gốc, nhưng hàm khởi tạo đặc biệt
`Datatype.Instance.new()` tạo ra các đối tượng thông qua mã, nhận tên của lớp như một tham số và trả về đối tượng đã tạo.


Minh họa việc phát hiện các thay đổi trong tổ tiên của một thể hiện bằng cách kết nối với sự kiện
`Class.Instance.AncestryChanged`.

Cha của ChangingPart được thiết lập với các giá trị khác nhau theo thời gian. Cha của
phần đó là tổ tiên của phần đó, vì vậy sự kiện `Class.Instance.AncestryChanged` sẽ được kích hoạt
mỗi khi nó thay đổi.

Kích hoạt khi thể hiện này được thay đổi cha hoặc khi bất kỳ tổ tiên nào của nó được
thay đổi cha.

Bạn có thể sử dụng sự kiện này để theo dõi việc xóa một thể hiện trong Studio,
hay xóa thủ công trong Explorer hoặc thông qua một plugin. Nếu bạn cần
tìm khi một thể hiện bị xóa bằng `Class.Instance:Destroy()`,
sử dụng sự kiện `Class.Instance.Destroying` thay vào đó.


Instance.AncestryChanged

child

Thể hiện mà thuộc tính `Class.Instance.Parent|Parent` đã thay đổi,
điều này có thể là thể hiện này hoặc một tổ tiên xa hơn, **không**
nhất thiết là thể hiện mà trình xử lý được kết nối.


parent

Kích hoạt khi thuộc tính `Class.Instance.Parent` của đối tượng này hoặc một trong
các tổ tiên của nó bị thay đổi.


Sự kiện này kích hoạt bất cứ khi nào bất kỳ thuộc tính nào được thay đổi trên thể hiện,
bao gồm khi một thuộc tính được đặt thành `nil`. Tên của thuộc tính đã thay đổi
được truyền đến hàm đã kết nối.

Ví dụ, đoạn mã sau kết nối hàm `attributeChanged()`
để kích hoạt bất cứ khi nào một trong các thuộc tính của phần thay đổi:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "đã thay đổi")
end

part.AttributeChanged:Connect(attributeChanged)
```
Xem thêm `Class.Instance:GetAttributeChangedSignal()` trả về một
sự kiện kích hoạt khi một thuộc tính cụ thể đã cho thay đổi.


Instance.AttributeChanged

attribute

Tên của thuộc tính đã được thay đổi.


Kích hoạt bất cứ khi nào một thuộc tính được thay đổi trên `Class.Instance`.


Đoạn mã này in tên của các đối tượng khi chúng được thêm vào Workspace:


Kích hoạt sau khi một đối tượng được gán làm con của `Class.Instance`.

Lưu ý, khi sử dụng phương thức này trên một khách hàng để phát hiện các đối tượng được tạo bởi máy chủ,
cần phải sử dụng `Class.Instance:WaitForChild()` khi chỉ mục các con của đối tượng này. Điều này là do đối tượng và các con của nó không được đảm bảo sẽ nhân bản từ máy chủ đến khách hàng
đồng thời. Ví dụ:

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- Sử dụng WaitForChild() vì các con có thể chưa được nhân bản
	local head = child:WaitForChild("Head")
end)
```
Lưu ý, sự kiện này chỉ hoạt động cho các con ngay lập tức của `Class.Instance`. Để có một sự kiện
bắt tất cả các con cháu, sử dụng `Class.Instance.DescendantAdded`.

Xem thêm `Class.Instance.ChildRemoved`.


Instance.ChildAdded

Thể hiện `Class.Instance` đã được thêm vào.


Kích hoạt sau khi một đối tượng được gán làm con của `Class.Instance`.


Instance.childAdded

Đoạn mã này in tên của các đối tượng khi chúng bị xóa khỏi
Workspace:


Kích hoạt sau khi một con được xóa khỏi `Class.Instance`.

Bị xóa đề cập đến khi cha của một đối tượng được thay đổi từ `Class.Instance`
sang một thứ khác ngoài `Class.Instance`. Lưu ý, sự kiện này cũng sẽ kích hoạt khi một con bị xóa (sử dụng
`Class.Instance:Destroy()`) vì hàm xóa đặt cha của một đối tượng thành `nil`.

Sự kiện này chỉ hoạt động cho các con ngay lập tức của `Class.Instance`.
Để có một sự kiện bắt tất cả các con cháu, sử dụng
`Class.Instance.DescendantRemoving`.

Xem thêm `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Thể hiện `Class.Instance` đã bị xóa.


Kích hoạt sau khi một con được xóa khỏi `Class.Instance`.


Ví dụ sau đây sẽ in ra tên của bất kỳ đối tượng nào được thêm vào
Workspace:

Sự kiện này kích hoạt sau khi một con cháu được thêm vào `Class.Instance`.

Vì nó kích hoạt cho mỗi con cháu, việc gán một đối tượng vào
`Class.Instance` sẽ kích hoạt sự kiện cho đối tượng này và tất cả các con cháu của nó một cách riêng biệt.

Nếu bạn chỉ quan tâm đến **các con trực tiếp** của `Class.Instance`, hãy sử dụng `Class.Instance.ChildAdded` thay vào đó.

Xem thêm `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Kích hoạt sau khi một con cháu được thêm vào `Class.Instance`.


Ví dụ sau in tên của bất kỳ đối tượng con nào khi nó đang được gỡ ra
khỏi Workspace:

Sự kiện này kích hoạt **ngay trước khi** cha `Class.Instance`
thay đổi sao cho một thể hiện **con cháu** sẽ không còn là một
con cháu nữa. `Class.Instance:Destroy()|Destroy()` thay đổi `Class.Instance.Parent|Parent` của một thể hiện thành `nil`, vì vậy việc gọi phương thức đó trên một con cháu của cha sẽ khiến sự kiện này kích hoạt.

Vì sự kiện này kích hoạt **trước khi** con cháu bị xóa, cha của
con cháu sẽ không thay đổi tại thời điểm sự kiện này kích hoạt. Nếu con cháu cũng là một **con trực tiếp** của cha, sự kiện này sẽ kích hoạt
trước `Class.Instance.ChildRemoved`.

Nếu một con cháu có các con, sự kiện này sẽ kích hoạt với con cháu trước,
điều đó theo sau là các con cháu của nó.

#### Cảnh báo

Sự kiện này kích hoạt với đối tượng con cháu đang bị xóa.
Cố gắng đặt `Class.Instance.Parent|Parent` của con cháu thành
một thứ khác sẽ thất bại. Dưới đây là một ví dụ minh họa điều này:

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- Không thao tác với cha của con cháu trong hàm này!
	-- Sự kiện này kích hoạt BỞI vì cha đã được thao tác, và sự thay đổi chưa xảy ra
	-- Do đó, việc thay đổi cha như thế này là vấn đề:
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```
Xem thêm `Class.Instance.DescendantAdded|DescendantAdded`.


Instance.DescendantRemoving

Thể hiện `Class.Instance` đang bị xóa.


Kích hoạt ngay trước khi một con cháu của `Class.Instance` bị xóa.


Mẫu này minh họa cách mà, khi sử dụng hành vi tín hiệu Ngay lập tức, một
Instance đang bị xóa vẫn giữ nguyên vị trí cho đến khi hàm kết nối tạm dừng.

Ví dụ này cho thấy cách mà, khi sử dụng hành vi tín hiệu Deferred, một Instance
được xóa trước khi tín hiệu được phát.

Thể hiện `Class.Instance` sẽ không bao giờ bị xóa khỏi bộ nhớ trong khi một hàm đã kết nối
vẫn đang sử dụng nó. Tuy nhiên, nếu hàm đó chờ tại bất kỳ thời điểm nào,
`Class.Instance` và các con cháu của nó sẽ được gán thành `nil`.

Nếu thuộc tính `Class.Workspace.SignalBehavior` được đặt thành
`Enum.SignalBehavior.Immediate`, sự kiện này sẽ kích hoạt ngay trước khi
`Class.Instance` hoặc một trong các tổ tiên của nó bị xóa bằng
`Class.Instance:Destroy()`.

Nếu thuộc tính `Class.Workspace.SignalBehavior` được đặt thành
`Enum.SignalBehavior.Deferred`, sự kiện này sẽ kích hoạt tại điểm tiếp tục tiếp theo,
điều này sẽ xảy ra sau khi `Class.Instance` hoặc một trong các tổ tiên của nó bị
xóa bằng `Class.Instance:Destroy()`.

Với hành vi `Enum.SignalBehavior.Deferred|Deferred`, việc kết nối một kịch bản
với sự kiện `Class.Instance.Destroying` của chính nó là vấn đề, vì kịch bản
sẽ bị xóa trước khi callback có thể được gọi (có nghĩa là nó sẽ không
thực thi).

Khi xóa một `Class.Instance` trong Studio, chẳng hạn như xóa thủ công
thông qua [Explorer](/studio/explorer) hoặc thông qua một plugin,
`Class.Instance` không bị xóa. Thay vào đó, cha được đặt thành `nil`
điều này bạn có thể theo dõi với `Class.Instance.AncestryChanged`.


Instance.Destroying

Kích hoạt ngay trước (hoặc bị hoãn đến sau) khi thể hiện bị
xóa thông qua `Class.Instance:Destroy()`.


Minh họa `Class.Instance.StyledPropertiesChanged`.


Sự kiện này kích hoạt bất cứ khi nào bất kỳ thuộc tính kiểu dáng nào được thay đổi trên thể hiện,
bao gồm khi một thuộc tính được đặt thành `nil`.


Instance.StyledPropertiesChanged

Kích hoạt bất cứ khi nào bất kỳ thuộc tính kiểu dáng nào được thay đổi trên thể hiện,
bao gồm khi một thuộc tính được đặt thành `nil`.


Phương thức này áp dụng một thẻ cho đối tượng, không có hiệu lực nếu thẻ đã
được áp dụng. Việc thêm thẻ thành công sẽ kích hoạt một tín hiệu được tạo bởi
`Class.CollectionService:GetInstanceAddedSignal()` với thẻ đã cho.

#### Cảnh báo

- Các thẻ của một đối tượng đã được thêm từ phía khách hàng sẽ bị loại bỏ nếu máy chủ
  sau đó thêm hoặc xóa một thẻ trên đối tượng đó vì máy chủ
  nhân bản tất cả các thẻ cùng nhau và ghi đè lên các thẻ trước đó.

- Khi gán thẻ cho một đối tượng, thường có một số tài nguyên được sử dụng để
  cung cấp chức năng cho thẻ, chẳng hạn như kết nối sự kiện hoặc bảng. Để ngăn ngừa rò rỉ bộ nhớ, tốt nhất là dọn dẹp chúng (ngắt kết nối,
  đặt thành `nil`, v.v.) khi không còn cần thiết cho một thẻ. Thực hiện điều này khi
  gọi `Class.Instance:RemoveTag()`, gọi
  `Class.Instance:Destroy()`, hoặc trong một hàm được kết nối với một tín hiệu
  được trả về bởi `Class.CollectionService:GetInstanceRemovedSignal()`.


Instance:AddTag

Thẻ để áp dụng cho đối tượng.


Áp dụng một thẻ cho đối tượng.


Hàm con trả về một mảng các con của đối tượng.


Instance:children

Trả về một mảng các con của đối tượng.


Phương thức này hủy tất cả các con và hậu duệ của một đối tượng.

```
local part = Instance.new("Part")

-- Thêm một số ánh sáng lấp lánh
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
Nếu bạn không muốn hủy **tất cả** các con và hậu duệ, hãy sử dụng
`Class.Instance:GetChildren()` hoặc `Class.Instance:GetDescendants()` để
lặp qua các con/hậu duệ đó và chọn những gì cần hủy. Ví dụ, đoạn mã sau sẽ hủy tất cả
`Class.BasePart|BaseParts` từ một `Class.Model`:

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

Phương thức này hủy tất cả các con của một đối tượng.


Minh họa việc nhân bản một mô hình bằng cách sử dụng `Class.Instance:Clone()`.


`Clone()` tạo một bản sao của một đối tượng và tất cả các hậu duệ của nó,
bỏ qua tất cả các đối tượng không phải là
`Class.Instance.Archivable|Archivable`. Bản sao của đối tượng gốc được
trả về bởi phương thức này và `Class.Instance.Parent|Parent` của nó được đặt thành
`nil`. Lưu ý rằng nếu chính đối tượng có
`Class.Instance.Archivable|Archivable` được đặt thành `false`, phương thức này sẽ
trả về `nil`.

Nếu một thuộc tính tham chiếu như `Class.ObjectValue.Value` được đặt trong một
đối tượng đã được sao chép, giá trị của thuộc tính của bản sao phụ thuộc vào
giá trị của bản gốc:

- Nếu một thuộc tính tham chiếu tham chiếu đến một đối tượng cũng được sao chép,
  bản sao sẽ tham chiếu đến bản sao.
- Nếu một thuộc tính tham chiếu tham chiếu đến một đối tượng không được sao chép,
  giá trị giống nhau được duy trì trong bản sao.


Instance:Clone

Một bản sao của đối tượng, hoặc `nil` nếu đối tượng không phải là
`Class.Instance.Archivable|Archivable`.


Tạo một bản sao của một đối tượng và tất cả các hậu duệ của nó, bỏ qua các đối tượng
không phải là `Class.Instance.Archivable|Archivable`.


Instance:clone

Minh họa việc phá hủy một Part bằng cách sử dụng hàm `Class.Instance:Destroy()`.

Hàm này là cách đúng để giải phóng các đối tượng không còn cần thiết.

Đặt thuộc tính `Class.Instance.Parent` thành `nil`, khóa thuộc tính
`Class.Instance.Parent`, ngắt kết nối tất cả các kết nối, và gọi
`Destroy()` trên tất cả các con. Phương thức này là cách đúng để loại bỏ
các đối tượng không còn cần thiết.

Việc loại bỏ các đối tượng không cần thiết là quan trọng, vì các đối tượng và
kết nối không cần thiết trong một nơi sử dụng bộ nhớ có thể dẫn đến các vấn đề hiệu suất nghiêm trọng theo thời gian.

Như một thực tiễn tốt nhất sau khi gọi `Destroy()` trên một đối tượng, hãy đặt bất kỳ
biến nào tham chiếu đến đối tượng (hoặc các hậu duệ của nó) thành `nil`. Điều này
ngăn chặn mã của bạn truy cập bất kỳ điều gì liên quan đến đối tượng.

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- Đừng làm điều này:
print(part.Name)  --> "Hello, world"
-- Làm điều này để ngăn dòng trên hoạt động:
part = nil
```
Khi một `Class.Instance` đã bị hủy bởi phương thức này, nó không thể được
sử dụng lại vì thuộc tính `Class.Instance.Parent` đã bị khóa. Để
**tạm thời** loại bỏ một đối tượng thay vì hủy nó, hãy đặt
`Class.Instance.Parent|Parent` thành `nil`. Ví dụ:

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
Để hủy một đối tượng sau một khoảng thời gian nhất định, hãy sử dụng
`Class.Debris:AddItem()`.


Instance:Destroy

Đặt thuộc tính `Class.Instance.Parent` thành `nil`, khóa thuộc tính
`Class.Instance.Parent`, ngắt kết nối tất cả các kết nối, và gọi
`Destroy()` trên tất cả các con.


Instance:destroy

Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Instance.Name` bằng với tên đã cho.

Phương thức này hoạt động theo chiều lên, có nghĩa là nó bắt đầu từ `Class.Instance.Parent`
ngay lập tức của đối tượng và làm việc lên đến `Class.DataModel`. Nếu không tìm thấy tổ tiên phù hợp, nó trả về `nil`.

Đoạn mã sau sẽ tìm tổ tiên đầu tiên của đối tượng có tên là `Car`.

```
local car = object:FindFirstAncestor("Car")
```
Đối với các biến thể của phương thức này tìm tổ tiên của một lớp cụ thể,
xin vui lòng xem `Class.Instance:FindFirstAncestorOfClass()` và
`Class.Instance:FindFirstAncestorWhichIsA()`.


Instance:FindFirstAncestor

name

Đối tượng `Class.Instance` được tìm thấy.


Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Instance.Name` bằng với tên đã cho.


Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Object.ClassName` bằng với className đã cho.

Phương thức này hoạt động theo chiều lên, có nghĩa là nó bắt đầu từ `Class.Instance.Parent`
ngay lập tức của đối tượng và làm việc lên đến `Class.DataModel`. Nếu không tìm thấy tổ tiên phù hợp, nó trả về `nil`.

Một cách sử dụng phổ biến của phương thức này là tìm `Class.Model` mà một
`Class.BasePart` thuộc về. Ví dụ:

```
local model = part:FindFirstAncestorOfClass("Model")
```
Phương thức này là một biến thể của `Class.Instance:FindFirstAncestor()` mà
kiểm tra thuộc tính `Class.Object.ClassName` thay vì
`Class.Instance.Name`. `Class.Instance:FindFirstAncestorWhichIsA()` cũng
tồn tại, sử dụng phương thức `Class.Object:IsA()` thay vào đó để tôn trọng
kế thừa lớp.


Instance:FindFirstAncestorOfClass

className

Tên `Class.Object.ClassName` cần tìm.


Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Object.ClassName` bằng với className đã cho.


Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về true cho className đã cho.

Phương thức này hoạt động theo chiều lên, có nghĩa là nó bắt đầu từ `Class.Instance.Parent`
ngay lập tức của đối tượng và làm việc lên đến `Class.DataModel`. Nếu không tìm thấy tổ tiên phù hợp, nó trả về `nil`.

Khác với `Class.Instance:FindFirstAncestorOfClass()`, phương thức này sử dụng
`Class.Object:IsA()` tôn trọng kế thừa lớp. Ví dụ:

```
print(part:IsA("Part"))  --> true
print(part:IsA("BasePart"))  --> true
print(part:IsA("Instance"))  --> true
```
Do đó, đoạn mã sau sẽ trả về tổ tiên đầu tiên là `Class.BasePart`,
không quan tâm đến việc nó là `Class.WedgePart`,
`Class.MeshPart` hay `Class.Part`.

```
local part = object:FindFirstAncestorWhichIsA("BasePart")
```
Xem thêm `Class.Instance:FindFirstAncestor()`.


Instance:FindFirstAncestorWhichIsA

Trả về tổ tiên đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về true cho className đã cho.


Phía dưới sẽ tìm kiếm trong Workspace cho một đối tượng có tên là "Brick". Nếu tìm thấy, nó
sẽ thay đổi tên của đối tượng thành "Foo".

Trả về con đầu tiên của `Class.Instance` với tên đã cho, hoặc
`nil` nếu không có con nào như vậy tồn tại. Nếu tham số tùy chọn `recursive` là
`true`, phương thức này tìm kiếm tất cả các hậu duệ thay vì chỉ các con ngay lập tức của `Class.Instance`.

#### Kiểm tra sự tồn tại của một đối tượng

`FindFirstChild()` là cần thiết nếu bạn cần xác minh một đối tượng tồn tại
trước khi tiếp tục. Cố gắng chỉ mục một con theo tên bằng toán tử chấm sẽ gây ra lỗi nếu con không tồn tại.

```lua
local Workspace = game:GetService("Workspace")

-- Dòng sau sẽ gây lỗi nếu phần không tồn tại trong không gian làm việc
Workspace.Part.Transparency = 0.5
```
Một cách tiếp cận tốt hơn là sử dụng `FindFirstChild()` để trước tiên kiểm tra `Part`,
rồi sử dụng một câu lệnh `if` để chạy mã cần nó.

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace:FindFirstChild("Part")
if part then
	part.Transparency = 0.5
end
```

#### Tìm một con có tên khớp với một thuộc tính

Đôi khi `Class.Instance.Name|Name` của một đối tượng giống như tên của một
thuộc tính của `Class.Instance.Parent|Parent` của nó. Khi sử dụng toán tử chấm,
thuộc tính sẽ ưu tiên hơn các con nếu chúng chia sẻ cùng một tên.

Trong ví dụ sau, một `Class.Folder` có tên là `Color` được thêm vào một
`Class.Part`, mà cũng có thuộc tính `Class.Part.Color`. Lưu ý rằng
`part.Color` tham chiếu đến giá trị thuộc tính `Datatype.Color3`, không phải là con
`Class.Folder` instance. Một lợi ích của việc sử dụng
`Class.Instance:FindFirstChild()|FindFirstChild()` là việc giới thiệu các thuộc tính mới không gây rủi ro cho mã của bạn.

```lua
local part = Instance.new("Part")
local folder = Instance.new("Folder")
folder.Name = "Color"
folder.Parent = part
local c1 = part.Color  -- Thuộc tính
local c2 = part:FindFirstChild("Color")  -- Thư mục con
```

#### Ghi chú về hiệu suất

`Class.Instance:FindFirstChild()|FindFirstChild()` mất khoảng 20% thời gian hơn
so với việc sử dụng toán tử chấm và gần 8 lần lâu hơn so với việc chỉ đơn giản lưu trữ
một tham chiếu đến một đối tượng. Do đó, bạn nên tránh gọi nó trong
mã phụ thuộc vào hiệu suất như trong các vòng lặp chặt chẽ hoặc các hàm được kết nối với
`Class.RunService.Heartbeat` và `Class.RunService.PreRender`. Thay vào đó,
hãy lưu kết quả vào một biến, hoặc xem xét sử dụng
`Class.Instance.ChildAdded|ChildAdded` hoặc
`Class.Instance:WaitForChild()|WaitForChild()` để phát hiện khi một con có tên cho trước trở nên khả dụng.


Instance:FindFirstChild

recursive

Có nên thực hiện tìm kiếm đệ quy hay không.


Trả về con đầu tiên của `Class.Instance` được tìm thấy với tên đã cho.


Instance:findFirstChild

Trả về con đầu tiên của `Class.Instance` mà
`Class.Object.ClassName|ClassName` bằng với `className` đã cho.
Khác với `Class.Instance:FindFirstChildWhichIsA()`, phương thức này chỉ trả về
các đối tượng mà lớp của chúng khớp với `className`, bỏ qua kế thừa lớp. Nếu không tìm thấy
con nào khớp, phương thức này trả về `nil`.


Instance:FindFirstChildOfClass

Trả về con đầu tiên của `Class.Instance` mà
`Class.Object.ClassName|ClassName` bằng với tên lớp đã cho.


Trả về con đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về true cho className đã cho.

Nếu không tìm thấy con nào khớp, phương thức này trả về `nil`. Nếu tham số
tùy chọn đệ quy là true, phương thức này tìm kiếm tất cả các hậu duệ thay vì chỉ các con ngay lập tức của `Class.Instance`.

Khác với `Class.Instance:FindFirstChildOfClass()`, phương thức này sử dụng
`Class.Object:IsA()` tôn trọng kế thừa lớp. Ví dụ:

```lua
print(part:IsA("Part")) --> true
print(part:IsA("BasePart")) --> true
print(part:IsA("Instance")) --> true
```
Do đó, đoạn mã sau sẽ trả về con đầu tiên là `Class.BasePart`,
không quan tâm đến việc nó là `Class.WedgePart`,
`Class.MeshPart` hay `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Các nhà phát triển tìm kiếm một con theo tên, nên sử dụng
`Class.Instance:FindFirstChild()` thay vì.


Instance:FindFirstChildWhichIsA

Trả về con đầu tiên của `Class.Instance` mà
`Class.Object:IsA()` trả về true cho className đã cho.


Trả về hậu duệ đầu tiên được tìm thấy với `Class.Instance.Name` đã cho.

Phương thức này đã bị vô hiệu hóa và không thể sử dụng. Để tìm hậu duệ đầu tiên
của một đối tượng, hãy xem xét sử dụng tham số `recursive` trên
`Class.Instance:FindFirstChild()` thay thế.


Instance:FindFirstDescendant

Trả về hậu duệ đầu tiên được tìm thấy với `Class.Instance.Name` đã cho.


Nếu `Class.Instance` là một `Class.Actor`, chính `Class.Actor` sẽ
được trả về. Nếu không, tổ tiên gần nhất của nó là `Class.Actor` sẽ được trả về. Nếu không
có tổ tiên nào là `Class.Actor`, kết quả là `nil`.


Instance:GetActor

Đối tượng `Class.Actor` được tìm thấy.


Trả về `Class.Actor` liên kết với Instance, nếu có.


Phương thức này trả về giá trị đã được gán cho tên thuộc tính đã cho. Nếu không có thuộc tính nào được gán, `nil` sẽ được trả về.

Ví dụ, đoạn mã sau thiết lập và sau đó lấy giá trị của thuộc tính `InitialPosition` của đối tượng:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local initialPosition = instance:GetAttribute("InitialPosition")
print(initialPosition)
```

#### Xem thêm

- `Class.Instance:SetAttribute()` thiết lập thuộc tính với tên đã cho thành giá trị đã cho.
- `Class.Instance:GetAttributes()` trả về một từ điển các cặp khóa-giá trị cho mỗi thuộc tính của đối tượng.


Instance:GetAttribute

Tên của thuộc tính đang được truy xuất.


Giá trị đã được gán cho tên thuộc tính đã cho. Nếu không có
thuộc tính nào được gán, `nil` sẽ được trả về.


Trả về giá trị đã được gán cho tên thuộc tính đã cho.


Phương thức này trả về một sự kiện hoạt động giống hệt như sự kiện
`Class.Object.Changed|Changed`, ngoại trừ việc nó chỉ được kích hoạt khi thuộc tính
đã cho thay đổi; thực tế nó tương tự như
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` nhưng
cho các thuộc tính.

Thông thường, tốt hơn là sử dụng phương thức này thay vì kết nối với
`Class.Object.Changed|Changed` với một hàm kiểm tra tên thuộc tính. Các cuộc gọi tiếp theo đến phương thức này trên cùng một đối tượng với cùng một
tên thuộc tính sẽ trả về cùng một sự kiện.

Đoạn mã sau trả về một tín hiệu kích hoạt hàm
`attributeChanged()` khi thuộc tính `InitialPosition` của phần thay đổi:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)

local function attributeChanged()
	print("Thuộc tính đã thay đổi")
end

part:GetAttributeChangedSignal("InitialPosition"):Connect(attributeChanged)
```
Xem thêm `Class.Instance.AttributeChanged` được kích hoạt bất cứ khi nào bất kỳ
thuộc tính nào thay đổi trên đối tượng.


Instance:GetAttributeChangedSignal

Tên của thuộc tính cụ thể mà tín hiệu thay đổi đang được trả về.


Một sự kiện được kích hoạt khi thuộc tính đã cho thay đổi.


Trả về một sự kiện được kích hoạt khi thuộc tính đã cho thay đổi.


Phương thức này trả về một từ điển các cặp khóa-giá trị cho mỗi thuộc tính
nơi khóa là tên thuộc tính và giá trị là một giá trị không phải `nil`.

Ví dụ, đoạn mã sau xuất ra các thuộc tính và giá trị của một đối tượng:

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part
part:SetAttribute("InitialPosition", part.Position)
part:SetAttribute("CanUse", true)

for name, value in part:GetAttributes() do
	print(name .. " = " .. value)
end
```
Xem thêm `Class.Instance:GetAttribute()` trả về giá trị đã được gán cho tên thuộc tính đã cho.


Instance:GetAttributes

Một từ điển các cặp chuỗi → biến thể cho mỗi thuộc tính nơi
chuỗi là tên của thuộc tính và biến thể là một giá trị không phải nil.


Trả về một từ điển các thuộc tính của đối tượng.


Dưới đây sẽ in tên của tất cả các đối tượng hiện tại trong Workspace khi chạy.

Trả về một mảng (một bảng chỉ mục số) chứa tất cả các con trực tiếp của đối tượng,
hoặc mọi `Class.Instance` mà `Class.Instance.Parent|Parent` của nó bằng với đối tượng. Mảng có thể được lặp qua bằng cách sử dụng vòng lặp số hoặc vòng lặp tổng quát:

```lua
local Workspace = game:GetService("Workspace")

-- Ví dụ vòng lặp số
local children = Workspace:GetChildren()
for i = 1, #children do
	local child = children[i]
	print(child.Name .. " là con số " .. i)
end
```

```lua
local Workspace = game:GetService("Workspace")

-- Ví dụ vòng lặp tổng quát
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " là con số " .. i)
end
```
Lưu ý rằng mảng trả về **không** được sắp xếp theo bất kỳ thứ tự nào, vì vậy
sắp xếp thủ công (ví dụ sử dụng `Library.table.sort()`) được khuyến nghị cho
việc sắp xếp các con được trả về bởi phương thức này.

Xem thêm phương thức `Class.Instance:GetDescendants()|GetDescendants()`.


Instance:GetChildren

Một mảng chứa các con của đối tượng.


Trả về một mảng chứa tất cả các con của đối tượng.


Instance:getChildren

Trả về một chuỗi mã hóa của ID gỡ lỗi được sử dụng nội bộ bởi Roblox. Lưu ý rằng:

- Mục này được bảo vệ. Cố gắng sử dụng nó trong một `Class.Script` hoặc
  `Class.LocalScript` sẽ gây ra lỗi.
- Một ID gỡ lỗi là một ID được sử dụng trong các quy trình gỡ lỗi. Nó cho phép một trình gỡ lỗi đọc từng lệnh trước khi ứng dụng xử lý nó. Tất cả các đối tượng trong
  Roblox hoạt động như các quy trình và mỗi lệnh chạy (hoặc 'mã') có thể
  được gỡ lỗi nếu cần.
- Điều này có thể hữu ích cho các plugin cần phân biệt các đối tượng tương tự
  với nhau (chẳng hạn như các đối tượng có cùng tên).


Instance:GetDebugId

scopeLength

Trả về một chuỗi mã hóa của ID gỡ lỗi được sử dụng nội bộ bởi Roblox.


GetDescendants thường được sử dụng để thực hiện một thao tác trên tất cả các hậu duệ là một
loại đối tượng cụ thể. Đoạn mã trong ví dụ này sử dụng GetDescendants và
`Class.Instance:IsA()` để tìm tất cả các phần trong workspace và đổi
them thành màu xanh lá cây.

Phương thức đối tượng này trả về một mảng chứa tất cả các hậu duệ
của đối tượng đó. Khác với `Class.Instance:GetChildren()`, chỉ trả về
các con ngay lập tức của một đối tượng, phương thức này tìm mọi con của đối tượng,
mọi con của các con đó, và cứ thế.

Lưu ý rằng mảng trả về **không** được sắp xếp theo bất kỳ thứ tự nào, vì vậy
sắp xếp thủ công (ví dụ sử dụng `Library.table.sort()`) được khuyến nghị cho
việc sắp xếp các hậu duệ được trả về bởi phương thức này. Cũng xem xét phương thức
`Class.Instance:QueryDescendants()|QueryDescendants()` để truy vấn
các hậu duệ bằng cách kết hợp các bộ chọn và tổ hợp.


Instance:GetDescendants

Trả về một mảng chứa tất cả các hậu duệ của đối tượng.


Instance

`Instance` là lớp cơ sở cho tất cả các lớp trong hệ thống lớp của Roblox
có thể là một phần của cây `Class.DataModel`.


Tóm tắt