ScreenGui
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
ScreenGui เป็นภาชนะเก็บข้อมูลสำหรับ 2D GuiObjects ที่แสดงบนหน้าจอของผู้ใช้A ScreenGui จะแสดงเฉพาะถ้ามีส่วนร่วมกับผู้เล่น PlayerGui ; การส่งมอบ ScreenGui ให้กับผู้เล่น StarterGui จะตรวจสอบให้แน่ใจว่ามันจะสร้างในแต่ละผู้เล่น PlayerGui เมื่อพวกเขาเข้าร่วมประสบการณ์และตัวละครของพวกเขาจะเกิดใหม่ครั้งแรกดู คอนเทนเนอร์ UI บนหน้าจอ สำหรับรายละเอียดเพิ่มเติม
สำหรับการปรับปรุงประสิทธิภาพการปรากฏตัวของ ScreenGui จะถูกบันทึกไว้จนกว่าจะเกิดหนึ่งในเหตุการณ์ต่อไปนี้:
- บุตรหลานถูกเพิ่มเข้าหรือลบออกจากมัน
- คุณสมบัติของลูกหลานเปลี่ยนแปลง
- คุณสมบัติของ ScreenGui ตัวเองเปลี่ยนแปลง
หากเหตุการณ์ใดเหล่านี้เกิดขึ้น การปรากฏตัวของ ScreenGui จะถูกคำนวณใหม่ในเฟรมถัดไปที่ได้รับการเรนเดอร์
สรุป
คุณสมบัติ
ว่าจะตัดเนื้อหาของนี้ ScreenGui ไปยังพื้นที่ปลอดภัยของอุปกรณ์หรือไม่
ควบคุมลำดับ Z-index ที่มีการวาดหลาย ScreenGui คอนเทนเนอร์
กำหนดว่า ScreenGui จะเกินขอบเขตขององค์ประกอบ UI หลักของ Roblox หรือไม่
ระบุว่าการเปลี่ยนแปลงความสอดคล้องของ UI อัตโนมัติจะถูกใช้กับ "เต็มหน้าจอ" ลูกหลานหรือไม่ในการแสดงที่มีส่วนตัดหน้าจอ GuiObjects
ควบคุมการอ้างอิงพื้นที่ปลอดภัยที่ใช้กับเนื้อหาของ ScreenGui
สลับการมองเห็นของสิ่งนี้ LayerCollector .
กำหนดว่าการรีเซ็ต LayerCollector จะเกิดขึ้น (ลบตัวเองและรีโคลนเข้าสู่ตัวละครของผู้เล่น PlayerGui ) ทุกครั้งที่ตัวละครของผู้เล่นเกิดใหม่
ควบคุมวิธีที่ GuiObject.ZIndex จะทำงานกับทุกสายลูกของสิ่งนี้ LayerCollector
อธิบายตำแหน่งจอแสดงจริงขององค์ประกอบ GuiBase2d ในพิกเซล
อธิบายการหมุนหน้าจอที่เกิดขึ้นจริงขององค์ประกอบ GuiBase2d ในองศา
อธิบายขนาดหน้าจอที่เป็นจริงขององค์ประกอบ GuiBase2d ในพิกเซล
เมื่อตั้งค่าเป็น true การแปลท้องถิ่นจะถูกใช้กับ GuiBase2d และบรรดาลูกหลานของมัน
การอ้างอิงถึง LocalizationTable ที่จะใช้เพื่อใช้การแปลงภาษาท้องถิ่นอัตโนมัติกับ GuiBase2d และบรรดาลูกหลานของมัน
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางลง
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางซ้าย
ปรับพฤติกรรมการเลือก gamepad ในทิศทางที่ถูกต้อง
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางขึ้น
อนุญาตให้ปรับแต่งการเคลื่อนไหวการเลือกเกมแพดได้
อีเวนต์
อีเวนต์รับทอดมาจากGuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ไฟเมื่อการเลือกเกมแพดย้ายไปที่ ออก หรือเปลี่ยนภายในเชื่อมต่อ GuiBase2d หรือทายาทใดๆ GuiObjects
คุณสมบัติ
ClipToDeviceSafeArea
หากคุณสมบัตินี้เป็น true ทั้งหมด GuiObject ลูกหลานของ ScreenGui จะถูกตัดออกจากพื้นที่ปลอดภัยของอุปกรณ์ (ดู Enum.ScreenInsets )ค่าเริ่มต้นคือ true เพื่อรักษาการสอดคล้องกับรุ่นก่อนหน้าของ UI ที่ซ่อนออกจากหน้าจอโดยเจตนา เช่น วัตถุที่สไลด์เข้ามาในมุมมองเมื่อจำเป็น
หากคุณสมบัตินี้เป็น false , GuiObject ลูกหลานจะ ไม่ ถูกตัดออกไปยังพื้นที่ปลอดภัยของอุปกรณ์และอาจถูกบดบังโดยช่องกล้องหรือการตัดหน้าจออื่นๆ
โปรดทราบว่าคุณสมบัตินี้จะถูกเพิกเฉยหากคุณตั้ง ScreenInsets เป็น None เนื่องจากการทำเช่นนั้นหมายความว่าคุณตั้งใจที่จะไม่สนใจคำสั่งซื้อที่ปลอดภัยของอุปกรณ์
DisplayOrder
คุณสมบัตินี้ควบคุมลำดับ Z-index ที่เครื่องมือหลาย ScreenGui คอนเทนเนอร์ถูกวาดผู้ที่มีค่าสูงกว่า DisplayOrder จะถูกวาดบนด้านบนของผู้ที่มีค่าต่ำกว่า
IgnoreGuiInset
หากคุณสมบัตินี้เป็น false (เริ่มต้น) ScreenInsets จะถูกตั้งค่าเป็น CoreUISafeInsets ทำให้ขอบเขตของมันอยู่ภายใต้ Roblox ท็อปบาร์หลัก UI ได้อย่างมีประสิทธิภาพ
หากคุณสมบัตินี้เปลี่ยนเป็น true และ ScreenInsets ได้รับการตั้งค่าเป็น CoreUISafeInsets แล้ว ScreenInsets จะถูกตั้งค่าเป็น DeviceSafeInsets
ดู ScreenInsets สำหรับรายละเอียดเกี่ยวกับวิธีที่การสอดแนมหน้าจอส่งผลต่อเนื้อหาของ ScreenGui
SafeAreaCompatibility
คุณสมบัตินี้ระบุว่าการเปลี่ยนแปลงความสอดคล้องกับอินเทอร์เฟซผู้ใช้อัตโนมัติจะถูกใช้กับ "เต็มหน้าจอ" ลูกหลาน GuiObjects ของ ScreenGui บนหน้าจอที่มีการตัดสกรีนคุณสมบัติจะเกิดขึ้นหากพื้นที่รวมของบุตรหลาน (รวมถึงเขตแดนใดๆ ที่ใช้แล้ว) ครอบคลุมพื้นที่ปลอดภัยของอุปกรณ์ทั้งในแนวนอนและแนวตั้งดูการอ้างอิงเลขลำดับ Enum.SafeAreaCompatibility สำหรับรายละเอียด
ค่าเริ่มต้นคือ FullscreenExtension เพื่อปรับปรุงรูปลักษณ์ของ UI โดยอัตโนมัติที่เขียนขึ้นสำหรับหน้าจอที่ไม่มีการตัดออกอย่างไรก็ตาม ขอแนะนำให้คุณหลีกเลี่ยงการขยายหน้าจอเต็มสำหรับงานใหม่; แทนที่จะใช้คุณสมบัติ เพื่อระบุสิ่งที่ควรได้รับการเคารพสำหรับคอนเทนเนอร์ที่แตกต่างกัน
โปรดทราบว่าวัตถุ UI รุ่นลูกจะยังคงถูกตัดโดยพื้นที่ปลอดภัยของอุปกรณ์หาก ClipToDeviceSafeArea ถูกตั้งค่าเป็น true
ScreenInsets
คุณสมบัตินี้ควบคุมการแทรกพื้นที่ปลอดภัยที่ถูกนำไปใช้กับเนื้อหาของ ScreenGui
ค่าเริ่มต้นของ CoreUISafeInsets เก็บลูกหลานทั้งหมด GuiObjects ภายในพื้นที่ปลอดภัย UI หลักของคอร์, ล้างปุ่มบนแถบด้านบนของ Roblox และรูปแบบการตัดหน้าจออื่นๆ เช่นช่องกล้องของอุปกรณ์
หากคุณตั้งค่าคุณสมบัตินี้เป็น None วัตถุ UI อาจถูกบดบังด้วยวัตถุ UI หลักหรือช่องว่างอุปกรณ์เช่นช่องว่างของกล้องผลที่ตามมาคือคุณควรใช้เฉพาะ None สำหรับ ScreenGui ที่มีเนื้อหาที่ไม่สามารถโต้ตอบได้เช่นภาพพื้นหลัง
ดู ตัวควบคุม UI บนหน้าจอ สำหรับตัวอย่างทางเลือก