GuiButton
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
GuiButton เป็นคลาสที่มีเอกลักษณ์ของตัวเองจาก GuiObject มั
เหตุการณ์ที่สำคัญที่สุดของ GuiButton คือ GuiButton.Activated ซึ่งเป็น เหตุการณ์ของมัลติ
สรุป
คุณสมบัติ
กำหนดว่าปุ่มมีสีเมื่อเมาส์เลื่อนผ่านหรือคลิกปุ่มนั้น
หากเป็นเช่นนั้นเมื่อรูปแบบ GUI ปรากฏขึ้นจะไม่มีการล็อคเมาส์จนกว่าปุ่มเมาส์ขวาจะลง
ตัวแปรบูลีนที่ระบุว่ามีการเลือกตัวอักษรหรือไม่
ตั้งค่าสไตล์ของ GuiButton ตามรายการสไตล์ล่วงหน้า
กำหนดว่ารูปแบบนี้สามารถรับข้อมูลการป้อนของผู้ใช้ได้หรือไม่
กำหนดจุดเริ่มต้นของ GuiObject สัมพันธ์กับขนาดอันตามตัวเลข
กำหนดว่าจะมีการปรับขนาดหรือไม่ขึ้นอยู่กับเนื้อหาของลูก
กำหนดสีพื้นหลัง GuiObject
กำหนดความโปร่งใสของพื้นหลังและขอบเขตของ GuiObject
กำหนดสีของขอบ GuiObject
กำหนดวิธีการที่ GuiObject ขอบเขตถูกวางโดยเฉลี่ยกับขนาดของมัน
กำหนดความกว้างของพิกเซลของ GuiObject รอบ
กำหนดว่าควรเรนเดอร์หรือไม่ GuiObjects ภายนอกขอบเขตของรูปปั้น GUI ระดับพ่อของคุณ
กำหนดว่าผู้เล่นกดเมาส์บน GuiObject หรือไม่
กำหนดว่า GuiButton สามารถใช้งานได้หรือไม่ หรือว่า GuiState ของ GuiObject กําลังเปลี่ยนแปลงหรือไม่
ควบคุมลำดับการเรียงลำดับของ GuiObject เมื่อใช้กับ UIGridStyleLayout
ตั้งค่า GuiObject ซึ่งจะได้รับการเลือกเมื่อเครื่องยนต์ผู้ควบคุมเลื่อนลง
ตั้งค่า GuiObject ซึ่งจะถูกเลือกเมื่อเครื่องยนต์เลื่อนซ้าย
ตั้งค่า GuiObject ซึ่งจะถูกเลือกเมื่อเครื่องยนต์เลื่อนไปทางขวา
ตั้งค่า GuiObject ซึ่งจะถูกเลือกเมื่อเครื่องยนต์เลื่อนขึ้น
กำหนดตำแหน่งพิกเซลและตำแหน่งเศษเส้นของ GuiObject
กำหนดจำนวนองศาที่ GuiObject หมุน
กำหนดว่า GUI สามารถเลือกได้โดย gamepad หรือไม่
เปลี่ยนแปลงการตกแต่งการเลือกที่ใช้สำหรับแพดพันเกม
ลำดับของ GuiObjects ที่เลือกโดย UI เกมแพด.
กำหนดขนาดพิกเซลและขนาดพิกเซลของ GuiObject
ตั้งค่า Size แกนที่ Class.GuiObject จะสร้างบน, สัมพันธ์กับขนาดของพ่อของมัน.
สมบัติสัมพันธ์ผสมของ BackgroundTransparency และ TextTransparency
กำหนดว่า GuiObject และบุตรหลานของมันจะถูกเรนเดอร์หรือไม่
กำหนดลำดับที่เรนเดอร์ GuiObject เมื่อเป็นคู่กับคนอื่น
อธิบายตำแหน่งหน้าจอที่เป็นไปเลยของรายการ UI ในพิกเซล
อธิบายการหมุนเวียนหน้าจริงของ UI โดยองศา
อธิบายขนาดหน้าจอที่เป็นไปจริงของรายการ UI
เมื่อตั้งค่าเป็น true จะใช้การแปลภาษาใน GuiBase2d และลูกหลานของมัน
การอ้างอิงถึง LocalizationTable ที่จะใช้ในการประยุกต์การแปลอัตโนมัติสู่ GuiBase2d และลูกหลานของมัน
ปรับแต่งพฤติกรรมการเลือกแพดพักในแนวลง
ปรับแต่งพฤติกรรมการเลือกแพดพานเกมในแนวโน้มทางซ้าย
ปรับแต่งพฤติกรรมการเลือกแพดพักเกมในทิศทางที่ถูกต้อง
ปรับแต่งพฤติกรรมการเลือกแพดพักในแนวตั้งขึ้น
ช่วยให้คุณสามารถปรับแต่งการเคลื่อนไหวของแผงควบคุมเกม
วิธีการ
วิธีการรับทอดมาจากGuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
ย้าย GUI ไปยัง Datatype.UDim2 ใหม่อย่างราบรื่น
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
ปรับขนาด GUI ให้เล็กลงเป็น UDim2 ใหม่
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
ย้าย GUI ไปยังขนาดและตำแหน่งใหม่อย่างราบรื่น
อีเวนต์
เปิดให้บริการเมื่อปุ่มถูกเปิด
ได้รับการเปิดเมื่อเมาส์เหลืออยู่เมื่อคลิกปุ่ม GUI
ไฟร์เมื่อเมาส์อยู่ในสถานะด้านล่างของเมาส์ซ้ายบนวัตถุ GUI
เปิดตอนที่เมาส์ซ้ายปล่อยวัตถุ GUI
ได้รับการเปิดเมื่อเมาส์เต็มรูปแบบคลิกปุ่ม GUI
ไฟร์เมื่อเมาส์อยู่ในสถานะทางด้านล่างของเมาส์บนวัตถุ GUI
เปิดตอนที่ปุ่มเมาส์ขวาถูกปล่อยในวัตถุ GUI
เกิดขึ้นเมื่อผู้ใช้เริ่มต้นใช้งานผ่านอุปกรณ์ระหว่างมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มคีย์บอร์ดลง, ฯลฯ)
ไฟร์เมื่อผู้ใช้เปลี่ยนวิธีการโต้ตอบผ่านอุปกรณ์ระหว่างมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มกล้อง, ฯลฯ)
ไฟร์เมื่อผู้ใช้หยุดใช้งานผ่านอุปกรณ์ระหว่างมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มคีย์บอร์ดลง, ฯลฯ)
จะเกิดขึ้นเมื่อผู้ใช้ย้ายเมาส์ไปที่องค์ประกอบ GUI
จะเกิดขึ้นเมื่อผู้ใช้ย้ายเมาส์ออกจากส่วน 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
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
เกิดขึ้นเมื่อเลือกแผงควบคุมเกมเคลื่อนไปยัง, ออกหรือเปลี่ยนแปลงใน GuiBase2d หรือ GuiObjects ต้นได้
คุณสมบัติ
AutoButtonColor
สีปุ่มอัตโนมัติกำหนดว่าปุ่มเปลี่ยนสีโดยอัตโนมัติเมื่อผู้ใช้วางเมาส์บนหรือคลิกปุ่ม
หากเป็นเช่นนั้น ปุ่มจะเปลี่ยนสีโดยอัตโนมัติเมื่อเมาส์วางบนหรือคลิกปุ่มนั้น หากเป็นเช่นนั้น ปุ่มจะไม่เปลี่ยน
หากคุณต้องการปรับแต่งวิธีที่ปุ่มเปลี่ยนเมื่อผู้ใช้เล็งเมาส์ไปที่หรือคลิกมัน, ลองใช้ GUI ImageButton และเปลี่ยน ImageButton.HoverImage และ ImageButton.PressedImage ของเ
โปรดทราบว่าสมบัตินี้จะไม่มีผลกระทบต่อ ImageButton หากมีสมบัตินี้จะถูกติดตั้งในภาพและไม่ใช่ nul อย่างไรก็ตาม, ส
ตัวอย่างโค้ด
The code below enables a button's GuiButton.AutoButtonColor as long as it it not a ImageButton with ImageButton.HoverImage and ImageButton.PressedImage properties set to images.
In order for the code to work as expected, it must be placed in a LocalScript that is a child of the button.
local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = trueวิธีการ
อีเวนต์
Activated
เปิดใช้งานเมื่อปุ่มได้รับการเปิดใช้งาน เนื่องจากเหตุการณ์นี้ไม่ได้เกิดขึ้นในเซิร์ฟเวอร์จึงควรใช้ใน LocalScript หรือใน Script ด้วย
พารามิเตอร์
MouseButton1Click
เหตุการณ์ MouseButton1Click จะเกิดขึ้นเมื่อผู้ใช้กดปุ่ม Mouse เต็มรูปแบบเมื่อผู้ใช้กดปุ่ม GUI
โดยการคลิก, เมาส์ต้องอยู่ในขอบเขตของปุ่มและต้องกดลงและขึ้นอีเว้นท์อีกครั้งก่อนที่จะเกิดเหตุการณ์นี้ หากเมาส์ออกจากขอบเ
เหตุการณ์นี้คล้ายกับ GuiButton.MouseButton2Click ซึ่งมีพฤติกรณ์เหมือนกันยกเว้นว่ามันเชื่อมต่อกับปุ่มเมาส์ขวาของผู้ใช้
หมายเหตุว่าเหตุการณ์นี้จะเกิดขึ้นเฉพาะปุ่ม GUI รวมทั้ง TextButtons และ ImageButton ไม่ได้เกิดขึ้นสำหรับอื่น ๆ GuiObjects .
ตัวอย่างโค้ด
The code sample below demonstrates how to use the GuiButton.MouseButton1Click and GuiButton.MouseButton2Click events to handle user left and right mouse button input on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local button = script.Parent
local function leftClick()
print("Left mouse click")
end
local function rightClick()
print("Right mouse click")
end
button.MouseButton1Click:Connect(leftClick)
button.MouseButton2Click:Connect(rightClick)MouseButton1Down
เหตุการณ์ MouseButton1Down จะเกิดขึ้นเมื่อผู้ใช้กดปุ่มซ้ายของพวกเขาลงบนปุ่ม Class.Mouse ในวัตถุ GUI
เหตุการณ์นี้คล้ายกับ GuiButton.MouseButton2Down ซึ่งมีพฤติกรณ์เหมือนกันยกเว้นว่ามันเชื่อมต่อกับปุ่มเมาส์ขวาของผู้ใช้
หากคุณกำลังมองหาอีเวนต์ที่ต้องการให้ผู้ใช้กดและปล่อยเมาส์ซ้ายบน GUI เพื่อให้เหตุการณ์เกิดขึ้น โปรดพิจารณาการใช้ GuiButton.MouseButton1Click
หมายเหตุว่าเหตุการณ์นี้จะเกิดขึ้นเฉพาะปุ่ม GUI รวมทั้ง TextButtons และ ImageButton ไม่ได้เกิดขึ้นสำหรับอื่น ๆ GuiObjects .
พารามิเตอร์
ตัวอย่างโค้ด
The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton1Up
เหตุการณ์ MouseButton1Up เกิดขึ้นเมื่อผู้ใช้ปล่อยลูกศรซ้ายของพวกเขาออกจากวัตถุ GUI โดยไม่มีการปล่อย GUI
เหตุการณ์นี้คล้ายกับ GuiButton.MouseButton2Up ซึ่งมีพฤติกรณ์เหมือนกันยกเว้นว่ามันเชื่อมต่อกับปุ่มเมาส์ขวาของผู้ใช้
หากคุณกำลังมองหาอีเวนต์ที่ต้องการให้ผู้ใช้กดและปล่อยเมาส์ซ้ายบน GUI เพื่อให้เหตุการณ์เกิดขึ้น โปรดพิจารณาการใช้ GuiButton.MouseButton1Click
หมายเหตุว่าเหตุการณ์นี้จะเกิดขึ้นเฉพาะปุ่ม GUI รวมทั้ง TextButtons และ ImageButton ไม่ได้เกิดขึ้นสำหรับอื่น ๆ GuiObjects .
พารามิเตอร์
ตัวอย่างโค้ด
The code sample below demonstrates how to use the GuiButton.MouseButton1Up and GuiButton.MouseButton1Down events to handle user input when the left mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local button = script.Parent
local function leftMouseButtonUp(x, y)
print("Left mouse up at", x, y)
end
local function leftMouseButtonDown(x, y)
print("Left mouse down at", x, y)
end
button.MouseButton1Up:Connect(leftMouseButtonUp)
button.MouseButton1Down:Connect(leftMouseButtonDown)MouseButton2Click
เหตุการณ์ MouseButton2Click จะเกิดขึ้นเมื่อผู้ใช้กดปุ่ม GUI เต็มรูปแบบ
โดยการคลิก, เมาส์ต้องอยู่ในขอบเขตของปุ่มและต้องกดลงและขึ้นอีเว้นท์อีกครั้งก่อนที่จะเกิดเหตุการณ์นี้ หากเมาส์ออกจากขอบเ
เหตุการณ์นี้คล้ายกับ GuiButton.MouseButton1Click ซึ่งมีพฤติกรณ์เหมือนกันยกเว้นว่ามันเชื่อมต่อกับปุ่มเมาส์ซ้ายของผู้ใช้
หมายเหตุว่าเหตุการณ์นี้จะเกิดขึ้นเฉพาะปุ่ม GUI รวมทั้ง TextButtons และ ImageButton ไม่ได้เกิดขึ้นสำหรับอื่น ๆ GuiObjects .
ตัวอย่างโค้ด
Demonstrates how to use the GuiButton.MouseButton2Click event to detect when a user right clicks a GuiButton.
The mouse has to be in bounds of the button and has to be pressed down and up again before this event fires.
Note: place the "RightClickScreenGui" within StarterGui for this sample to work properly.
local button = script.Parent.Button
local function rightClick()
print("Right click pressed down and up on button.")
end
button.MouseButton2Click:Connect(rightClick)
MouseButton2Down
เหตุการณ์ MouseButton2Down จะเกิดขึ้นเมื่อผู้ใช้กดปุ่มขวาของพวกเขาบน GUI โอเบ็กต์
เหตุการณ์นี้คล้ายกับ GuiButton.MouseButton1Down ซึ่งมีพฤติกรณ์เหมือนกันยกเว้นว่ามันเชื่อมต่อกับปุ่มเมาส์ซ้ายของผู้ใช้
หากคุณกำลังมองหาอีเวนต์ที่ต้องการให้ผู้ใช้กดและปล่อยเมาส์ขวาบน GUI เพื่อให้เหตุการณ์เกิดขึ้น, พิจารณาใช้ GuiButton.MouseButton2Click
หมายเหตุว่าเหตุการณ์นี้จะเกิดขึ้นเฉพาะปุ่ม GUI รวมทั้ง TextButtons และ ImageButton ไม่ได้เกิดขึ้นสำหรับอื่น ๆ GuiObjects .
พารามิเตอร์
ตัวอย่างโค้ด
The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)
MouseButton2Up
เหตุการณ์ MouseButton2Up เกิดขึ้นเมื่อผู้ใช้ปล่อยปุ่มเมาส์ของพวกเขาออกจากวัตถุ GUI โดยตรง
เหตุการณ์นี้คล้ายกับ GuiButton.MouseButton1Up ซึ่งมีพฤติกรณ์เหมือนกันยกเว้นว่ามันเชื่อมต่อกับปุ่มเมาส์ซ้ายของผู้ใช้
หากคุณกำลังมองหาอีเวนต์ที่ต้องการให้ผู้ใช้กดและปล่อยเมาส์ขวาบน GUI เพื่อให้เหตุการณ์เกิดขึ้น, พิจารณาใช้ GuiButton.MouseButton2Click
หมายเหตุว่าเหตุการณ์นี้จะเกิดขึ้นเฉพาะปุ่ม GUI รวมทั้ง TextButtons และ ImageButton ไม่ได้เกิดขึ้นสำหรับอื่น ๆ GuiObjects .
พารามิเตอร์
ตัวอย่างโค้ด
The code sample below demonstrates how to use the GuiButton.MouseButton2Up and GuiButton.MouseButton2Down events to handle user input when the right mouse button is pressed down and released up on a GuiButton.
For the example to work expected, the LocalScript containing the code should be a child of the GUI button.
local gui = script.Parent
local button = gui.Button
function rightMouseButtonUp(x, y)
print("Right mouse up", x, y)
end
function rightMouseButtonDown(x, y)
print("Right mouse down", x, y)
end
button.MouseButton2Up:Connect(rightMouseButtonUp)
button.MouseButton2Down:Connect(rightMouseButtonDown)