Hàm callback được sử dụng để phản ứng với các sự kiện của AdGui.


AdGui.OnAdEvent

eventInfo

Bảng tùy chọn cho phương thức:

- `PlayerId` – ID người dùng của người chơi có liên quan đến sự kiện quảng cáo.
- `AdEventType` – Một giá trị enum `Enum.AdEventType` mô tả các sự kiện của AdGui
  .


Liệu hàm callback đã phản ứng thành công với sự kiện hay chưa.


Sử dụng để phản ứng với các sự kiện của AdGui.


AdGui

AdGui.AdShape

Thuộc tính này cho phép AdGui phục vụ quảng cáo video.


AdGui.EnableVideoAds

Cho phép AdGui phục vụ quảng cáo video.


AdGui.FallbackImage

AdGui.Status

SurfaceGuiBase

Thuộc tính này xác định xem `Class.SurfaceGui` có nhận được đầu vào hay không,
ví dụ nếu phần cha hoặc `Class.SurfaceGuiBase.Adornee|Adornee`
chứa một lớp `Class.ClickDetector` như `Class.DragDetector`.

Lưu ý rằng các phần tử UI tương tác như `Class.ImageButton|ImageButtons`
và `Class.TextButton|TextButtons` bên trong `Class.SurfaceGui` chỉ nhận
được đầu vào của người dùng nếu chúng được gán làm phần tử cha cho
`Class.PlayerGui` (thuộc tính `Class.SurfaceGui.Adorneee` có thể được sử dụng
để nhắm đến một phần trong thế giới 3D trong khi `Class.SurfaceGui`
vẫn nằm trong `Class.PlayerGui`). Ngoài ra, thuộc tính
`Class.BasePart.CanQuery|CanQuery` của phần đó phải là `true` để
element UI tương tác nhận được đầu vào.


SurfaceGuiBase.Active

`Class.BasePart` mà áp dụng `Class.SurfaceGui`, ghi đè liên kết cha mặc định.


SurfaceGuiBase.Adornee

`Enum.NormalId` mặt của cha `Class.SurfaceGui` (hoặc `Class.SurfaceGuiBase.Adornee|Adornee`)
trên đó áp dụng `Class.SurfaceGui`.


SurfaceGuiBase.Face

`Enum.NormalId` mặt trên đó áp dụng `Class.SurfaceGui`.


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

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

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


LayerCollector:GetLayoutNodeTree

LayerCollector

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


LayerCollector.Enabled

Bật/tắt khả năng hiển thị của `Class.LayerCollector` này.


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

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


LayerCollector.ResetOnSpawn

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


Kiểm soát cách `Class.GuiObject.ZIndex` hoạt động trên tất cả các con của `Class.LayerCollector` này.

Với `Enum.ZIndexBehavior.Sibling` (mặc định), các con luôn render ở trên
các bậc phụ huynh của chúng, và `Class.GuiObject.ZIndex|ZIndex` được sử dụng để quyết định
trình tự mà các con của một đối tượng UI đơn sẽ render chồng lên nhau.

`Enum.ZIndexBehavior.Global` sắp xếp tất cả các con theo `Class.GuiObject.ZIndex|ZIndex`, sau đó giải quyết các mối liên hệ bằng cách sử dụng thứ tự phân cấp.
Kết quả là, các con của một `Class.GuiObject` cần có giá trị `Class.GuiObject.ZIndex|ZIndex` ít nhất cao như
bậc phụ huynh của chúng, hoặc chúng sẽ render bên dưới bậc phụ huynh của chúng.


LayerCollector.ZIndexBehavior

Kiểm soát cách `Class.GuiObject.ZIndex` hoạt động trên tất cả các con
của `Class.LayerCollector` này.


Lớp cơ sở của các container UI 2D mà render `Class.GuiObject|GuiObjects`
theo tầng.


`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 lựa của gamepad di chuyển đến, rời khỏi, hoặc thay đổi
trong `Class.GuiBase2d` được 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 chọn lựa 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 sự chọn lựa đã
thay đổi/nhập vào/rời khỏi một `Class.GuiObject` trong cây con của chúng.


GuiBase2d.SelectionChanged

amISelected

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


previousSelection

newSelection

Kích hoạt khi việc chọn lựa của gamepad di chuyển đến, rời khỏi, hoặc thay đổi trong
`Class.GuiBase2d` được 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ệ tọa độ
`Enum.ScreenInsets|CoreUISafeInsets` của cửa sổ xem. Gốc của hệ 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ệ tọa độ đượ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="Biểu đồ cho thấy gốc của hệ tọa độ AbsolutePosition." />

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


GuiBase2d.AbsolutePosition

Mô tả vị trí trên màn hình thực tế 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ả hướng xoay màn hình thực tế 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, do đó giá trị của nó
có thể không nằm trong khoảng từ `0` đến `360`.

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


GuiBase2d.AbsoluteRotation

Mô tả hướng xoay màn hình thực tế 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 màn hình thực tế 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 màn hình thực tế 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 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 lại nếu cần.

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 được tự động đặt thành true khi một 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` chỉ đến 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 một 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 một `Class.LocalizationTable` sẽ đượ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 `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 một thứ tự không xác định và bảng đám mây.

Nếu không có bản dịch nào khả dụng trong bảng được tham chiếu, nó sẽ tìm
một bản dịch trong phần tử cha của bảng đó, nếu nó cũng là một
`Class.LocalizationTable`, và tiếp tục như vậy.

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 một `Class.LocalizationTable` sẽ đượ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ó.


Tùy chỉnh hành vi chọn lựa của gamepad theo hướng xuống.


GuiBase2d.SelectionBehaviorDown

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


GuiBase2d.SelectionBehaviorLeft

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


GuiBase2d.SelectionBehaviorRight

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


GuiBase2d.SelectionBehaviorUp

Cho phép tùy chỉnh cách mà việc chọn lựa 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 lựa, rời khỏi nhóm,
và chọn các nút khác.

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


GuiBase2d.SelectionGroup

Cho phép tùy chỉnh chuyển động chọn lựa của gamepad.


Một lớp trừu tượng được kế thừa bởi `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ừ.


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 các đối tượng `Instance` gốc trực tiếp, 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ã, lấy tên của lớp làm tham số
và trả về đối tượng đã tạo.


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

Parent của ChangingPart được đặt thành các giá trị khác nhau theo thời gian. Parent của part là tổ tiên của part, vì vậy sự kiện `Class.Instance.AncestryChanged` sẽ được kích hoạt bất cứ khi nào nó thay đổi.

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

Sự kiện này bao gồm hai tham số: `child` đại diện cho `Class.Instance`
đã thực sự bị thay đổi thuộc tính `Class.Instance.Parent`, trong khi `parent` đại diện
cho `Class.Instance.Parent` mới của phiên bản này.

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


Instance.AncestryChanged

child

`Class.Instance` có thuộc tính `Class.Instance.Parent` đã bị thay đổi.


parent

Giá trị `Class.Instance.Parent` mới của `Class.Instance` mà
`Class.Instance.Parent` đã bị thay đổi.


Kích hoạt khi thuộc tính `Class.Instance.Parent` của đối tượng hoặc một
trong những 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 bị thay đổi trên phiên bả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 chuyển đến hàm kết nối.

Ví dụ, đoạn mã sau đây 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)
```
Tham khảo thêm `Class.Instance:GetAttributeChangedSignal()` mà trả về sự kiện kích hoạt
khi một thuộc tính cụ thể được thay đổi.


Instance.AttributeChanged

attribute

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


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


Đoạn mã này in ra 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 nuôi nấng vào `Class.Instance` này.

Lưu ý, khi sử dụng hàm này trên client để phát hiện các đối tượng được tạo bởi
server, cần sử dụng `Class.Instance:WaitForChild()` khi lập chỉ mục các con của đối tượng này.
Điều này là vì đối tượng và các con của nó không được đảm bảo sẽ được nhân bản từ server đến client
cùng một lúc. 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 ý, hàm này chỉ hoạt động cho những đứa trẻ ngay lập tức của `Class.Instance`.
Để có một hàm capture tất cả các đời con, hãy sử dụng `Class.Instance.DescendantAdded`.

Tham khảo thêm `Class.Instance.ChildRemoved`.


Instance.ChildAdded

`Class.Instance` đã được thêm vào.


Kích hoạt sau khi một đối tượng được nuôi nấng vào `Class.Instance` này.


Đoạn mã này in ra 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 đứa trẻ bị xóa khỏi `Class.Instance` này.

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

Hàm này chỉ hoạt động cho trẻ ngay lập tức của `Class.Instance`.
Đối với một hàm capture tất cả các con, hãy sử dụng `Class.Instance.DescendantRemoving`.

Tham khảo thêm `Class.Instance.ChildAdded`.


Instance.ChildRemoved

Kích hoạt sau khi một đứa trẻ bị xóa khỏi `Class.Instance` này.


Ví dụ dưới đâ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 đời con được thêm vào `Class.Instance`.

Do nó kích hoạt cho mọi đời con, việc nuôi nấng 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 đời con của nó một cách riêng biệt.

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

Tham khảo thêm `Class.Instance.DescendantRemoving`.


Instance.DescendantAdded

descendant

Kích hoạt sau khi một đời con đượ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 đến mức một phiên bản **đời con** sẽ không còn là một đời con nữa.
`Class.Instance:Destroy()|Destroy()` thay đổi `Class.Instance.Parent|Parent` của một
phiên bản thành `nil`, vì vậy việc gọi phương thức đó trên một đời con của
cha sẽ khiến sự kiện này được kích hoạt.

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

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

##### Cảnh báo

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

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

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

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


Instance.DescendantRemoving

Kích hoạt ngay trước khi một đời con 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 bị phá hủy sẽ giữ nguyên vị trí cho đến khi chức năng kết nối dừng lại.

Ví dụ này thể hiện cách mà, khi sử dụng hành vi tín hiệu hoãn,
   một Instance sẽ bị hủy trước khi tín hiệu được phát.

Đối tượng `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 đó tạm dừng bất cứ lúc nào,
đối tượng `Class.Instance` và các đời con của nó sẽ được đặt 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 những tổ tiên của nó bị hủy 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 khôi phục tiếp theo,
điều này sẽ xảy ra sau khi `Class.Instance` hoặc một trong những tổ tiên của nó bị
hủy 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à gặp vấn đề, vì kịch bản đó
sẽ bị hủy trước khi hàm callback có thể được gọi (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ị hủy. Thay vào đó, cha của nó được đặt thành `nil`
điều này bạn có thể theo dõi bằng `Class.Instance.AncestryChanged`.


Instance.Destroying

Kích hoạt ngay trước (hoặc bị hoãn cho đến sau) khi phiên bản bị
hủy thông qua `Class.Instance:Destroy()`.


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 bị thay đổi trên phiên bản,
bao gồm khi một thuộc tính được đặt thành `nil`.

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Các thuộc tính kiểu dáng đã thay đổi")
end

meterBar:StyledPropertiesChanged():Connect(stylePropertyChanged)
```


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 bị thay đổi trên phiên bản,
bao gồm khi một thuộc tính được đặt thành `nil`.


Instance.childAdded

Phương thức này áp dụng một thẻ cho instance, không có tác động 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 instance được thêm từ phía khách sẽ bị xóa nếu máy chủ
  sau đó thêm hoặc loại bỏ một thẻ trên instance đó bởi vì máy chủ
  nhân bản tất cả các thẻ cùng nhau và ghi đè các thẻ trước đó.

- Khi gán thẻ cho một instance, 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ớ, sẽ là một ý tưởng hay để làm sạch những tài nguyên này
  (ngắt kết nối, đặt về `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

Hàm này hủy tất cả các con và phần tử con của một instance.

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

-- Thêm một số hiệu ứng sparkles
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

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

print("Trẻ em:", #part:GetChildren())  --> Trẻ em: 3

part:ClearAllChildren()

print("Trẻ em:", #part:GetChildren())  --> Trẻ em: 0
```
Nếu bạn không muốn hủy **tất cả** trẻ em và phần tử con, sử dụng hoặc
`Class.Instance:GetChildren()` hoặc `Class.Instance:GetDescendants()` để
lặp qua những trẻ em/phần tử con đó và chọn những gì để hủy. Ví dụ, đoạn mã sau đây
sẽ hủy tất cả `Class.BasePart|BaseParts` thừa kế 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

Hàm này hủy tất cả các con của một instance.


Chứng minh 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 instance và tất cả các phần tử con của nó,
bỏ qua tất cả các instance không phải là `Class.Instance.Archivable|Archivable`.
Bản sao của instance gốc được trả về bởi phương thức này và thuộc tính
`Class.Instance.Parent|Parent` của nó được đặt thành `nil`. Lưu ý rằng nếu instance bản thân đã
được đặt là `Class.Instance.Archivable|Archivable` thành `false`, hàm 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
toàn bản sao, 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 liên quan đến một instance 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 liên quan đến một instance không được sao chép,
  giá trị tương tự được duy trì trong bản sao.


Instance:Clone

Tạo một bản sao của một instance và tất cả các phần tử con của nó, bỏ qua các instancet
không phải là `Class.Instance.Archivable|Archivable`.


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

Hàm này là cách chính xác để 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 trẻ em. Hàm này là cách chính xác để xử lý
các đối tượng không còn cần thiết.

Việc xử lý 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ẽ sử dụng hết bộ nhớ có thể dẫn đến các vấn đề hiệu suất nghiêm trọng theo thời gian.

Là một thực hành 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 phần tử con của nó) thành `nil`. Điều này
ngăn chặn mã của bạn truy cập bất cứ đ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 chặ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ể tái sử dụng được bở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 bỏ 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 trẻ em.


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

Hàm này hoạt động theo chiều dọc, nghĩa là nó bắt đầu từ
`Class.Instance.Parent` ngay lập tức và đi lên đến `Class.DataModel`. Nếu không tìm thấy tổ tiên nào khớp,
điều đó sẽ trả về `nil`.

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

```
local car = object:FindFirstAncestor("Car")
```
Đối với các biến thể của hàm 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.

Hàm này hoạt động theo chiều dọc, nghĩa là nó bắt đầu từ
`Class.Instance.Parent` ngay lập tức và đi lên đến `Class.DataModel`. Nếu không tìm thấy tổ tiên nào khớp,
điều đó sẽ trả về `nil`.

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

```
local model = part:FindFirstAncestorOfClass("Model")
```
Hàm 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ề đúng cho className đã cho.

Hàm này hoạt động theo chiều dọc, nghĩa là nó bắt đầu từ
`Class.Instance.Parent` ngay lập tức và đi lên đến `Class.DataModel`. Nếu không tìm thấy tổ tiên nào khớp,
điều đó sẽ trả về `nil`.

Khác với `Class.Instance:FindFirstAncestorOfClass()`, hàm 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
```
Vì vậy, đoạn mã sau đây sẽ trả về tổ tiên đầu tiên
`Class.BasePart`, không phân biệt nếu nó là một `Class.WedgePart`,
`Class.MeshPart` hoặc `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ề đúng 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ề đứa trẻ đầu tiên của `Class.Instance` với tên đã cho, hoặc
`nil` nếu không có đứa trẻ nào như vậy tồn tại. Nếu tham số tùy chọn `recursive` là
`true`, hàm này tìm kiếm tất cả các phần tử con thay vì chỉ các trẻ em 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 lấy một đứa trẻ theo tên bằng cách sử dụng toán tử chấm sẽ ném ra một lỗi nếu đứa trẻ không tồn tại.

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

-- Dòng sau sẽ 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
```
Cách tiếp cận tốt hơn là sử dụng `FindFirstChild()` để kiểm tra trước về `Part`,
sau đó sử dụng một câu lệnh `if` để chạy mã cần có nó.

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

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

##### Tìm một đứa trẻ mà tên phù hợp với một thuộc tính

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

Trong ví dụ sau, một `Class.Folder` gọi 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à đối tượng con `Class.Folder`. 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 ra 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 dài hơn
so với việc sử dụng toán tử chấm và gần 8 lần dài hơn so với việc chỉ 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, chẳng hạn như trong các vòng lặp chặt chẽ hay các hàm kết nối
với `Class.RunService.Heartbeat` và `Class.RunService.PreRender`. Thay vào đó,
hãy lưu kết quả trong 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 đứa trẻ của một
tên nhất định trở nên khả dụng.


Instance:FindFirstChild

recursive

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


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


Trả về đứa trẻ đầ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()`, hàm 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 đứa trẻ nào khớp, hàm này trả về `nil`.


Instance:FindFirstChildOfClass

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


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

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

Khác với `Class.Instance:FindFirstChildOfClass()`, hàm 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
```
Vì vậy, đoạn mã sau đây sẽ trả về đứa trẻ đầu tiên
`Class.BasePart`, không phân biệt nếu nó là một `Class.WedgePart`,
`Class.MeshPart` hoặc `Class.Part`.

```
local part = object:FindFirstChildWhichIsA("BasePart")
```
Các nhà phát triển đang tìm kiếm một đứa trẻ theo tên nên sử dụng
`Class.Instance:FindFirstChild()` thay vào đó.


Instance:FindFirstChildWhichIsA

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


Trả về phần tử con đầ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 phần tử con đầu tiên
của một instance, hãy xem xét việc sử dụng tham số `recursive` trên
`Class.Instance:FindFirstChild()` thay vào đó.


Instance:FindFirstDescendant

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


Nếu `Class.Instance` là một `Class.Actor`, thì `Class.Actor` bản thân nó được
trả về. Nếu không, tổ tiên gần nhất của nó là `Class.Actor` đượ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` được trả về.

Ví dụ, đoạn mã sau đây đặt và sau đó lấy giá trị của thuộc tính `InitialPosition`
của instance:

```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()` mà đặt thuộc tính với tên đã cho thành giá trị đã cho.
- `Class.Instance:GetAttributes()` mà trả về một từ điển các cặp khóa-giá trị cho mỗi thuộc tính của instance.


Instance:GetAttribute

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


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` được trả về.


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


Hàm này trả về một sự kiện hoạt động chính xác như sự kiện
`Class.Object.Changed|Changed`, ngoại trừ rằng nó chỉ xảy ra khi thuộc tính cụ thể đã cho thay đổi;
hiện tại nó tương đương với
`Class.Object:GetPropertyChangedSignal()|GetPropertyChangedSignal()` nhưng
cho các thuộc tính.

Thông thường tốt nhất là sử dụng phương thức này thay vì một 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 đây 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` sẽ kích hoạt bất cứ khi nào bất kỳ
thuộc tính nào bị thay đổi trên instance.


Instance:GetAttributeChangedSignal

Tên thuộc tính đã chỉ định mà tín hiệu thay đổi đang được trả về.


Một sự kiện xảy ra khi thuộc tính đã cho thay đổi.


Trả về một sự kiện mà xảy ra khi thuộc tính đã cho thay đổi.


Phương thức này trả về một từ điển chứa 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à giá trị không phải là `nil`.

Ví dụ, đoạn mã sau đây xuất ra các thuộc tính và giá trị của một instance:

```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()` mà trả về giá trị đã được gán cho tên thuộc tính đã cho.


Instance:GetAttributes

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


Trả về một từ điển chứa các thuộc tính của instance.


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ỉ số số) chứa tất cả các
trẻ em trực tiếp của instance, hoặc mỗi `Class.Instance` mà
`Class.Instance.Parent|Parent` 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 for cả số hoặc kiểu tổng quát:

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

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

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

-- Ví dụ vòng lặp for tổng quát
local children = Workspace:GetChildren()
for i, child in children do
	print(child.Name .. " là đứa trẻ thứ " .. i)
end
```
Các trẻ em được sắp xếp theo thứ tự mà thuộc tính
`Class.Instance.Parent|Parent` của chúng được thiết lập thành đối tượng.

Xem thêm chức năng `Class.Instance:GetDescendants()|GetDescendants`.


Instance:GetChildren

Một mảng chứa các con của instance.


Trả về một mảng chứa tất cả các con của instance.


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 `Class.Script` hoặc
  `Class.LocalScript` sẽ gây ra lỗi.
- ID gỡ lỗi là ID được sử dụng trong 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 một ứng dụng thực hiện nó. Tất cả các đối tượng trong
  Roblox hoạt động giống như các quy trình và mỗi lệnh (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 (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 này trả về một mảng chứa tất cả các phần tử con
của đối tượng đó. Không giống như `Class.Instance:GetChildren()`, hàm chỉ trả về
những đứa trẻ trực tiếp của một đối tượng, phương thức này tìm mọi trẻ con của đối tượng,
mỗi trẻ con của những trẻ của chúng, và cứ như vậy.


Instance:GetDescendants

Một mảng chứa các phần tử con của instance.


Trả về một mảng chứa tất cả các phần tử con của instance.


Mẫu mã này trình bày hành vi của `Class.Instance:GetFullName()`. 
Nó cho thấy chức năng hoạt động như thế nào khi được gọi trên một đối tượng không nằm trong 
hệ thống phân cấp `DataModel`, và nó cũng cho thấy giá trị trả về không thoát được 
những ký tự đặc biệt.

Ví dụ mã này tái cài đặt hàm `Class.Instance:GetFullName()` trong
Lua.

Trả về một chuỗi mô tả nguồn gốc của instance. Chuỗi là một
chuỗi ghép của `Class.Instance.Name|Name` của đối tượng và các tổ tiên của nó,
được phân cách bằng dấu chấm. `Class.DataModel` (`game`) không được
xem xét. Ví dụ, một `Class.Part` trong `Class.Workspace` có thể
trả về `Class.Workspace.Part`.

Khi được gọi trên một `Class.Instance` không phải là một phần tử con của
`Class.DataModel`, hàm này xem xét tất cả các tổ tiên lên đến và bao gồm
tổ tiên cao nhất mà không có `Class.Instance.Parent|Parent`.

Hàm này hữu ích cho việc ghi chép và gỡ lỗi. Bạn không nên cố gắng
ghiền cú pháp chuỗi trả về cho bất kỳ hoạt động hữu ích nào; hàm này không
trốn tránh dấu chấm (hay bất kỳ ký hiệu nào khác) trong tên đối tượng. Nói cách khác,
cho dù đầu ra của nó thường có vẻ như một định danh Luau hợp lệ, nhưng
không có gì đảm bảo.


Instance:GetFullName

Tên đầy đủ của `Class.Instance`.


Trả về một chuỗi mô tả nguồn gốc của instance.


Phương thức này trả về giá trị phong cách hoặc giá trị đã được sửa đổi rõ ràng của thuộc tính đã chỉ định,
hoặc giá trị thuộc tính mặc định nếu nó chưa được phong cách/sửa đổi. Điều này khác một chút so với việc truy cập giá trị thuộc tính
trực tiếp, chẳng hạn như `[GuiObject].Rotation`, mà trả về giá trị mặc định hoặc
đã sửa đổi của thuộc tính.

```lua
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")

local coreSheet = ReplicatedStorage:FindFirstChild("CoreSheet")
local rule = coreSheet:FindFirstChildWhichIsA("StyleRule")
rule.Selector = "TextButton"

-- Tham chiếu đến một nút
local button = HUDContainer:FindFirstChildWhichIsA("TextButton")

print(button:GetStyled("Rotation")) --> 0 (giá trị mặc định)
print(button.Rotation) --> 0 (giá trị mặc định)

-- Áp dụng xoay qua thuộc tính quy tắc phong cách
rule:SetProperty("Rotation", 30)

print(button:GetStyled("Rotation")) --> 30 (giá trị phong cách dựa trên quy tắc)
print(button.Rotation) --> 0 (giá trị mặc định)

-- Sửa đổi/cản trở rõ ràng thuộc tính phong cách
button.Rotation = 45

print(button:GetStyled("Rotation")) --> 45 (giá trị đã sửa đổi)
print(button.Rotation) --> 45 (giá trị đã sửa đổi)
```


Instance:GetStyled

Giá trị phong cách hoặc giá trị đã được sửa đổi rõ ràng của thuộc tính đã chỉ định,
hoặc giá trị thuộc tính mặc định nếu nó chưa được phong cách/sửa đổi.


Trả về giá trị phong cách hoặc giá trị đã được sửa đổi rõ ràng của thuộc tính đã chỉ định,
hoặc giá trị thuộc tính mặc định nếu nó chưa được phong cách/sửa đổi.


Phương thức này trả về một sự kiện mà hoạt động chính xác như sự kiện
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged`,
goài ra chỉ xảy ra khi thuộc tính kiểu cho đã cho thay đổi. Thông thường tốt nhất là sử dụng phương thức này hơn là một kết nối với
`Class.Instance.StyledPropertiesChanged|StyledPropertiesChanged` 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.

Lưu ý rằng sự kiện này sẽ không truyền bất kỳ tham số nào đến hàm kết nối,
vì vậy giá trị của thuộc tính đã thay đổi phải được đọc trực tiếp trong một
kịch bản.

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

local player = Players.LocalPlayer
local playerGui = player.PlayerGui
local HUDContainer = playerGui:WaitForChild("HUDContainer")
local meterBar = HUDContainer.MeterBar

local function stylePropertyChanged()
	print("Thuộc tính kiểu đã thay đổi!")
end

meterBar:GetStyledPropertyChangedSignal("AnchorPoint"):Connect(stylePropertyChanged)
```


Instance:GetStyledPropertyChangedSignal

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`.


AdGui

Tóm Tắt

Thuộc Tính

Thuộc Tính

Thuộc Tính

Thuộc Tính

Phương Pháp

Sự Kiện

Sự Kiện

Gọi Lại

Thuộc Tính

Phương Pháp

Sự Kiện

Gọi Lại

Trên trang này