UIDragDetector
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
UIDragDetector instansı, kullanıcı arayüzü elemanlarıyla etkileşimi kolaylaştırır ve destekler, such as sliders ve spinners. Key özellikleri içerir:
Tek bir kod satırı olmadan tüm girişler aracılığıyla kullanıcı tarafından sürüklemeyi sağlayan bir GuiObject altına yerleştirin.
Birden fazla DragStyle seçeneğinden seçin, nesnenin harekete nasıl yanıt verdiğini belirle ResponseStyle veya eksenler, hareket sınırları veya sürükleme sınırlarını uygulayabilirsiniz.
Kodlar, hareket ettirilen nesnelerin manipüleasyonuna yanıt vererek mantıksal yanıtlarınızı sürükleme gibi sürükleme işlemlerine yanıt verebilir.
UIDragDetectors Studio'da çalışır, değilseniz Seç , 0> Hareket0>, 3> Ölçek3>, veya 6> Rotate6> araçları, veya Studio'nun UIDragDetectors9> editör araçları ile bazı pluginler veya UIDragDetectors2> ara
Özet
Özellikler
Bu UIDragDetector 'in üzerindeki fareyi etkinleştirdiğinde kursör simgesini gösterir.
Class.UIDragWindow.Button ile etiketlenmiş objenin bağlayıcı davranışını belirleyin.
Ebeveyn GuiObject için çekme sınırlarını tanımlayan bağlayıcı alanı olan örneği.
Bu UIDragDetector 'in ebeveynine fareyi taşırken gösterilen kurma simgesini ayarlar.
Class.UIDragDetector.DragStyle|DragStyle öğesi, DragStyle ile ayarlanırken kaydırma eksenine kaydırılır.
Özelleştirilen bir sürükleme işlevinden giriş/çıkışların ilişkisini tanımlayan paradigmayı ayarlar.
Mevcut sürüklemenin yaptığı dönüş.
Özelleştirilen çekme işlevinden giriş/çıkış alanını tanımlayan paradigmayı ayarlar.
Önerilen hareketi oluşturmak için kullanılan paradigma.
Mevcut sürüklemenin bir UDim2 değeri ifade edilmiş şekilde çevirisi yapılır.
UIDragDetector'in kullanıcı girdiğine cevap verip vermediği.
Class.UIDragDetector.MinDragAngle|MinDragAngle ile birlikte, göstergenin dönme hareketini oluşturmaya çalışmasını engeller.
Class.UIDragDetector.MinDragTranslation|MinDragTranslation ile birlikte, sensörün lineer/plane hareketi oluşturmaya çalışmalarını engeller.
Class.UIDragDetector.MaxDragAngle|MaxDragAngle ile birlikte, göstergenin dönme hareketini oluşturmaya çalışmasını engeller.
Class.UIDragDetector.MaxDragTranslation|MaxDragTranslation ile birlikte, sensörün lineer/plane hareketi oluşturmaya çalışmalarını engeller.
Yerel alanı ve mutlak merkez pozisyonu referans alanı ve dedektör için kaynağı olan bir GuiObject instansı.
Önerilen hareketin yanıtını tanımlayan paradigm.
Çeviri için maksimum kayma hızı.
Saniyede maksimum açı UIDragDetector ile dönebilir.
Enum.UIDragSpeedAxisMapping / Y ebatını kaydırma hızlarını belirleyen Enum.UIDragSpeedAxisMapping değeri.
Yöntemler
Önerilen hareketi değiştirmek veya sınırlamak için bir işlev ekler.
Mevcut sürüklemenin referans kaynağının UDim2 pozisyonunu döndürür.
Mevcut sürüklemenin referansının referans elementinin referansını iade eder.
Class.UIDragDetector.DragStyle|DragStyleEnum.UIDragDetectorDragStyle.Scriptablekullanılacak bir işlev geçersizse kullanılır.
Etkinlikler
Kullanıcı, DragStart başlatıldıktan sonra UI öğesi devam eden kullanıcının ardından açılır.
Kullanıcı UI öğesi çekmeyi bırakırken ateş eder.
Kullanıcı UI öğesi ile başladığında yanar.
Özellikler
ActivatedCursorIcon
Bu UIDragDetector üzerindeki ekranı göstereceği kurdele simgesini ayarlar. Eğer bu özellik boş bırakılırsa, dedektör varsayılan simgeyi kullanır.
Aktifleştirici kurucu simgesini değiştirmek için, kullanmak istediğiniz görüntünün varlık kimliğine bu özelliği ayarlayın.
BoundingBehavior
Arayıcının BoundingUI değerini ayarladığında kaydırıcı UI nesnelerinin bağlayıcı davranışını belirler. Arayıcının her ayarının ayrıntılarını görmek için Enum.UIDragDetectorBoundingBehavior を görün.
BoundingUI
ayarla, UIDragDetector istemcisi ebeveynin GuiObject durumdışına çekilemeyecek.
Ana bileği GuiObject ın dışında BoundingUI sınırlarındaysa, sürükleme başlangıcındaki ilk giriş pozisyonu ve sürükleme sırasındaki relatif pozisyonu, hareket nesnesinin tüm sınırları içinde olduğundan itibaren bağlantı algılama için kullanılacaktır, ardından nesne kısı
CursorIcon
Bu UIDragDetector 'in ebeveynine sahip olduğunda kurulan kurma işaretleyiciyi gösterir. Bu özellik boş bırakılırsa, dedektör varsayılan simgekullanır.
Kurşör simgesini değiştirmek için, kullanmak istediğiniz görüntünün varlık kimliğine bu özelliği ayarlayın.
DragAxis
Vector2 değeri, hareket edilen nesnenin eksenini belirten değer, DragStyle ile ayarlandığında Enum.UIDragDetectorDragStyle.TranslateLine . A
DragRelativity
Sadece kaydedilmiş bir özel sürükleme işlevi için geçerlidir; SetDragStyleFunction() veya AddConstraintFunction() üzerinden kaydedilmiş girdi/çıkışların ilişkisini belirleyen paradigmayı ayarlar.
Ö
DragRotation
Mevcut sürüklemenin yaptığı dönüş. Bu değer, UIDragDetector olmayan yerel alanına göre derece olarak belirlenir, ReferenceUIInstance olmayan durumda ise dönüşü lokal alanında bu instansın ve pozitif X ekseninden oluşan alanında belirlenir.
Bu özellik, çektiğiniz nesneyi döndürmek için aktif bir sürükleme olmadığında değiştirilebilir.
DragSpace
Sadece kaydedilmiş bir özel sürükleme işlevi için geçerlidir, aksi takdirde SetDragStyleFunction() veya AddConstraintFunction() aracılığıyla kaydedilmiş bir özel sürükleme işlevi için geçerlidir. Set, kaydedilmiş işlevin giriş/çıkış al
Örneğin, algılayıcının ebeveyni GuiObject bir ebeveynin çocuğuysa, döndürülmüş bir Class.GuiObject olabilir:
Bu özellik seti ile kaydedilmiş bir işlevden UDim2.fromOffset(1, 0) ı döndürerek ana ebeveyni Enum.UIDragDetectorDragSpace.Parent ı yerinde 1 piksel hareket ettirir. Bu, ebeveyninin dönme etkisiyle yerel alanın GuiObject ını hareket ettirir.
Registered function'ın bu özellik seti ile UDim2.fromOffset(1, 0) 从 a ile döndürülürken, Enum.UIDragDetectorDragSpace.LayerCollector ile döndürücünün ebeveyni GuiObject1> Class.GuiObject ile1> arasındaki boşluk 1 pixel ile hareket ed
DragStyle
Önerilen hareketi oluşturmak için bir akış pozisyonu vektörü verilen paradigm kullanılır. Seçenekler için Enum.UIDragDetectorDragStyle bakın.
DragUDim2
Yapılan çeviri UDim2 değerinde ifade edilen mevcut sürükleme tarafından yapılır. Çeviri Offset veya Datatype.UDim.Scale
Bu özellik, sürükleme nesnesini hareket ettirmek için aktif bir sürükleme olmadığında değiştirilebilir.
MaxDragAngle
Bu özellik MinDragAngle ile daha büyükse, dönme MinDragAngle ve MaxDragAngle ile sınırlıdır. Olumlu değerler saat yönünde dönmeyi engellerken, olumsuz değerler
Bu bir kısıt değil; sadece göstergenin hareketi oluşturmaya çalışmasını engeller. See AddConstraintFunction() to add custom constraint to a drag.
Sadece önemli if DragStyle``Enum.UIDragDetectorDragStyle.Rotate rotasyonu.
MaxDragTranslation
Eşdeğer Offset ve/veya Scale değerleri tüm boyutlarda MinDragTranslation ve 1> Class.UID
Bu bir kısıt değil; sadece göstergenin hareketi oluşturmaya çalışmasını engeller. See AddConstraintFunction() to add custom constraint to a drag.
Sadece önemli if Class.UIDragDetector.DragStyle|DragStyle Enum.UIDragDetectorDragStyle.TranslateLine veya Enum.UIDragDetectorDragStyle.TranslatePlane 1> Class.UI拖式线1> 4> Class.UI拖式线4> 7> Class.UI拖式线7> 0> Class.UI拖式线0> DragStyle3> 6> Class.UI拖式线
MinDragAngle
Bu özellik MaxDragAngle 以下の範囲内に girilirse, döndürme MinDragAngle ve MaxDragAngle ile sınırlı kalacaktır. Olumlu değerler saat yönünde dö
Bu bir kısıt değil; sadece göstergenin hareketi oluşturmaya çalışmasını engeller. See AddConstraintFunction() to add custom constraint to a drag.
Sadece önemli if DragStyle``Enum.UIDragDetectorDragStyle.Rotate rotasyonu.
MinDragTranslation
Eşdeğer Offset ve/veya Scale değerleri tüm boyutlarda MaxDragTranslation ile aynı olmalıd
Bu bir kısıt değil; sadece göstergenin hareketi oluşturmaya çalışmasını engeller. See AddConstraintFunction() to add custom constraint to a drag.
Sadece önemli if Class.UIDragDetector.DragStyle|DragStyle Enum.UIDragDetectorDragStyle.TranslateLine veya Enum.UIDragDetectorDragStyle.TranslatePlane 1> Class.UI拖式线1> 4> Class.UI拖式线4> 7> Class.UI拖式线7> 0> Class.UI拖式线0> DragStyle3> 6> Class.UI拖式线
ReferenceUIInstance
Yerel alanı ve mutlak merkez pozisyonu referans alanı ve dedektör için kayna olarak kullanılan bir GuiObject instansı. Bu referansı ayarlamak, özellikleri etkiler, örneğin Class.UI拖动器.拖动器|拖动器|拖动器|拖动器|拖动器|拖动
ResponseStyle
Önerilen hareket hesaplanıp potansiyel olarak kısıtlanırsa, bu paradigma kullanılır, böylece nasıl hareket edileceğini (ya da hareket edilmeyeceğini) belirlemek için GuiObject etkili olan UIDragDetector . See Enum.UIDragDetectorResponseStyle for options.
SelectionModeDragSpeed
Tercüme için maksimum kayış hızını Scale ve Offset ile bir kombinasyon olarak tanımlar ve ilk atalet Class.
SelectionModeRotateSpeed
IDUDRagDetector 'in dakikada ne kadar fazla dönebileceğini tanımlar. Bu değer olumlu olmalıdır ve 0 altındaki herhangi bir değer 0 'e bağlanacaktır.
UIDragSpeedAxisMapping
Enum.UIDragSpeedAxisMapping / Y ebatını kaydırma hızlarını belirleyen Enum.UIDragSpeedAxisMapping değeri.
Yöntemler
AddConstraintFunction
Önerilen hareketi değiştirmek veya kısıtlmak için bir işlev ekler. İşlev, UDim2 (pozisyon) ve yüz (döndürme) ile ilgili önerilen hareketin propoz veya UDim2 edilmiş versiy
Giriş, DragSpace özelliğinin bir deltası veya nihai istediğiniz pozisyon/rotasyon için içerilen alanın ifadesi olarak ifade edilir. İçgörüsü,
Eklenmiş bir kısıtlayıcı işlevini kaldırmak için, döndürülen bağlantı nesnesinde Disconnect() çağırın.
Parametreler
Bu yöntemle eklenen işlevlerin önceliği düzeni. Yüksek değerler daha düşük değerlerden önce önceliği vardır.
Dönüşler
Kısıtlayıcı işlevini kaldırmak için bu bağlantı nesnesini kullanın.
GetReferencePosition
Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance olmadığında, bu işlev çekirdek nesnenin hemen arkasındaki UDim2 pozisyonunu veya taşınan nesnenin ebeveyni GuiObject (varsa) için işlevi iade eder.
Bir ReferenceUIInstance ayarlandığında, bu durumreferansının UDim2 pozisyonunu döndürür.
Dönüşler
GetReferenceRotation
Bir ReferenceUIInstance olmadığında, bu işlev kaydırıcı objenin derhal önceki ebeveyni olan GuiObject (varsa) veya kaydırıcı objenin derhal önceki ebeveyni olan Class.UI ile döndürür (eğer varsa).
Bir ReferenceUIInstance ayarlandığında, bu durumreferansı oluşturan dönmeyi döndürür.
Dönüşler
Mevcut sürüklemenin referans elemanının dönüşü.
SetDragStyleFunction
Eğer ve sadece eğer DragStyle``Enum.UIDragDetectorDragStyle.Scriptable veya Class.UIDragDetectorDragRel
Eğer işlev nil döndürürse, nesne hareket edilmez. Bu, yanıtı doğru vermenin gereken tüm bilgileri toplamadığında kullanışlıdır veya geçici durumlarda nesneyi istediğiniz yerde tutmak istediğinizde kullanışlıdır.
Parametreler
İzleme için DragContinue sinyallerini izleyen işlev. Bu işlev, sinyalimizin ekran alanı girişini alır ve UDim2 ve arzu edilen hareketi içeren flotu içeren bir nil ile etkileşim kurar. Eğer bu işlev 1>nil
Dönüşler
Etkinlikler
DragContinue
Kullanıcı, DragStart başlatıldıktan sonra UI öğesi devam eden kullanıcının ardından açılır.
Parametreler
DragEnd
Kullanıcı UI öğesi çekmeyi bırakırken ateş eder.