GuiButton

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ไม่สามารถสร้าง
ไม่สามารถเรียกดู

GuiButton เป็นคลาสที่มีเอกลักษณ์ของตัวเองจาก GuiObject มั

เหตุการณ์ที่สำคัญที่สุดของ GuiButton คือ GuiButton.Activated ซึ่งเป็น เหตุการณ์ของมัลติ

สรุป

คุณสมบัติ

  • อ่านพร้อมๆ กัน

    กำหนดว่าปุ่มมีสีเมื่อเมาส์เลื่อนผ่านหรือคลิกปุ่มนั้น

  • อ่านพร้อมๆ กัน

    หากเป็นเช่นนั้นเมื่อรูปแบบ GUI ปรากฏขึ้นจะไม่มีการล็อคเมาส์จนกว่าปุ่มเมาส์ขวาจะลง

  • อ่านพร้อมๆ กัน

    ตัวแปรบูลีนที่ระบุว่ามีการเลือกตัวอักษรหรือไม่

  • อ่านพร้อมๆ กัน

    ตั้งค่าสไตล์ของ GuiButton ตามรายการสไตล์ล่วงหน้า

คุณสมบัติรับทอดมาจากGuiObject
  • อ่านพร้อมๆ กัน

    กำหนดว่ารูปแบบนี้สามารถรับข้อมูลการป้อนของผู้ใช้ได้หรือไม่

  • อ่านพร้อมๆ กัน

    กำหนดจุดเริ่มต้นของ 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 เมื่อเป็นคู่กับคนอื่น

คุณสมบัติรับทอดมาจากGuiBase2d
  • อ่านอย่างเดียว
    ไม่ซ้ำ

    อธิบายตำแหน่งหน้าจอที่เป็นไปเลยของรายการ UI ในพิกเซล

  • อ่านอย่างเดียว
    ไม่ซ้ำ

    อธิบายการหมุนเวียนหน้าจริงของ UI โดยองศา

  • อ่านอย่างเดียว
    ไม่ซ้ำ

    อธิบายขนาดหน้าจอที่เป็นไปจริงของรายการ UI

  • อ่านพร้อมๆ กัน

    เมื่อตั้งค่าเป็น true จะใช้การแปลภาษาใน GuiBase2d และลูกหลานของมัน

  • อ่านพร้อมๆ กัน

    การอ้างอิงถึง LocalizationTable ที่จะใช้ในการประยุกต์การแปลอัตโนมัติสู่ GuiBase2d และลูกหลานของมัน

  • อ่านพร้อมๆ กัน

    ปรับแต่งพฤติกรรมการเลือกแพดพักในแนวลง

  • อ่านพร้อมๆ กัน

    ปรับแต่งพฤติกรรมการเลือกแพดพานเกมในแนวโน้มทางซ้าย

  • อ่านพร้อมๆ กัน

    ปรับแต่งพฤติกรรมการเลือกแพดพักเกมในทิศทางที่ถูกต้อง

  • อ่านพร้อมๆ กัน

    ปรับแต่งพฤติกรรมการเลือกแพดพักในแนวตั้งขึ้น

  • อ่านพร้อมๆ กัน

    ช่วยให้คุณสามารถปรับแต่งการเคลื่อนไหวของแผงควบคุมเกม

วิธีการ

วิธีการรับทอดมาจากGuiObject

อีเวนต์

อีเวนต์รับทอดมาจากGuiObject
  • เกิดขึ้นเมื่อผู้ใช้เริ่มต้นใช้งานผ่านอุปกรณ์ระหว่างมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มคีย์บอร์ดลง, ฯลฯ)

  • ไฟร์เมื่อผู้ใช้เปลี่ยนวิธีการโต้ตอบผ่านอุปกรณ์ระหว่างมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มกล้อง, ฯลฯ)

  • ไฟร์เมื่อผู้ใช้หยุดใช้งานผ่านอุปกรณ์ระหว่างมนุษย์-คอมพิวเตอร์ (ปุ่มเมาส์ลง, แตะเริ่ม, ปุ่มคีย์บอร์ดลง, ฯลฯ)

  • จะเกิดขึ้นเมื่อผู้ใช้ย้ายเมาส์ไปที่องค์ประกอบ 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

    เกิดขึ้นเมื่อผู้เล่นทำการหมุนโดยใช้นิ้วสองนิ้วบนรูปปั้น

  • TouchSwipe(swipeDirection : Enum.SwipeDirection,numberOfTouches : number):RBXScriptSignal

    เกิดขึ้นเมื่อผู้เล่นทำการเลื่อนสไนเปอร์บนองค์ประกอบ UI

  • TouchTap(touchPositions : Array):RBXScriptSignal

    เกิดขึ้นเมื่อผู้เล่นทำการเลื่อนสายตาในส่วน UI

อีเวนต์รับทอดมาจากGuiBase2d
  • 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.

Changing a GUI Button's Color on Hover and Click

local button = script.Parent
if button:IsA("ImageButton") then
if button.HoverImage and button.ClickImage then
return
end
end
button.AutoButtonColor = true
อ่านพร้อมๆ กัน

หากเป็นเช่นนั้นเมื่อรูปแบบ GUI ปรากฏขึ้นจะไม่มีการล็อคเมาส์จนกว่าปุ่มเมาส์ขวาจะลง

Selected

อ่านพร้อมๆ กัน

ตัวแปรบูลีนที่ระบุว่ามีการเลือกตัวอักษรหรือไม่

อ่านพร้อมๆ กัน

ตั้งค่าสไตล์ของ GuiButton ตามรายการสไตล์ล่วงหน้า

วิธีการ

อีเวนต์

Activated

เปิดใช้งานเมื่อปุ่มได้รับการเปิดใช้งาน เนื่องจากเหตุการณ์นี้ไม่ได้เกิดขึ้นในเซิร์ฟเวอร์จึงควรใช้ใน LocalScript หรือใน Script ด้วย

พารามิเตอร์

inputObject: InputObject
clickCount: number

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.

Handling User Clicks on a 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.

Handling Right Mouse Button Up/Down on a 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.

Handling Right Mouse Button Up/Down on a 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.

GUI Button Right Click

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.

Handling Left Mouse Button Up/Down on a 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.

Handling Left Mouse Button Up/Down on a 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)