UIDragDetector

Artık kullanılmayanları göster

*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

Yöntemler

Etkinlikler

Özellikler

ActivatedCursorIcon

ContentId
Paralel oku

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.

Paralel oku

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

Paralel oku

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

ContentId
Paralel oku

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

Paralel oku

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.

Paralel oku

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

Paralel oku

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.

Paralel oku

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.

Paralel oku

Ö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

Paralel oku

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.

Enabled

Paralel oku

Eğer true , UIDragDetector kullanıcı girişine yanıt verir; eğer false , yapmaz.

MaxDragAngle

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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

Paralel oku

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.

Paralel oku

Ö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

Paralel oku

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

Paralel oku

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.

UIDragSpeedAxisMapping

Paralel oku

X / Y boyut sürükleme hızlarını belirleyen değer.

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

priority: number

Bu yöntem aracılığıyla eklenen işlevlerin öncelik sırası. Daha yüksek değerler daha düşük değerlerden önceliklidir.

Varsayılan değer: ""
function: function

Ö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.

Varsayılan değer: ""

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

UDim2 mevcut sürüklemenin referans elemanının pozisyonu.

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

function: function

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.

Varsayılan değer: ""

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

inputPosition: Vector2

Vector2 mevcut giriş pozisyonunu temsil ediyor.


DragEnd

Bir kullanıcı UI öğesini sürüklemeyi bıraktığında ateş eder.

Parametreler

inputPosition: Vector2

Vector2 mevcut giriş pozisyonunu temsil ediyor.


DragStart

Bir kullanıcı UI öğesini sürüklemeye başladığında ateş eder.

Parametreler

inputPosition: Vector2

Vector2 mevcut giriş pozisyonunu temsil ediyor.