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 örneği, kaydırıcılar ve döndürücüler gibi deneyimdeki 2D kullanıcı arayüzü öğeleriyle etkileşimi kolaylaştırır ve teşvik eder.Önemli özellikler şunları içerir:
Tek bir kod satırı olmadan tüm girişler aracılığıyla sürüklenebilir hale getirmek için herhangi bir UIDragDetector örneğinin altına bir GuiObject yerleştirin.
Birkaç seçeneği arasından seçim yapın, nesnenin harekete nasıl yanıt verdiğini tanımlayın ve isteğe bağlı olarak eksen, hareket sınırları veya sürükleme sınırları uygulayın.
Scriptler, ayar ayarları gibi mantık yanıtı sürdürmek için sürüklenen nesnelerin manipülasyonuna yanıt verebilir.
UIDragDetectors Stüdyo'da çalışın, kullanmıyorsanız Seçim , Hareket , Ölçeklendirme veya Döndürme araçlarını veya belirli eklentileri veya Studio'nun UI editör araçlarını kullanmıyorsunuz.
Özet
Özellikler
Fare bu UIDragDetector 'in ebeveyni üzerinde etkinleştirildiğinde görüntülenmesi için mouse ikonunu ayarlar.
Dedektörün BoundingUI ayarlandığında, sürüklenen UI nesnesinin sınırlama davranışını belirler.
Sınırlama alanına sahip örnek, ebeveyn GuiObject.
Fare bu UIDragDetector 'in ebeveyni üzerinde gezinirken görüntülenmesi için mouse ikonunu ayarlar.
UIDragDetector örneği için sürükleme ekseninin DragStyle ayarlandığında Enum.UIDragDetectorDragStyle.TranslateLine.
Özel bir sürükleme işlevinden gelen giriş/çıkışların relatifliğini tanımlayan paradigmayı ayarlar.
Mevcut sürükleme tarafından gerçekleştirilen dönme.
Özel bir sürükleme işlevinden gelen giriş/çıkış alanını tanımlayan paradigmayı ayarlar.
Önerilen hareket üretmek için kullanılan paradigma.
Mevcut sürüklemenin yapıldığı çeviri, bir UDim2 değerinde ifade edilir.
UIDragDetector 'nin kullanıcı girişine yanıt verip vermediği.
MinDragAngle ile birlikte, dedektörün dönme hareketi üretme girişimlerini engeller.
MinDragTranslation ile birlikte, dedektörün lineer/planar hareket üretme girişimlerini engeller.
MaxDragAngle ile birlikte, dedektörün dönme hareketi üretme girişimlerini engeller.
MaxDragTranslation ile birlikte, dedektörün lineer/planar hareket üretme girişimlerini engeller.
Yerel alanı ve mutlak merkez konumu dedektör için referans alanı ve kaynağı olan bir GuiObject örneği. A örneğinin yerel alanı ve mutlak merkez konumu dedektör için referans alanı ve kaynağıdır.
Teklif edilen harekete yanıt vermek için kullanılan paradigma.
Tercüme için maksimum sürtme hızı.
Saniye başına maksimum açı UIDragDetector dönebilir.
X / Y boyut sürükleme hızlarını belirleyen değer.
Yöntemler
Önerilen hareketi değiştirmek veya sınırlandırmak için bir işlev ekler.
Mevcut sürüklemenin referans konumunun referans UDim2 pozisyonunu döndürür.
Mevcut sürüklemenin referans elementinin referans dönüşünü döndürür.
DragStyle ayarlanırsa ve sadece Enum.UIDragDetectorDragStyle.Scriptable kullanılacak bir işlev geçer.
Etkinlikler
Bir kullanıcı, DragStart başlatıldıktan sonra UI öğesini sürüklemeyi sürdürdüğünde ateş eder.
Bir kullanıcı UI öğesini sürüklemeyi bıraktığında ateş eder.
Bir kullanıcı UI öğesini sürüklemeye başladığında ateş eder.
Özellikler
ActivatedCursorIcon
Fare bu UIDragDetector 'in ebeveyni üzerinde etkinleştirildiğinde görüntülenmesi için mouse ikonunu ayarlar.Bu özellik boş bırakılırsa, dedektör varsayılan simgekullanacaktır.
Aktifleştirilmiş kursör simgesini değiştirmek için, bu özelliği kullanmak istediğiniz görüntünün varlık kimliğine ayarlayın.
BoundingBehavior
Dedektörün BoundingUI ayarlandığında sürüklenen UI nesnesinin sınırlama davranışını belirler. Her ayarın davranışına ilişkin ayrıntılar için bakın Enum.UIDragDetectorBoundingBehavior .
BoundingUI
ayarla, örneği, ebeveyn örneğinin sınırlarının sınırların dışına çekilmesine izin vermeyecektir.
Ebeveynin bir kısmı dışında yer alıyorsa, sürükleme başlangıcındaki ilk giriş pozisyonu ve sürükleme sırasındaki mutlak konumu, sürüklenen nesnenin bütünlüğü içinde olduğunda bağlanma tespiti için kullanılacaktır ve ardından nesne sınırlar içinde sıkıştırılacaktır.
CursorIcon
Fare bu UIDragDetector 'in ebeveyni üzerinde gezinirken görüntülenmesi için mouse ikonunu ayarlar.Bu özellik boş bırakılırsa, dedektör varsayılan simgekullanacaktır.
Okutma simgedeğiştirmek için, bu özelliği kullanmak istediğiniz görüntünün varlık kimliğine ayarlayın.
DragAxis
Vector2 çekilen nesnenin hareket eksenini tanımlayan değer, DragStyle e çevrildiğinde Enum.UIDragDetectorDragStyle.TranslateLine olarak ayarlanır.Eksen, belirtilmediği sürece yerel alanda tanımlanır, bu durumda eksen o anın yerel alanında tanımlanır.
DragRelativity
Sadece özel bir sürükleme işlevi SetDragStyleFunction() veya AddConstraintFunction() aracılığıyla kaydedilmişse uygulanır.Kayıtlı işlevin giriş/çıkışlarının relatifliğini tanımlayan paradigmayı ayarlar.
Örneğin, bu özellik setine sahip kayıtlı bir işlevden geri döndürmek, dedektörün ebeveynini belirlenen 'a taşırken, aynı 'yi bu özellik setine sahip olarak döndürmek, dedektörün ebeveynini belirlenen 'a taşırken, aynı 'yi bu özellik setine sahip olarak taşır.
DragRotation
Mevcut sürükleme tarafından gerçekleştirilen dönme.Bu değer, UIDragDetector 'nin yerel uzayına göre tanımlanır, eğer ReferenceUIInstance tanımlanmazsa, bu durumda dönüş, o anın yerel uzayında ve pozitif X ekseninden tanımlanır.
Sürüklenen nesneyi döndürmek için aktif bir sürükleme yokken bu özellik değiştirilebilir.
DragSpace
Sadece özel bir sürükleme işlevi SetDragStyleFunction() veya AddConstraintFunction() aracılığıyla kaydedilmişse uygulanır.Kayıtlı işlevin giriş/çıkışlarının alanını tanımlayan paradigmayı ayarlar.
Örneğin, dedektörün ebeveyni döndürülmüş bir ebeveynin çocuğuysa:
Bu özellik ile kaydedilmiş bir işlevden bir döndürme, dedektörün ebeveynini ebeveyninin dönüşüne maruz kalan yerel alanda 1 piksel sağa taşıyacaktır.
Bu özellik ile kayıtlı bir işlevden döndürmek, dedektörün ebeveynini uzayında 1 piksel sağa taşıyacaktır.
DragStyle
Önerilen hareket oluşturmak için kullanılan paradigma, bir giriş pozisyon vektörü akışı verildiğinde. Seçenekler için bakın Enum.UIDragDetectorDragStyle .
DragUDim2
Mevcut sürüklemenin yapıldığı çeviri, bir UDim2 değerinde ifade edilir.Tercüme, Offset veya Scale değer değişiklikleri ile yapılır çünkü DragRelativity değeri üzerine bağlıdır ve bir ReferenceUIInstance tanımlanmadıkça yerel alanla ilgilidir.
Sürüklenen nesneyi hareket ettirmek için aktif bir sürükleme yokken bu özellik değiştirilebilir.
MaxDragAngle
Bu özellik MinDragAngle daha büyükse, dönüş MinDragAngle ve MaxDragAngle aralığında kısılacaktır.Olumlu değerler saat yönünde dönmeyi engellerken, olumsuz değerler ters yönlü dönmeyi engeller.
Bu bir kısıtlama değildir; sadece sınırlar içinde kalmak için dedektörün hareket üretme girişimlerini engeller.Bir sürüklemeye özel kısıt eklemek için AddConstraintFunction() bakın.
Sadece önemli if DragStyle is Enum.UIDragDetectorDragStyle.Rotate .
MaxDragTranslation
Eşdeğer Offset ve/veya Scale değerleri tüm boyutlardaki MinDragTranslation değerlerinden daha büyük ise, lineer/planar çeviri, MinDragTranslation ve MaxDragTranslation aralığında sıkıştırılacaktır.
Bu bir kısıtlama değildir; sadece sınırlar içinde kalmak için dedektörün hareket üretme girişimlerini engeller.Bir sürüklemeye özel kısıt eklemek için AddConstraintFunction() bakın.
Sadece önemli eğer DragStyle``Enum.UIDragDetectorDragStyle.TranslateLine veya Enum.UIDragDetectorDragStyle.TranslatePlane ise.
MinDragAngle
Bu özellik MaxDragAngle dan daha az ise, dönüş MinDragAngle ve MaxDragAngle aralığında kısılacaktır.Olumlu değerler saat yönünde dönmeyi engellerken, olumsuz değerler ters yönlü dönmeyi engeller.
Bu bir kısıtlama değildir; sadece sınırlar içinde kalmak için dedektörün hareket üretme girişimlerini engeller.Bir sürüklemeye özel kısıt eklemek için AddConstraintFunction() bakın.
Sadece önemli if DragStyle is Enum.UIDragDetectorDragStyle.Rotate .
MinDragTranslation
Eşdeğer Offset ve/veya Scale değerleri tüm boyutlardaki MaxDragTranslation değerlerinden daha az ise, lineer/planar çeviri, MinDragTranslation ve MaxDragTranslation aralığında sıkıştırılacaktır.
Bu bir kısıtlama değildir; sadece sınırlar içinde kalmak için dedektörün hareket üretme girişimlerini engeller.Bir sürüklemeye özel kısıt eklemek için AddConstraintFunction() bakın.
Sadece önemli eğer DragStyle``Enum.UIDragDetectorDragStyle.TranslateLine veya Enum.UIDragDetectorDragStyle.TranslatePlane ise.
ReferenceUIInstance
Yerel alanı ve mutlak merkez konumu dedektör için referans alanı ve kaynağı olan bir GuiObject örneği. A örneğinin yerel alanı ve mutlak merkez konumu dedektör için referans alanı ve kaynağıdır.Bu referansı ayarlamak, DragUDim2 , DragRotation ve DragAxis 'in davranışını etkiler.
ResponseStyle
Önerilen hareket hesaplandıktan ve potansiyel olarak sınırlandıktan sonra, bu paradigma GuiObject tarafından etkilenen UIDragDetector 'in nasıl hareket edeceğini veya hareket etmeyeceğini belirlemek için kullanılır.Seçenekler için Enum.UIDragDetectorResponseStyle bakın.
SelectionModeDragSpeed
Tercüme için maksimum sürtme hızını, ilk atadan Scale ve Offset ile bir kombinasyon olarak tanımlar ScreenGui veya SurfaceGui ait olan UIDragDetector .Bu değer pozitif olmalı ve 0 'nin altındaki herhangi bir değer 0 'a sıkıştırılacaktır.
SelectionModeRotateSpeed
UIDragDetector'nin dönebileceği maksimum açıyı saniye başına tanımlar.Bu değer pozitif olmalı ve 0 'nin altındaki herhangi bir değer 0 'a sıkıştırılacaktır.
Yöntemler
AddConstraintFunction
Önerilen hareketi değiştirmek veya sınırlandırmak için bir işlev ekler.İşlev bir giriş alır (pozisyon) ve önerilen önerilen hareketin göreceli hızını (döndürme) ve değiştirilmiş veya değiştirilmemiş hareketin yüzdesini döndürür ve önerilen hareketin veya değiştirilmemiş hareketin yüzdesini döndürür.priority sırayla çağrılacak birden fazla işlev ekleyebilirsiniz, sonuçları bir zincir boyunca geçirerek.
Giriş, DragSpace özelliği tarafından tanımlanan alanda bir delta veya DragRelativity özelliğine dayalı son istenen pozisyon/döndürme olarak ifade edilir.Çıkış, belirtilen bir Enum.UIDragDetectorDragRelativity ve Enum.UIDragDetectorDragSpace üçüncü ve dördüncü dönüş değeri olarak geri döndürülmediği sürece aynı uzay ve relatiflikte ifade edilmelidir.
Eklendi bir kısıtlayıcı işlevi kaldırmak için, döndürülen bağlantı nesnesine Disconnect() çağrınız.
Parametreler
Bu yöntem aracılığıyla eklenen işlevlerin öncelik sırası. Daha yüksek değerler daha düşük değerlerden önceliklidir.
Önerilen hareketi değiştirmek veya sınırlamak için işlev.Bu işlev girişi alır ve önerilen önerilen hareketin yüzünü ve düzeltilmiş veya düzeltilmemiş hareketin yüzünü döndürür.Opsiyonel olarak üçüncü ve dördüncü dönüş değerleri olarak bir Enum.UIDragDetectorDragRelativity ve Enum.UIDragDetectorDragSpace üçüncü ve dördüncü dönüş değerleri olarak çıktı geçersizleştirmeleri olarak geri dönebilir.
Dönüşler
Kısıtlama işlevini kaldırmak için bu bağlantı nesnesini kullanın.
GetReferencePosition
Hiçbir ayarı ayarla, bu işlev çekilen nesnenin hemen altındaki ebeveyn pozisyonunu (eğer varsa) veya çekilen nesnenin pozisyonunu döndürür (eğer varsa).
Bir ReferenceUIInstance ayarlandığında, bu işlev o referans durumUDim2 konumunu döndürür.
Dönüşler
GetReferenceRotation
Hiçbir ReferenceUIInstance ayarla, bu işlev çekilen nesnenin hemen önceki ebeveynine GuiObject (eğer bir tane varsa) veya çekilen nesnenin dönüşünü döndürür.
Bir ReferenceUIInstance ayarlandığında, bu işlev bu referans durumdönüşünü döndürür.
Dönüşler
Mevcut sürüklemenin referans elemanının dönüşü.
SetDragStyleFunction
DragStyle ayarlanırsa ve sadece Enum.UIDragDetectorDragStyle.Scriptable kullanılacak bir işlev geçer.Verilen işlev, sinyalin ekran alan giriş pozisyonunu ile alır ve sürüklemenin istediği hareketini içeren bir (pozisyon) ve yüzüğü yüzen bir döndürür.Geri dönüş değerlerinin uzayı ve hareketin relativitesi, belirtilen üçüncü ve dördüncü dönüş değerleri olarak döndürülmediği sürece DragSpace ve DragRelativity özellikleri tarafından belirlenir, üçüncü ve dördüncü dönüş değerleri olarak belirtilen belirli bir Enum.UIDragDetectorDragRelativity ve Enum.UIDragDetectorDragSpace ile değiştirilmediği sürece.
Eğer işlev nil döndürürse, nesne taşınmayacaktır.Bu, senaryo doğru cevabı vermek için henüz tüm bilgileri toplamadıysa veya nesnenin olduğu yerde kalmasını istediğiniz geçici durumlarda yararlıdır.
Parametreler
DragContinue sinyalleri.Bu işlev, sinyalin ekran alanı giriş pozisyonunu alır ve istenen hareketin istediği uzayda ve relativitede istediği hızı ve yüzdesini içeren bir UDim2 ve yüzdesini döndürür.Bu işlev nil dönerse, nesne taşınmayacaktır.
Dönüşler
Etkinlikler
DragContinue
Bir kullanıcı, DragStart başlatıldıktan sonra UI öğesini sürüklemeyi sürdürdüğünde ateş eder.
Parametreler
DragEnd
Bir kullanıcı UI öğesini sürüklemeyi bıraktığında ateş eder.