UIDragDetector

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

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

UIDragDetector ตัวอย่างที่เปิดให้ใช้งานในประสบการณ์ รวมถึงส่วนประกอบของ 2D user interface ในประสบการณ์เช่นเลื่อนและหมุน คุณสมบัติหลักในการใช้งานรวมถึง:

  • วาง Class.GuiObject ที่มีรหัสอยู่ภายใต้ทุก Class.GuiObject ที่มีรหัส เพื่อให้มันสามารถลากได้ผ่านทุกการป้อนข้อมูลโดยไม่มีเส้นโค้ดเดียว

  • เลือกจากตัวเลือกหลาย DragStyle ตัวเลือก, กำหนดวิธีการที่วัตถุตอบสนองต่อการเคลื่อนไหวโดย ResponseStyle และใช้ตัวจับตำแหน่ง, ขีดจำกัดการเคลื่อนไหว

  • สคริปต์สามารถตอบสนองต่อการโดนย้ายวัตถุเพื่อขับเคลื่อนการตอบสนองของล็อกิก เช่นการปรับแต่งการตั้งค่า

  • UIragDetectors ทำงานใน Studio นานเท่าที่คุณไม่ใช้ เลือก ใช้ ย้าย หรือ 0>เคลื่อนย้าย0> หรือ 3>ขนาด3> หรือ UIDragDetectors6> เคร

สรุป

คุณสมบัติ

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

    ตั้งไอคอนเมาส์ให้เปิดเมื่อเมาส์ถูกเปิดบนพ่อของ UIDragDetector นี้

  • BoundingBehavior:Enum.UIDragDetectorBoundingBehavior
    อ่านพร้อมๆ กัน

    กำหนดพฤติกรณ์การจำกัดของวัตถุ UI ที่ลากเมื่อตัวตรวจจับของเรากำหนดไว้ BoundingUI

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

    ตัวอินสแตนซ์ที่มีพื้นที่ชนะสำหรับพ่อ GuiObject

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

    ตั้งไอคอนเมาส์ให้เป็นเมื่อเมาส์อยู่เหนือพ่อของ UIDragDetector นี้

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

    ลำดับเห�ียวสำหรับตัวอย่าง UIDragDetector เมื่อ DragStyle ตั้งค่าไว้ที่ Enum.UIDragDetectorDragStyle.TranslateLine

  • DragRelativity:Enum.UIDragDetectorDragRelativity
    อ่านพร้อมๆ กัน

    ตั้งค่าระดับที่กำหนดความสัมพันธ์ของการประมวลผลของการนำเสนอข้อมูล/การส่งออกจากคุณสมบัติผสาน

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

    การหมุนที่ดำเนินการโดยลากปัจจุบัน

  • DragSpace:Enum.UIDragDetectorDragSpace
    อ่านพร้อมๆ กัน

    ตั้งค่าร่างกายที่กำหนดพื้นที่ของการป้อน/ส่งข้อมูลจากการลากจากการปรับแต่ง

  • DragStyle:Enum.UIDragDetectorDragStyle
    อ่านพร้อมๆ กัน

    ระบบจัดการที่ใช้สร้างการเคลื่อนไหวที่เสนอ

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

    การแปลที่ดำเนินการโดยลากปัจจุบันที่แสดงในค่า UDim2

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

    ว่า UIDragDetector ตอบสนองต่อการป้อนข้อมูลของผู้ใช้

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

    พร้อมกับ MinDragAngle ป้องกันการพยายามของเครื่องตรวจจับที่จะสร้างการเคลื่อนที่หมุน

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

    พร้อมกับ MinDragTranslation ป้องกันการพยายามของเครื่องตรวจจับที่จะสร้างการเคลื่อนไหวแบบเส้น/แบน

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

    พร้อมกับ MaxDragAngle ป้องกันการพยายามของเครื่องตรวจจับที่จะสร้างการเคลื่อนที่ในแนวตรง.

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

    พร้อมกับ MaxDragTranslation ป้องกันการพยายามของเครื่องตรวจจับเพื่อสร้างการเคลื่อนไหวแบบเส้น/แบบพานามิเตอร์

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

    ตัวอย่าง GuiObject ที่มีพื้นที่และตำแหน่งกลางของพื้นที่เฉพาะเป็นพื้นที่อ้างอิงและตำแหน่งกลางของเครื่องตรวจจับ

  • ResponseStyle:Enum.UIDragDetectorResponseStyle
    อ่านพร้อมๆ กัน

    รูปแบบที่ใช้ในการอธิบายการตอบสนองต่อการเคลื่อนไหวที่เสนอ

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

    ความเร็วการลากสูงสุดสำหรับการแปล

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

    มุมสูงสุดต่อวินาที UIDragDetector สามารถหมุนได้

  • UIDragSpeedAxisMapping:Enum.UIDragSpeedAxisMapping
    อ่านพร้อมๆ กัน

    Enum.UIDragSpeedAxisMapping มูลค่าที่กำหนดความเร็วในการลากของ X / Y มิติ

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

  • DragContinue(inputPosition : Vector2):RBXScriptSignal

    จะเริ่มไฟรีเมื่อผู้ใช้ดึงส่วนหนึ่งของ UI หลังจากที่ DragStart ได้รับการเริ่มต้น

  • DragEnd(inputPosition : Vector2):RBXScriptSignal

    เกิดขึ้นเมื่อผู้ใช้หยุดลากส่วนหนึ่งของ UI

  • DragStart(inputPosition : Vector2):RBXScriptSignal

    เกิดขึ้นเมื่อผู้ใช้เริ่มลากส่วนหนึ่งของ UI

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

คุณสมบัติ

ActivatedCursorIcon

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

ตั้งไอคอนเมาส์ให้เป็นแสดงเมื่อเปิดเมาส์เหนือพ่อของตัวนี้ UIDragDetector หากปล่อยไว้โมฆะไอคอนเมาส์จะใช้ไอคอนเริ่มต้น

เพื่อเปลี่ยนไอคอนเมาส์ที่เปิดใช้งาน ให้ตั้งค่าสมบัติรหัสของรูปภาพที่คุณต้องการใช้

BoundingBehavior

Enum.UIDragDetectorBoundingBehavior
อ่านพร้อมๆ กัน

กำหนดพฤติกรณ์การจำกัดของวัตถุ UI ที่ลากเมื่อตัวระบุของเรดเดอร์กำหนดไว้ ดู BoundingUI สำหรับรายละเอียดเกี่ยวกับพฤติกรณ์ของแต่ละการตั้งค่า

BoundingUI

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

ตั้งค่าUIDragDetector ตัวอย่างจะไม่สามารถดึงขีดจำกัดของพ่อ GuiObject ออกจากขีดจำกัดของ BoundingUI อินสแตนซ์

หมายเหตุว่าหากส่วนหนึ่งของผู้ปกครอง GuiObject อยู่นอกขอบเขต BoundingUI จะใช้ตำแหน่งการป้อนข้อมูลเริ่มต้นในขั้นตอนการลากและตำแหน่งของมันในขั้นตอนกา

CursorIcon

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

ตั้งค่าไอคอนเมาส์ที่แสดงเมื่อเมาส์อยู่เหนือปุ่มหลักของนี้ UIDragDetector หากสถานที่นี้ว่างเปล่า เครื่องมือนี้จะใช้ไอคอนเริ่มต้น

เพื่อเปลี่ยนไอคอนเมาส์ให้เป็นรหัสสมบัติของรูปภาพที่คุณต้องการใช้

DragAxis

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

Vector2 มีค่าที่กำหนดแกนการเคลื่อนที่สำหรับวัตถุที่ลากเมื่อ DragStyle ต

DragRelativity

Enum.UIDragDetectorDragRelativity
อ่านพร้อมๆ กัน

ใช้ได้เฉพาะถ้าคุณสมบัติดึงสร้างขึ้นผ่าน SetDragStyleFunction() หรือ AddConstraintFunction() ตั้งแค่นี้ก็จะกำหนดรูปแบบของคุณสมบัติที่ใช้ในการใช้งาน

ต

DragRotation

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

การหมุนที่ดำเนินการโดยลากปัจจุบัน มีค่านี้ได้รับการกำหนดในองศาเมื่อเปรียบเทียบกับพื้นที่ในท้องถิ่นของ UIDragDetector ยกเว้นว่า Class.

คุณสมบัตินี้สามารถเปลี่ยนแปลงได้ในขณะที่ไม่มีลากเหยียวเพื่อหมุนวัตถุลาก

DragSpace

Enum.UIDragDetectorDragSpace
อ่านพร้อมๆ กัน

ใช้ได้เฉพาะถ้าคุณสมบัติดึงเฉพาะได้รับการลงทะเบียนผ่าน SetDragStyleFunction() หรือ AddConstraintFunction() ตั้งแต่นั้นก็จะติดตั้งร่างกายของฟังก์ชันที

เช่นเดียวกับเมื่อพี่น้องของเครื่องตรวจจับ GuiObject เป็นลูกของพ่อ GuiObject ที่หมุน:

  • การกลับสู่ฟังก์ชันที่ลงทะเบียนด้วยค่านี้ตั้งอยู่ใน UDim2.fromOffset(1, 0) จากฟังก์ชันที่ลงทะเบียนจะย้ายพ่อของเดียว Enum.UIDragDetectorDragSpace.Parent ไปที่ด้านข

  • การกลับสู่ค่า UDim2.fromOffset(1, 0) จากระเบียบัญชีที่ลงทะเบียนมีค่านี้ตั้งไว้ใน Enum.UIDragDetectorDragSpace.LayerCollector จะย้ายพ่อของเดียวกันในพื้นที่ของ

DragStyle

Enum.UIDragDetectorDragStyle
อ่านพร้อมๆ กัน

ร่างกายที่ใช้ในการสร้างการเคลื่อนไหวที่เสนอได้รับตัวแปรตำแหน่งการป้อนสตรีม ดู Enum.UIDragDetectorDragStyle สําหรับตัวเลือก

DragUDim2

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

การแปลที่ดำเนินการโดยค่าดรากที่แสดงใน UDim2 มีการแปลผ่าน Offset หรื

คุณสมบัตินี้สามารถเปลี่ยนแปลงได้ในขณะที่ไม่มีลากเพื่อย้ายวัตถุที่ลาก

Enabled

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

หาก true ตอบสนองต่อการป้อนข้อมูลของผู้ใช้; หาก UIDragDetector ไม่ตอบสนอง

MaxDragAngle

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

หากค่านี้ใหญ่กว่า MinDragAngle การหมุนจะถูกกระทืบภายในระยะ MinDragAngle และ MaxDragAngle สิ่งที่เป

นี่ไม่ใช่ข้อจํากัด; มันเพียงแค่ป้องกันการพยายามของเครื่องตรวจจับเพื่อให้อยู่ภายใต้ขีดจำกัด ดู AddConstraintFunction() เพื่อเพิ่มข้อจํากัดเฉพาะกับการลาก

เฉพาะเมื่อ DragStyle เป็น Enum.UIDragDetectorDragStyle.Rotate

MaxDragTranslation

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

หากค่า Offset และ/หรือ Scale ของค่า MinDragTranslation ในทุกมิต

นี่ไม่ใช่ข้อจํากัด; มันเพียงแค่ป้องกันการพยายามของเครื่องตรวจจับเพื่อให้อยู่ภายใต้ขีดจำกัด ดู AddConstraintFunction() เพื่อเพิ่มข้อจํากัดเฉพาะกับการลาก

เฉพาะเฉพาะถ้า DragStyle เป็น Enum.UIDragDetectorDragStyle.TranslateLine หรือ Enum.UIDragDetectorDragStyle.TranslatePlane เท่านั้น

MinDragAngle

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

หากค่านี้เล็กกว่า MaxDragAngle การหมุนจะถูกกดอยู่ภายในขอบเขตของ MinDragAngle และ MaxDragAngle โดยม

นี่ไม่ใช่ข้อจํากัด; มันเพียงแค่ป้องกันการพยายามของเครื่องตรวจจับเพื่อให้อยู่ภายใต้ขีดจำกัด ดู AddConstraintFunction() เพื่อเพิ่มข้อจํากัดเฉพาะกับการลาก

เฉพาะเมื่อ DragStyle เป็น Enum.UIDragDetectorDragStyle.Rotate

MinDragTranslation

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

หากค่า Offset และ/หรือ Scale ของคุณน้อยกว่าคุณสมบัติของ Class.UIDragDetector.

นี่ไม่ใช่ข้อจํากัด; มันเพียงแค่ป้องกันการพยายามของเครื่องตรวจจับเพื่อให้อยู่ภายใต้ขีดจำกัด ดู AddConstraintFunction() เพื่อเพิ่มข้อจํากัดเฉพาะกับการลาก

เฉพาะเฉพาะถ้า DragStyle เป็น Enum.UIDragDetectorDragStyle.TranslateLine หรือ Enum.UIDragDetectorDragStyle.TranslatePlane เท่านั้น

ReferenceUIInstance

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

ตัวอย่าง GuiObject ที่มีพื้นที่และตำแหน่งกลางเป็นพื้นที่อ้างอิงสำหรับเครื่องตรวจจับ การตั้งค่าสถานที่อ้างอิงนี้จะส

ResponseStyle

Enum.UIDragDetectorResponseStyle
อ่านพร้อมๆ กัน

เมื่อคำนวณความเคลื่อนไหวที่เสนอแนะแล้วและอาจจะจำกัดความเคลื่อนไหวได้ ประการนี้จึงใช้ในการกำหนดวิธีการย้าย (หรือไม่ย้าย) GuiObject ที่ได้รับผลกระทบโ

SelectionModeDragSpeed

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

กำหนดความเร็วการลากสูงสุดสำหรับการแปลในขณะที่เป็นคอมบินชั่นของ Scale และ <

SelectionModeRotateSpeed

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

กำหนดมุมสูงสุดต่อวินาทีที่ UIDragDetector สามารถหมุนได้ ค่านี้ต้องเป็นบวกและค่าใด ๆ ด้านล่าง 0 จะถูกกดไปยัง 0

UIDragSpeedAxisMapping

Enum.UIDragSpeedAxisMapping
อ่านพร้อมๆ กัน

Enum.UIDragSpeedAxisMapping มูลค่าที่กำหนดความเร็วในการลากของ X / Y มิติ

ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

วิธีการ

AddConstraintFunction

RBXScriptConnection

เพิ่มฟังก์ชันเพื่อปรับแต่งหรือจำกัดการเคลื่อนที่เสนอไว้ ฟังก์ชันใช้ข้อมูล UDim2 (ตําแหน่ง) และลอยตัว

การป้อนข้อมูลจะถูกแสดงในพื้นที่ที่กำหนดโดยสมบัติของ DragSpace โดยเป็นดาต้าหรือ

เพื่อลบคุณสมบัติที่เพิ่มเข้ามา โปรดเรียก Disconnect() ในตัวเอกสารการเชื่อมต่อที่กลับมา

พารามิเตอร์

priority: number

ลำดับความสามารถที่มีความสำคัญสูงสุดสำหรับการเพิ่มผ่านวิธีนี้ มีค่ามากกว่าลำดับความสามารถที่ต่ำกว่า

function: function

การใช้งานสำหรับการปรับแต่งหรือจำกัดการเคลื่อนที่ที่เสนอไว้ การใช้งานนี้รับข้อมูล Datatype.UD


ส่งค่ากลับ

RBXScriptConnection

ใช้วัตถุการเชื่อมต่อนี้เพื่อลบคุณสมบัติ

GetReferencePosition

UDim2

เมื่อไม่มี ReferenceUIInstance ตั้งค่าฟังก์ชันนี้จะกลับค่า UDim2 ตำแหน่งของบรรพบุรุษโดยตรงของวัตถุที่ลากไปยัง Class

ตั้งค่าReferenceUIInstance ไว้ ฟังก์ชันนี้จะกลับค่าตำแหน่ง UDim2 อินสแตนซ์


ส่งค่ากลับ

UDim2

UDim2 ตําแหน่งของส่วนอ้างอิงของลากปัจจุบัน

GetReferenceRotation

number

เมื่อไม่มี ReferenceUIInstance ตั้งค่าฟังก์ชันนี้จะส่งกลับค่าการหมุนของวัตถุลากจากพ่อของวัตถุลากทันที GuiObject (ถ้ามี) หรือค่าการหมุนของวัตถุลาก (ถ้ามี)

ตั้งค่าReferenceUIInstance ไว้ อินสแตนซ์


ส่งค่ากลับ

number

การหมุนของส่วนอ้างอิงของลากปัจจุบัน

SetDragStyleFunction

void

ส่งค่าฟังก์ชันที่จะใช้เฉพาะถ้าและเท่านั้นถ้า Class.UI

หากคุณสมบัติกลับมาเป็น nil ไม่ได้เคลื่อนย้ายไปยังตำแหน่งเดิม หากสคริปต์ยังไม่ได้รวบรวมข้อมูลทั้งหมดที่ต้องให้คำตอบที่ถูกต้อง หรือในกรณีที่คุณต้องการให้ตัวอักษรอยู่ที่เดิ

พารามิเตอร์

function: function

ระบบสำหรับการตรวจสอบ DragContinue สัญญาณ รับตำแหน่งพื้นที่หน้าจอของ singal และกลับค่า UDim2 และลอยตัวที่ต้องการในพื้นที่


ส่งค่ากลับ

void
ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object

อีเวนต์

DragContinue

จะเริ่มไฟรีเมื่อผู้ใช้ดึงส่วนหนึ่งของ UI หลังจากที่ DragStart ได้รับการเริ่มต้น

พารามิเตอร์

inputPosition: Vector2

Vector2 เป็นตัวแทนตำแหน่งการป้อนข้อมูลปัจจุบัน


DragEnd

เกิดขึ้นเมื่อผู้ใช้หยุดลากส่วนหนึ่งของ UI

พารามิเตอร์

inputPosition: Vector2

Vector2 เป็นตัวแทนตำแหน่งการป้อนข้อมูลปัจจุบัน


DragStart

เกิดขึ้นเมื่อผู้ใช้เริ่มลากส่วนหนึ่งของ UI

พารามิเตอร์

inputPosition: Vector2

Vector2 เป็นตัวแทนตำแหน่งการป้อนข้อมูลปัจจุบัน


ดูทั้งหมดที่รับทอดมาจาก Instance
ดูทั้งหมดที่รับทอดมาจาก Object