ScreenGui
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
ScreenGui là một thùng chứa lưu trữ cho 2D GuiObjects được hiển thị trên màn hình của người dùng.A ScreenGui chỉ hiển thị nếu có liên kết với một người chơi PlayerGui ; liên kết một ScreenGui cho StarterGui vào một người chơi PlayerGui khi họ tham gia trải nghiệm và nhân vật của họ đầu tiên xuất hiện.Xem Thùng chứa UI trên màn hình để biết thêm chi tiết.
Đối với các cải tiến hiệu suất, sự xuất hiện của một ScreenGui được 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 bị xóa khỏi nó.
- Một thuộc tính của một con trai thay đổi.
- Một thuộc tính của ScreenGui chính nó thay đổi.
Nếu bất kỳ sự kiện nào xảy ra, hình xuất hiện ScreenGui trên khung tiếp theo nó được hiển thị lại.
Tóm Tắt
Thuộc Tính
Có nên cắt nội dung của đoạn này ScreenGui vào khu vực an toàn của thiết bị không.
Kiểm soát lệnh Z-index mà nhiều thùng chứa ScreenGui được vẽ.
Xác định xem ScreenGui có bị vượt quá phạm vi các yếu tố UI chính của Roblox hay không.
Xác định xem có áp dụng biến thể tương thích UI tự động cho "toàn màn hình" con trên các màn hình có cắt màn hình hay không GuiObjects trên các màn hình hiển thị.
Kiểm soát các đoạn an toàn được áp dụng cho nội dung của ScreenGui .
Bật/tắt sự hiển thị của điều này LayerCollector .
Xác định xem có phải LayerCollector đặt lại (tự xóa bản thân và sao chép lại vào nhân vật của người chơi PlayerGui) mỗi khi nhân vật của người chơi hồi sinh.
Kiểm soát cách GuiObject.ZIndex hành xử trên tất cả các con trai của điều này LayerCollector .
Mô tả vị trí màn hình thực của một thành phần GuiBase2d , trong điểm ảnh.
Mô tả sự xoay màn hình thực sự của một thành phần GuiBase2d , trong độ.
Mô tả kích thước màn hình thực của một thành phần GuiBase2d , bằng像素.
Khi được đặt thành true , bản địa hóa sẽ được áp dụng cho GuiBase2d và con cháu của nó.
Một tham chiếu đến một LocalizationTable để được sử dụng để áp dụng lok hóa tự động cho GuiBase2d và con cháu của nó.
Tùy chỉnh hành vi lựa chọn gamepad theo chiều xuống.
Tùy chỉnh hành vi lựa chọn gamepad theo hướng bên trái.
Tùy chỉnh hành vi lựa chọn gamepad theo hướng bên phải.
Tùy chỉnh hành vi lựa chọn gamepad trong hướng lên.
Cho phép tùy chỉnh chuyển động lựa chọn gamepad.
Sự Kiện
Sự Kiện kế thừa từ GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Bắt lửa khi lựa chọn gamepad di chuyển đến, rời hoặc thay đổi trong khu vực kết nối GuiBase2d hoặc bất kỳ con trai nào GuiObjects .
Thuộc Tính
ClipToDeviceSafeArea
Nếu thuộc tính này là true , tất cả các con cháu GuiObject của ScreenGui sẽ bị cắt xuống khu vực an toàn của thiết bị (xem Enum.ScreenInsets ).Mặc định là true để duy trì tương thích ngược của UI được ẩn khỏi màn hình cố ý, chẳng hạn như các đối tượng trượt vào tầm nhìn từ cạnh màn hình khi cần thiết.
Nếu thuộc tính này là false , GuiObject con cháu sẽ không được cắt xuống khu vực an toàn của thiết bị và có thể bị che khuất bởi notch máy ảnh hoặc các cắt màn hình khác.
Lưu ý rằng thuộc tính này sẽ bị bỏ qua nếu bạn đặt ScreenInsets thành None , vì việc làm như vậy có nghĩa là bạn cố tình muốn bỏ qua các chèn an toàn của thiết bị.
DisplayOrder
Tính chất này kiểm soát thứ tự Z-index mà nhiều thùng chứa ScreenGui được vẽ.Những người có giá trị cao hơn DisplayOrder sẽ được vẽ trên những người có giá trị thấp hơn.
IgnoreGuiInset
Nếu thuộc tính này là false (mặc định), ScreenInsets được đặt thành CoreUISafeInsets , hiệu quả giữ giới hạn của nó dưới giao diện người dùng chính của Roblox top bar.
Nếu thuộc tính này được thay đổi thành true và ScreenInsets hiện được đặt thành CoreUISafeInsets , ScreenInsets sẽ được đặt thành DeviceSafeInsets .
Xem ScreenInsets để có chi tiết về cách các chèn màn hình ảnh hưởng đến nội dung của một ScreenGui .
SafeAreaCompatibility
Thuộc tính này xác định xem có áp dụng biến đổi tương thích UI tự động cho "toàn màn hình" con trai không GuiObjects của ScreenGui trên các màn hình có cắt màn hình.Tính đủ điều kiện xảy ra nếu tổng diện tích của con cháu GuiObject (bao gồm bất kỳ biên giới nào được áp dụng hoặc UIStroke ) 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 Enum.SafeAreaCompatibility để có chi tiết.
Giá trị mặc định là FullscreenExtension để tự động cải thiện sự xuất hiện của UI đã được viết cho các màn hình không có bất kỳ cắt xén nào.Tuy nhiên, được khuyến khích bạn tránh các mở rộng toàn màn hình cho công việc mới; thay vào đó, sử dụng thuộc tính để xác định các chèn nào nên được tôn trọng cho các thùng chứa 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 ClipToDeviceSafeArea được đặt thành true .
ScreenInsets
Thuộc tính này kiểm soát các điểm chèn khu vực an toàn được áp dụng cho nội dung của ScreenGui .
Mặc định của CoreUISafeInsets giữ tất cả các con trai GuiObjects bên trong khu vực an toàn UI chính, loại bỏ các nút trên thanh trên cùng của Roblox và các cắt màn hình khác giống như khe máy ảnh của thiết bị.
Nếu bạn đặt thuộc tính này thành None, các đối tượng UI có thể bị che khuất sau các đối tượng UI chính hoặc cắt bỏ thiết bị giống như khe máy ảnh.Kết kết quảlà, bạn chỉ nên sử dụng None cho một ScreenGui chứa nội dung không tương tác như hình nền hình ảnh.
Xem Hộp chứa UI trên màn hình để có ví dụ thay thế.