GuiButton
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
GuiButton เป็นคลาสที่สืบทอดมาจาก GuiObjectเป็นคลาสระดับฐานสำหรับวัตถุที่สามารถคลิกได้และโต้ตอบได้ ImageButton และ TextButtonคลาสนี้ยังกำหนดคุณสมบัติหลายอย่างสำหรับพฤติกรรมโต้ตอบได้ คือ AutoButtonColor และ Modal
อีเวนต์ที่สำคัญที่สุดของ GuiButton คือ Activated อีเวนต์ หลายแพลตฟอร์ม ที่จะเปิดใช้งานเมื่อปุ่มถูกเปิดใช้งานเมื่อใช้เมาส์ จะหมายถึงการคลิกปุ่มและปล่อยด้วยเคอร์เซอร์ยังคงอยู่เหนือวัตถุ UIสำหรับการสัมผัส ใช้เช่นเดียวกัน แต่มีการสัมผัสแทนการกดปุ่มสุดท้ายสำหรับเกมแพด, Activated จะเผาไหม้ถ้า GuiButton ถูกเลือกเมื่อกดและปล่อยปุ่ม A สั้น ๆ เหตุการณ์นี้มีประโยชน์มากสำหรับการเขียนโปรแกรมอินเทอร์เฟซผู้ใช้หลายแพลตฟอร์มเนื่องจากมันให้อินเทอร์เฟซทั่วไปที่ดีสำหรับการใส่ข้อมูลของผู้ใช้รายเดียว
สรุป
คุณสมบัติ
กำหนดว่าปุ่มจะเปลี่ยนสีโดยอัตโนมัติเมื่อเมาส์เลื่อนผ่านหรือคลิกที่มันหรือไม่
ตัวอย่าง HapticEffect ที่จะเล่นเมื่อ GuiButton ถูกเลื่อน
หาก true ในขณะที่องค์ประกอบ GUI มองเห็นได้ เมาส์จะไม่ถูกล็อคเว้นแต่ปุ่มเมาส์ด้านขวาจะอยู่ใต้
ตัวอย่าง HapticEffect ที่จะเล่นเมื่อกด GuiButton จะถูกกด
คุณสมบัติ boolean ซึ่งระบุว่าวัตถุถูกเลือกหรือไม่
ตั้งสไตล์ของ GuiButton ตามรายการสไตล์ที่กําหนดไว้ล่วงหน้า
กำหนดว่าองค์ประกอบ UI นี้จะรับอินพุตหรือไม่
กำหนดจุดต้นกำเนิดของ GuiObject เมื่อเทียบกับขนาดสัมบูรณ์ของมัน
กำหนดว่าการปรับขนาดจะเกิดขึ้นตามเนื้อหาลูกหรือไม่
กำหนดสีพื้นหลัง GuiObject
กำหนดความโปร่งใสของพื้นหลังและขอบ GuiObject
กำหนดสีขอบ GuiObject ได้
กำหนดวิธีที่ขอบ GuiObject ถูกวางในลักษณะที่เกี่ยวข้องกับขนาด
กำหนดความกว้างของพิกเซลของขอบ GuiObject
กำหนดว่าถ้าลูกหลาน GuiObjects นอกขอบเขตขององค์ประกอบ GUI พ่อจะต้องแสดงผลหรือไม่
กำหนดว่าเมาส์ของผู้เล่นกดอยู่อย่างใดอย่างหนึ่งบน GuiObject หรือไม่
กำหนดว่า GuiButton สามารถโต้ตอบได้หรือไม่ หรือถ้า GuiState ของ GuiObject กำลังเปลี่ยนแปลงหรือไม่
ควบคุมลำดับการจัดเรียงของ GuiObject เมื่อใช้กับ UIGridStyleLayout
ตั้งค่า GuiObject ซึ่งจะถูกเลือกเมื่อตัวเลือกเกมแพดถูกเลื่อนลง
ตั้งค่า GuiObject ซึ่งจะถูกเลือกเมื่อตัวเลือกเกมแพดถูกย้ายไปทางซ้าย
ตั้งค่า GuiObject ซึ่งจะถูกเลือกเมื่อตัวเลือกเกมแพดถูกย้ายไปทางขวา
ตั้งค่า GuiObject ซึ่งจะถูกเลือกเมื่อตัวเลือกเกมแพดถูกย้ายขึ้น
กำหนดพิกเซลและตําแหน่งเวกเตอร์ของ GuiObject
กำหนดจำนวนองศาที่ GuiObject หมุนไป
ตรวจสอบว่า GuiObject สามารถเลือกได้โดยคอนโซลเกมหรือไม่
แทนที่การเลือกเริ่มต้นที่ใช้สำหรับเกมแพด
ลำดับของ GuiObjects ที่เลือกโดยการเลือก UI ของเกมแพด
กำหนดพิกเซลและขนาดสเกลาร์ของ GuiObject
ตั้งแกน Size ที่ GuiObject จะอ้างอิงจากขนาดของพ่อของมัน เมื่อเทียบกับขนาดของพ่อ
คุณสมบัติผสมของ BackgroundTransparency และ TextTransparency .
กำหนดว่า GuiObject และบรรดาลูกหลานจะถูกแสดงหรือไม่
กำหนดลำดับที่เรนเดอร์ GuiObject จะแสดงเป็นค่าสัมพันธ์กับคนอื่น
อธิบายตำแหน่งจอแสดงจริงขององค์ประกอบ GuiBase2d ในพิกเซล
อธิบายการหมุนหน้าจอที่เกิดขึ้นจริงขององค์ประกอบ GuiBase2d ในองศา
อธิบายขนาดหน้าจอที่เป็นจริงขององค์ประกอบ GuiBase2d ในพิกเซล
เมื่อตั้งค่าเป็น true การแปลท้องถิ่นจะถูกใช้กับ GuiBase2d และบรรดาลูกหลานของมัน
การอ้างอิงถึง LocalizationTable ที่จะใช้เพื่อใช้การแปลงภาษาท้องถิ่นอัตโนมัติกับ GuiBase2d และบรรดาลูกหลานของมัน
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางลง
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางซ้าย
ปรับพฤติกรรมการเลือก gamepad ในทิศทางที่ถูกต้อง
ปรับพฤติกรรมการเลือกเกมแพดในทิศทางขึ้น
อนุญาตให้ปรับแต่งการเคลื่อนไหวการเลือกเกมแพดได้
วิธีการ
วิธีการรับทอดมาจากGuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
เคลื่อน GUI ไปยังใหม่ UDim2 อย่างราบรื่น
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
เคลื่อน GUI ไปยังขนาดและตำแหน่งใหม่อย่างราบรื่น
อีเวนต์
เกิดไฟไหม้เมื่อปุ่มถูกเปิดใช้งาน
เกิดไฟไหม้เมื่อเมาส์ของผู้ใช้คลิกเต็มรูปแบบที่ GuiButton
เกิดไฟไหม้เมื่อผู้ใช้กดปุ่มเมาส์ซ้ายลงบน GuiButton
เกิดไฟไหม้เมื่อผู้ใช้ปล่อยปุ่มเมาส์ซ้ายออกจาก GuiButton
เกิดไฟไหม้เมื่อเมาส์ของผู้ใช้คลิกขวาเต็มรูปแบบที่ GuiButton
เกิดไฟไหม้เมื่อผู้ใช้กดปุ่มเมาส์ขวาลงบน GuiButton
เกิดไฟไหม้เมื่อผู้ใช้ปล่อยปุ่มเมาส์ขวาออกจาก GuiButton
ยิงเมื่อผู้ใช้เริ่มโต้ตอบผ่านอุปกรณ์อินเทอร์เฟซมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มแป้นพิมพ์ลง, เป็นต้น)
ยิงเมื่อผู้ใช้เปลี่ยนวิธีการโต้ตอบผ่านอุปกรณ์อินเทอร์เฟซมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มแป้นพิมพ์ลง, เป็นต้น)
ยิงเมื่อผู้ใช้หยุดโต้ตอบผ่านอุปกรณ์อินเทอร์เฟซมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มแป้นพิมพ์ลง, เป็นต้น)
เกิดไฟไหม้เมื่อผู้ใช้ย้ายเมาส์ไปยังองค์ประกอบ GUI
เกิดไฟไหม้เมื่อผู้ใช้ย้ายเมาส์ออกจากองค์ประกอบ GUI
เกิดไฟไหม้เมื่อผู้ใช้ย้ายเมาส์ในขณะที่อยู่ภายในองค์ประกอบ GUI ใดๆ
เกิดไฟไหม้เมื่อผู้ใช้เลื่อนล้อเมาส์กลับเมื่อเมาส์อยู่เหนือองค์ประกอบ GUI
เกิดไฟไหม้เมื่อผู้ใช้เลื่อนล้อเมาส์ไปข้างหน้าเมื่อเมาส์อยู่เหนือองค์ประกอบ GUI
ยิงเมื่อ GuiObject ได้รับการโฟกัสด้วยตัวเลือก Gamepad
ยิงเมื่อตัวเลือก Gamepad หยุดโฟกัสกับ GuiObject
เกิดไฟไหม้เมื่อผู้เล่นเริ่มต้น ดำเนินการต่อ และหยุดการกดค้างไว้นานบนองค์ประกอบ UI
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
เกิดไฟไหม้เมื่อผู้เล่นย้ายนิ้วบนองค์ประกอบ UI
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
เกิดไฟไหม้เมื่อผู้เล่นดําเนินการสับหรือดึงด้วยนิ้วสองนิ้วบนองค์ประกอบ UI
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
เกิดไฟไหม้เมื่อผู้เล่นดําเนินการทําท่าหมุนโดยใช้นิ้วสองนิ้วบนองค์ประกอบ UI
เกิดไฟไหม้เมื่อผู้เล่นดําเนินการสับข้อมูลบนองค์ประกอบ UI
เกิดไฟไหม้เมื่อผู้เล่นดําเนินการสัมผัสท่าทางบนองค์ประกอบ UI
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
ไฟเมื่อการเลือกเกมแพดย้ายไปที่ ออก หรือเปลี่ยนภายในเชื่อมต่อ GuiBase2d หรือทายาทใดๆ GuiObjects
คุณสมบัติ
AutoButtonColor
คุณสมบัตินี้กำหนดว่าปุ่มจะเปลี่ยนสีโดยอัตโนมัติเมื่อผู้ใช้ Mouse เลื่อนหรือคลิกที่มันหาก true ปุ่มจะเปลี่ยนสีโดยอัตโนมัติเมื่อเมาส์เลื่อนหรือคลิกที่มันหาก false ปุ่มจะไม่เปลี่ยนแปลง
หากคุณต้องการปรับแต่งวิธีที่ปุ่มเปลี่ยนเมื่อเมาส์ของผู้ใช้เลื่อนหรือคลิกที่มัน ให้พิจารณาใช้ ImageButton และเปลี่ยนองค์ประกอบ HoverImage และ PressedImage
โปรดทราบว่าคุณสมบัตินี้จะไม่มีผลต่อ ImageButton หากคุณสมบัติ Image ถูกตั้งค่าเป็นภาพนอกจากนี้คุณสมบัตินี้จะไม่ส่งผลกระทบต่อ ImageButton เมื่อเลื่อนเมาส์เมื่อไม่มี HoverImage หรือคลิกเมาส์เมื่อไม่มี nil หรือไม่มี PressedImage เมื่อไม่มี nil
Modal
หาก true ในขณะที่องค์ประกอบ GUI มองเห็นได้ เมาส์จะไม่ถูกล็อคเว้นแต่ปุ่มเมาส์ด้านขวาจะอยู่ใต้
วิธีการ
อีเวนต์
Activated
เกิดไฟไหม้เมื่อปุ่มถูกเปิดใช้งานเนื่องจากอีเวนต์นี้ไม่ได้จัดการบนเซิร์ฟเวอร์ ควรใช้เฉพาะใน LocalScript หรือใน Script ที่มี RunContext ของ Enum.RunContext.Client
พารามิเตอร์
MouseButton1Click
อีเวนต์นี้จะเกิดขึ้นเมื่อเมาส์ของผู้ใช้คลิกเต็มรูปแบบที่ GuiButton
ในเรื่องการคลิก, เมาส์ต้องอยู่ในขอบของ GuiButton และปุ่มเมาส์ต้องกดลงและขึ้นอีกครั้งก่อนที่จะเกิดเหตุการณ์นี้หากเมาส์ออกจากขอบของ GuiButton และถูกปล่อยออก อีเวนต์จะไม่ถูกยิงหากคุณต้องการหลีกเลี่ยงข้อจํากัดนี้ คุณสามารถใช้ MouseButton1Down และ MouseButton1Up เหตุการณ์เหล่านี้คล้ายกัน แต่จะยิงเมื่อผู้ใช้กดปุ่มเมาส์ซ้ายหรือขวาลงหรือขึ้นตามลําดับ
MouseButton1Down
อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้กดปุ่มเมาส์ซ้ายลงบน GuiButton
สำหรับอีเวนต์ที่ต้องการให้ผู้ใช้กด และ ปล่อยเมาส์ซ้ายของพวกเขาบน GuiButton เพื่อให้อีเวนต์ยิงได้พิจารณาใช้ MouseButton1Click
พารามิเตอร์
MouseButton1Up
อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้ปล่อยปุ่มเมาส์ซ้ายออกจาก GuiButton
สำหรับอีเวนต์ที่ต้องการให้ผู้ใช้กด และ ปล่อยเมาส์ซ้ายของพวกเขาบน GuiButton เพื่อให้อีเวนต์ยิงได้พิจารณาใช้ MouseButton1Click
พารามิเตอร์
MouseButton2Click
อีเวนต์นี้จะเกิดขึ้นเมื่อเมาส์ของผู้ใช้คลิกขวาเต็มรูปแบบที่ GuiButton
ในเรื่องการคลิก, เมาส์ต้องอยู่ในขอบของ GuiButton และปุ่มเมาส์ต้องกดลงและขึ้นอีกครั้งก่อนที่จะเกิดเหตุการณ์นี้หากเมาส์ออกจากขอบของ GuiButton และถูกปล่อยออก อีเวนต์จะไม่ถูกยิงหากคุณต้องการหลีกเลี่ยงข้อจํากัดนี้ คุณสามารถใช้ MouseButton2Down และ MouseButton2Up เหตุการณ์เหล่านี้คล้ายกัน แต่จะยิงเมื่อผู้ใช้กดปุ่มเมาส์ขวาหรือขึ้นของพวกเขาตามลําดับ
MouseButton2Down
อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้กดปุ่มเมาส์ขวาลงบน GuiButton
สำหรับอีเวนต์ที่ต้องการให้ผู้ใช้กด และ ปล่อยเมาส์ขวาของพวกเขาบน GuiButton เพื่อให้อีเวนต์สามารถยิงได้พิจารณาใช้ MouseButton2Click
พารามิเตอร์
MouseButton2Up
อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้ปล่อยปุ่มเมาส์ขวาออกจาก GuiButton
สำหรับอีเวนต์ที่ต้องการให้ผู้ใช้กด และ ปล่อยเมาส์ขวาของพวกเขาบน GuiButton เพื่อให้อีเวนต์สามารถยิงได้พิจารณาใช้ MouseButton2Click