GuiButton

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

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

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

GuiButton เป็นคลาสที่สืบทอดมาจาก GuiObjectเป็นคลาสระดับฐานสำหรับวัตถุที่สามารถคลิกได้และโต้ตอบได้ ImageButton และ TextButtonคลาสนี้ยังกำหนดคุณสมบัติหลายอย่างสำหรับพฤติกรรมโต้ตอบได้ คือ AutoButtonColor และ Modal

อีเวนต์ที่สำคัญที่สุดของ GuiButton คือ Activated อีเวนต์ หลายแพลตฟอร์ม ที่จะเปิดใช้งานเมื่อปุ่มถูกเปิดใช้งานเมื่อใช้เมาส์ จะหมายถึงการคลิกปุ่มและปล่อยด้วยเคอร์เซอร์ยังคงอยู่เหนือวัตถุ UIสำหรับการสัมผัส ใช้เช่นเดียวกัน แต่มีการสัมผัสแทนการกดปุ่มสุดท้ายสำหรับเกมแพด, Activated จะเผาไหม้ถ้า GuiButton ถูกเลือกเมื่อกดและปล่อยปุ่ม A สั้น ๆ เหตุการณ์นี้มีประโยชน์มากสำหรับการเขียนโปรแกรมอินเทอร์เฟซผู้ใช้หลายแพลตฟอร์มเนื่องจากมันให้อินเทอร์เฟซทั่วไปที่ดีสำหรับการใส่ข้อมูลของผู้ใช้รายเดียว

สรุป

คุณสมบัติ

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

    กำหนดว่าปุ่มจะเปลี่ยนสีโดยอัตโนมัติเมื่อเมาส์เลื่อนผ่านหรือคลิกที่มันหรือไม่

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

    ตัวอย่าง HapticEffect ที่จะเล่นเมื่อ GuiButton ถูกเลื่อน

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

    หาก true ในขณะที่องค์ประกอบ GUI มองเห็นได้ เมาส์จะไม่ถูกล็อคเว้นแต่ปุ่มเมาส์ด้านขวาจะอยู่ใต้

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

    ตัวอย่าง HapticEffect ที่จะเล่นเมื่อกด GuiButton จะถูกกด

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

    คุณสมบัติ boolean ซึ่งระบุว่าวัตถุถูกเลือกหรือไม่

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

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

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

    กำหนดว่าองค์ประกอบ 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 ในองศา

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

    อธิบายขนาดหน้าจอที่เป็นจริงขององค์ประกอบ GuiBase2d ในพิกเซล

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

    เมื่อตั้งค่าเป็น true การแปลท้องถิ่นจะถูกใช้กับ GuiBase2d และบรรดาลูกหลานของมัน

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

    การอ้างอิงถึง LocalizationTable ที่จะใช้เพื่อใช้การแปลงภาษาท้องถิ่นอัตโนมัติกับ GuiBase2d และบรรดาลูกหลานของมัน

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

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

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

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

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

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

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

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

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

    อนุญาตให้ปรับแต่งการเคลื่อนไหวการเลือกเกมแพดได้

วิธีการ

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

อีเวนต์

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

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

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

  • เกิดไฟไหม้เมื่อผู้ใช้ย้ายเมาส์ไปยังองค์ประกอบ 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

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

    เกิดไฟไหม้เมื่อผู้เล่นดําเนินการสับข้อมูลบนองค์ประกอบ UI

  • TouchTap(touchPositions : Array):RBXScriptSignal

    เกิดไฟไหม้เมื่อผู้เล่นดําเนินการสัมผัสท่าทางบนองค์ประกอบ UI

อีเวนต์รับทอดมาจากGuiBase2d

คุณสมบัติ

AutoButtonColor

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

คุณสมบัตินี้กำหนดว่าปุ่มจะเปลี่ยนสีโดยอัตโนมัติเมื่อผู้ใช้ Mouse เลื่อนหรือคลิกที่มันหาก true ปุ่มจะเปลี่ยนสีโดยอัตโนมัติเมื่อเมาส์เลื่อนหรือคลิกที่มันหาก false ปุ่มจะไม่เปลี่ยนแปลง

หากคุณต้องการปรับแต่งวิธีที่ปุ่มเปลี่ยนเมื่อเมาส์ของผู้ใช้เลื่อนหรือคลิกที่มัน ให้พิจารณาใช้ ImageButton และเปลี่ยนองค์ประกอบ HoverImage และ PressedImage

โปรดทราบว่าคุณสมบัตินี้จะไม่มีผลต่อ ImageButton หากคุณสมบัติ Image ถูกตั้งค่าเป็นภาพนอกจากนี้คุณสมบัตินี้จะไม่ส่งผลกระทบต่อ ImageButton เมื่อเลื่อนเมาส์เมื่อไม่มี HoverImage หรือคลิกเมาส์เมื่อไม่มี nil หรือไม่มี PressedImage เมื่อไม่มี nil

HoverHapticEffect

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

ตัวอย่าง HapticEffect ที่จะเล่นเมื่อ GuiButton ถูกเลื่อน

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

หาก true ในขณะที่องค์ประกอบ GUI มองเห็นได้ เมาส์จะไม่ถูกล็อคเว้นแต่ปุ่มเมาส์ด้านขวาจะอยู่ใต้

PressHapticEffect

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

ตัวอย่าง HapticEffect ที่จะเล่นเมื่อกด GuiButton จะถูกกด

Selected

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

คุณสมบัติ boolean ซึ่งระบุว่าวัตถุถูกเลือกหรือไม่

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

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

วิธีการ

อีเวนต์

Activated

เกิดไฟไหม้เมื่อปุ่มถูกเปิดใช้งานเนื่องจากอีเวนต์นี้ไม่ได้จัดการบนเซิร์ฟเวอร์ ควรใช้เฉพาะใน LocalScript หรือใน Script ที่มี RunContext ของ Enum.RunContext.Client

พารามิเตอร์

inputObject: InputObject
clickCount: number

MouseButton1Click

อีเวนต์นี้จะเกิดขึ้นเมื่อเมาส์ของผู้ใช้คลิกเต็มรูปแบบที่ GuiButton

ในเรื่องการคลิก, เมาส์ต้องอยู่ในขอบของ GuiButton และปุ่มเมาส์ต้องกดลงและขึ้นอีกครั้งก่อนที่จะเกิดเหตุการณ์นี้หากเมาส์ออกจากขอบของ GuiButton และถูกปล่อยออก อีเวนต์จะไม่ถูกยิงหากคุณต้องการหลีกเลี่ยงข้อจํากัดนี้ คุณสามารถใช้ MouseButton1Down และ MouseButton1Up เหตุการณ์เหล่านี้คล้ายกัน แต่จะยิงเมื่อผู้ใช้กดปุ่มเมาส์ซ้ายหรือขวาลงหรือขึ้นตามลําดับ


MouseButton1Down

อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้กดปุ่มเมาส์ซ้ายลงบน GuiButton

สำหรับอีเวนต์ที่ต้องการให้ผู้ใช้กด และ ปล่อยเมาส์ซ้ายของพวกเขาบน GuiButton เพื่อให้อีเวนต์ยิงได้พิจารณาใช้ MouseButton1Click

พารามิเตอร์

ความสัมพันธ์ของจอภาพของเมาส์ X ในพิกเซล

ความสัมพันธ์ของจอภาพของเมาส์ Y ในพิกเซล


MouseButton1Up

อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้ปล่อยปุ่มเมาส์ซ้ายออกจาก GuiButton

สำหรับอีเวนต์ที่ต้องการให้ผู้ใช้กด และ ปล่อยเมาส์ซ้ายของพวกเขาบน GuiButton เพื่อให้อีเวนต์ยิงได้พิจารณาใช้ MouseButton1Click

พารามิเตอร์

ความสัมพันธ์ของจอภาพของเมาส์ X ในพิกเซล

ความสัมพันธ์ของจอภาพของเมาส์ Y ในพิกเซล


MouseButton2Click

อีเวนต์นี้จะเกิดขึ้นเมื่อเมาส์ของผู้ใช้คลิกขวาเต็มรูปแบบที่ GuiButton

ในเรื่องการคลิก, เมาส์ต้องอยู่ในขอบของ GuiButton และปุ่มเมาส์ต้องกดลงและขึ้นอีกครั้งก่อนที่จะเกิดเหตุการณ์นี้หากเมาส์ออกจากขอบของ GuiButton และถูกปล่อยออก อีเวนต์จะไม่ถูกยิงหากคุณต้องการหลีกเลี่ยงข้อจํากัดนี้ คุณสามารถใช้ MouseButton2Down และ MouseButton2Up เหตุการณ์เหล่านี้คล้ายกัน แต่จะยิงเมื่อผู้ใช้กดปุ่มเมาส์ขวาหรือขึ้นของพวกเขาตามลําดับ


MouseButton2Down

อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้กดปุ่มเมาส์ขวาลงบน GuiButton

สำหรับอีเวนต์ที่ต้องการให้ผู้ใช้กด และ ปล่อยเมาส์ขวาของพวกเขาบน GuiButton เพื่อให้อีเวนต์สามารถยิงได้พิจารณาใช้ MouseButton2Click

พารามิเตอร์

ความสัมพันธ์ของจอภาพของเมาส์ X ในพิกเซล

ความสัมพันธ์ของจอภาพของเมาส์ Y ในพิกเซล


MouseButton2Up

อีเวนต์นี้จะเกิดขึ้นเมื่อผู้ใช้ปล่อยปุ่มเมาส์ขวาออกจาก GuiButton

สำหรับอีเวนต์ที่ต้องการให้ผู้ใช้กด และ ปล่อยเมาส์ขวาของพวกเขาบน GuiButton เพื่อให้อีเวนต์สามารถยิงได้พิจารณาใช้ MouseButton2Click

พารามิเตอร์

ความสัมพันธ์ของจอภาพของเมาส์ X ในพิกเซล

ความสัมพันธ์ของจอภาพของเมาส์ Y ในพิกเซล