UIDragDetector
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
L'istanza UIDragDetector facilita e incoraggia l'interazione con gli elementi dell'interfaccia utente 2D in un'esperienza, come gli slider e gli spinner. Le caratteristiche chiave includono:
Posiziona un UIDragDetector sotto qualsiasi GuiObject istanza per renderlo trascinabile attraverso tutti gli input senza una sola riga di codice.
Scegli da più opzioni DragStyle , definisci come l'oggetto risponde alla velocità di movimento tramite ResponseStyle e opzionalmente applica i limiti di asse, limiti di movimento o trascinamento.
Gli script possono rispondere alla manipolazione di oggetti trascinati per generare risposte logiche, come regolare le impostazioni.
UIragDetectors lavora in Studio finché non sei non usando il seleziona , 0> muovi0> , 3> scala3> , o 6> ruota6> strumenti, o alcuni plugin o gli strumenti di Studio UIDragDetectors9>.
Sommario
Proprietà
Imposta l'icona del cursore per visualizzare quando il mouse è attivato sul padre di questo UIDragDetector .
Determina il comportamento di avvio della UI trascinata quando il BoundingUI del detector è Impostare.
Istanza la cui area di confine definisce i limiti di trascinamento per il padre GuiObject .
Imposta l'icona del cursore per visualizzare quando il mouse è passato sul padre di questo UIDragDetector .
L'asse di trascinamento per l'istanza UIDragDetector quando DragStyle è impostato su Enum.UIDragDetectorDragStyle.TranslateLine .
Imposta il paradigma che definisce la relatività degli input/output da una funzione di trascinamento personalizzata.
La rotazione eseguita dal trascinamento corrente.
Imposta il paradigma che definisce lo spazio degli input/output da una funzione di trascinamento personalizzata.
Il paradigma utilizzato per generare la proposta di movimento.
La traduzione eseguita dal trascinamento corrente espresso in un valore UDim2 .
Se il UIDragDetector risponde all'input dell'utente.
Insieme a MinDragAngle , impedisce gli attentati del detector per generare la rotazione.
Insieme a MinDragTranslation , impedisce gli attentati del detector per generare movimenti lineari / planari.
Insieme a MaxDragAngle , impedisce gli attentati del detector per generare la rotazione.
Insieme a MaxDragTranslation , impedisce gli attentati del detector per generare movimenti lineari / planari.
Un'istanza GuiObject il cui spazio locale e posizione centrale assoluta è lo spazio di riferimento e l'origine per il detector.
Il paradigma usato per definire la risposta alla proposta di movimento.
Velocità di trascinamento massima per la traduzione.
Angolo massimo per secondo il UIDragDetector può ruotare a.
Enum.UIDragSpeedAxisMapping valore che determina la velocità diagonale delle dimensioni X / Y .
Metodi
Aggiunge una funzione per modificare o limitare la proposta di movimento.
Restituisce la posizione di riferimento UDim2 della posizione di riferimento della barra attuale.
Restituisce la rotazione di riferimento dell'elemento di riferimento della拖 attuale.
Passa una funzione da utilizzare se e solo se DragStyle è impostato su Enum.UIDragDetectorDragStyle.Scriptable .
Eventi
Si attiva quando un utente continua a trascinare l'elemento UI dopo che DragStart è stato inizializzato.
Si attiva quando un utente smette di trascinare l'elemento UI.
Si attiva quando un utente inizia a trascinare l'elemento UI.
Proprietà
ActivatedCursorIcon
Imposta l'icona del cursore per visualizzare quando il mouse è attivato sul padre di questo UIDragDetector . Se questa proprietà è vuota, il detector userà l'Iconapredefinita.
Per cambiare l'Iconadel cursore attivata, imposta questa proprietà sull'ID risorsa dell'immagine che desideri utilizzare.
BoundingBehavior
Determina il comportamento di avvio della UI trascinata quando il pulsante di avvio del detector è Impostare. Vedi BoundingUI per i dettagli su ogni impostazione.
BoundingUI
Quando è Impostare, l'istanza UIDragDetector non consentirà che i limiti del padre GuiObject vengano trascinati oltre i limiti della parentesi BoundingUI .
Nota che se una parte del padre GuiObject è al di fuori dei confini di BoundingUI , la posizione iniziale di input al trascinamento e la sua posizione relativa durante il trascinamento saranno utilizzate per la rilevazione dei confini fino alla completezza dell'oggetto trascinato, dopo cui l'oggetto sarà limitato all'interno dei confini.
CursorIcon
Imposta l'icona del cursore per visualizzare quando il mouse è passato sul padre di questo UIDragDetector . Se questa proprietà è vuota, il detector userà l'Iconapredefinita.
Per cambiare l'Iconadel cursore, imposta questa proprietà sull'ID risorsa dell'immagine che desideri utilizzare.
DragAxis
Vector2 valore che definisce l'asse di movimento per l'oggetto trascinato quando DragStyle è impostato su Enum.UIDragDetectorDragStyle.TranslateLine . L'asse è
DragRelativity
Si applica solo se una funzione di trascinamento personalizzata è registrata attraverso SetDragStyleFunction() o AddConstraintFunction() . Imposta il paradigma che definisce gli input/Output della funzione registrata.
Ad
DragRotation
La rotazione eseguita dal current drag. Questo valore è definito in gradi rispetto allo spazio locale di UI拖Detector a meno che UIDragDetector non sia definito, in cui caso la rotazione viene definita nello spazio locale di quella istanza e dal suo positivo ReferenceUIInstance asse.
Questa proprietà può essere cambiata mentre non c'è un trascinamento attivo per ruotare l'oggetto trascinato.
DragSpace
Si applica solo se una funzione di trascinamento personalizzata è registrata attraverso SetDragStyleFunction() o AddConstraintFunction() . Imposta il paradigma che definisce lo spazio degli input/Output della funzione registrata.
Ad esempio, se il padre del GuiObject del detector è un figlio di un padre GuiObject che ruota:
Restituire un UDim2.fromOffset(1, 0) da una funzione registrata con questa proprietà impostata su Enum.UIDragDetectorDragSpace.Parent sposterà il genitore del detector in GuiObject a destra di 1 pixel nello spazio locale colpito dalla sua rotazione.
Restituendo un UDim2.fromOffset(1, 0) da una funzione registrata con questa proprietà impostata su Enum.UIDragDetectorDragSpace.LayerCollector sposterà il genitore del detector GuiObject allo spazio del 1> Class.LayerCollector1> .
DragStyle
Il paradigma utilizzato per generare la proposta di movimento, data una serie di vettori di posizione di input. Vedi Enum.UIDragDetectorDragStyle per le opzioni.
DragUDim2
La traduzione viene eseguita dalla corrente trascinata espressa in un valore UDim2 . La traduzione viene eseguita attraverso Offset o Scale cambiamenti
Questa proprietà può essere cambiata mentre non c'è un trascinamento attivo per spostare l'oggetto trascinato.
MaxDragAngle
Se questa proprietà è maggiore di MinDragAngle , la rotazione sarà appiattita all'interno della gamma di MinDragAngle e MaxDragAngle . I valori positivi impediscono la rotazione in senso orario mentre i valori negativi impediscon
Questa non è una Vincolo; impedisce semplicemente le attività del detector per generare la moto per rimanere entro i limiti. Vedi AddConstraintFunction() per aggiungere una limitazione personalizzata a un trascinamento.
Rilevante solo se DragStyle è Enum.UIDragDetectorDragStyle.Rotate .
MaxDragTranslation
Se i valori corrispondenti Offset e/o Scale sono maggiori di quelli di MinDragTranslation in tutte le dimensioni, la traduzione line
Questa non è una Vincolo; impedisce semplicemente le attività del detector per generare la moto per rimanere entro i limiti. Vedi AddConstraintFunction() per aggiungere una limitazione personalizzata a un trascinamento.
Rilevante solo se DragStyle è Enum.UIDragDetectorDragStyle.TranslateLine o Enum.UIDragDetectorDragStyle.TranslatePlane .
MinDragAngle
Se questa proprietà è inferiore a MaxDragAngle , la rotazione sarà appiattita all'interno della gamma di MinDragAngle e MaxDragAngle . I valori positivi impediscono la rotazione in senso orario mentre i valori negativi impediscon
Questa non è una Vincolo; impedisce semplicemente le attività del detector per generare la moto per rimanere entro i limiti. Vedi AddConstraintFunction() per aggiungere una limitazione personalizzata a un trascinamento.
Rilevante solo se DragStyle è Enum.UIDragDetectorDragStyle.Rotate .
MinDragTranslation
Se i valori corrispondenti Offset e/o Scale sono inferiore a quelli di MaxDragTranslation in tutte le dimensioni, la traduzione lineare
Questa non è una Vincolo; impedisce semplicemente le attività del detector per generare la moto per rimanere entro i limiti. Vedi AddConstraintFunction() per aggiungere una limitazione personalizzata a un trascinamento.
Rilevante solo se DragStyle è Enum.UIDragDetectorDragStyle.TranslateLine o Enum.UIDragDetectorDragStyle.TranslatePlane .
ReferenceUIInstance
Un'istanza GuiObject il cui spazio locale e posizione centrale assoluta è lo spazio di riferimento e l'origine per il detector. Impostando questo spazio di riferimento influisce sulle proprietà come DragUDim2 , DragRotation e il comportamento
ResponseStyle
Una volta che la proposta di motozione è stata calcolata e potenzialmente limitata, questo paradigma viene utilizzato per determinare come muovere (o non Sposta) il GuiObject interessato dal UIDragDetector . Vedi Enum.UIDragDetectorResponseStyle per le opzioni.
SelectionModeDragSpeed
Define la velocità di trascinamento massima per la traduzione come combinazione di Scale e Offset del primo antenato ScreenGui o 1> Class.SurfaceGui
SelectionModeRotateSpeed
Difini l'angolo massimo per secondo al quale il UIDragDetector può Rotare. Questo valore deve essere positivo e qualsiasi valore inferiore a 0 sarà agganciato a 0 .
UIDragSpeedAxisMapping
Enum.UIDragSpeedAxisMapping valore che determina la velocità diagonale delle dimensioni X / Y .
Metodi
AddConstraintFunction
Aggiunge una funzione per modificare o limitare la proposta di movimento. La funzione prende un input UDim2 (posizione) e fluttua (rotazione) della proposta di movimento proposta e restituisce un Datatype.UDim2 e fluttua del movimento modificato. Puoi aggiungere più funzioni che verr
L'input viene espresso nello spazio definito dalla proprietà DragSpace , in either come un Delta o la posizione/rotazione desiderata finale in base alla proprietà DragRelativity . L'output dovreb
Per rimuovere una funzione di vincolo aggiunto, chiama Disconnect() sull'oggetto di connessione restituito.
Parametri
L'ordine della priorità per le funzioni aggiunte tramite questo metodo. Valori più alti hanno la precedenza sui valori più bassi.
Restituzioni
Usa questo oggetto di connessione per rimuovere la funzione di restrizione.
GetReferencePosition
Quando non è impostato nessun ReferenceUIInstance è Impostare, questa funzione restituisce la posizione UDim2 della parent di oggetto immediata del oggetto trascinato (se esiste), o la posizione GuiObject dell'oggetto trascinato (se esiste).
Quando un ReferenceUIInstance Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance è Impostare, questa funzione restituisce la posizione UDim2 di quella esempiodi riferimento.
Restituzioni
GetReferenceRotation
Quando non è Impostarenessun ReferenceUIInstance, questa funzione restituisce la rotazione del genitore immediato dell'oggetto trascinato (se esiste uno) o la rotazione dell'oggetto trascinato (altrimenti).
Quando una ReferenceUIInstance è Impostare, questa funzione restituisce la rotazione di quella esempio.
Restituzioni
Rotazione dell'elemento di riferimento della拖 attuale.
SetDragStyleFunction
Passa una funzione da utilizzare se e solo se Class.UIDragDetector.DragStyle|Drag
Se la funzione restituisce nil , l'oggetto non verrà spostato. Questo è utile se lo script non ha ancora raccolto tutte le informazioni di cui ha bisogno per fornire la risposta corretta, o in casi temporanei in cui vuoi che l'oggetto rimanga dove è.
Parametri
Funzione per il monitoraggio DragContinue segnali. Questa funzione riceve la posizione di ingresso dello spazio di lavoro del singolo e restituisce un UDim2 e fluttua contenente la posizione di movimento desiderata nello spazio e relativa. Se questa funzione restituisce nil, l'oggetto non verrà spostato.
Restituzioni
Eventi
DragContinue
Si attiva quando un utente continua a trascinare l'elemento UI dopo che DragStart è stato inizializzato.
Parametri
DragEnd
Si attiva quando un utente smette di trascinare l'elemento UI.