UIDragDetector

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

UIドラッグディテクター インスタンスは、スライダーやスピナーなど、エクスペリエンスで 2D ユーザーインターフェイス要素とのインタラクションを容易にし、促進します。キー機能には以下があります:

  • Place a UIDragDetector under any GuiObject instance to make it dragable via all inputs without a single line of coコードe.

  • 複数の DragStyle オプションから選択し、オブジェクトがモーションに応答する方法を ResponseStyle で定義し、オプションでアクシス、移動限制、またはドラッグボーダーを適用します。

  • スクリプトは、ドラッグオブジェクトを操作してロジックレポートをドライブするなど、設定を調整するなどのロジックの返信をドライブすることができます。

  • UIDragDetectors は Studio で作動し、 選択移動 、0> スケール0> 、または 3> ロート3> ツールを使用していない限り、6> ロート6> ツール、または Studio の UIDragDetectors9> エディタツー

概要

プロパティ

  • 並列読み取り

    マウスがこの UIDragDetector の上にあるときにカーソルアイコンを表示するように設定します。

  • 探知器の Class.UIDragDetector.boundingUI|boundingUI が設定されたときにドラッグされた UI オブジェクトのバインディング動作を設定する定します。

  • 並列読み取り

    バインディングエリアが親 GuiObject のドラッグボーダーを定義するインスタンス。

  • CursorIcon:ContentId
    並列読み取り

    この UIDragDetector の親にカーソルポインタを表示するときにカーソルアイコンを設定します。

  • 並列読み取り

    Class.UIDragDetector.DragStyle|DragStyle インスタンスのドラッグアクスIS、DragStyle が設定されているとき、Enum.UIDragDetectorDragStyle.TranslateLine にドラッグスタイルを変換します。

  • カスタムドラッグ関数からの入力/出力の関係を定義するパラダイムを設定します。

  • 並列読み取り

    現在のドラッグによって実行される回転。

  • カスタムドラッグ関数からの入力/出力のスペースを定義するパラダイムを設定します。

  • 提案された動作を生成するパラダイム。

  • 並列読み取り

    現在のドラッグが UDim2 値に表示されているように、翻訳を実行します。

  • 並列読み取り

    ユーザーの入力に応答するかどうか。UIDragDetector

  • 並列読み取り

    Class.UIドラッグディテクター.MinDragAngle|MinDragAngle と Class.UIドラッグディテクター.MinDragAngle を併用すると、 Class.UIドラッグディテクター.MinDragAngle 1>Class.UIドラッグディテクター.MinDragAngle1> を生成することを妨げることができます。

  • 並列読み取り

    Class.UIドラッグディテクター.MinDragTranslation|MinDragTranslation と Class.UIドラッグディテクター.MinDragTranslation を組み合わせて、ディテクターのリニア/プラナーの動きを生成する試みを阻止します。

  • 並列読み取り

    Class.UIdragDetector.MaxDragAngle|MaxDragAngle と共に、Class.UIdragDetector.MaxDragAngle|MaxDragAngle の試みを阻止します。

  • 並列読み取り

    Class.UIドラッグディテクター.MaxDragTranslation|MaxDragTranslation と Class.UIドラッグディテクター.MaxDragTranslation を併用すると、ディテクターのリニア/プラナーの動きを生成する試みを阻止します。

  • 並列読み取り

    Class.GuiObject インスタンスの場合、ローカルスペースと絶対中央位置は探知器の参照スペースとオリジンです。

  • 提案された動作に対する応答を定義するパラダイム。

  • 並列読み取り

    翻訳のための最大ドラッグ速度。

  • 秒あたり最大角度は、UIDragDetector が回転できます。

  • Enum.UIDragSpeedAxisMapping 値は、 X / Y 次元のドラッグ速度を決定します。

方法

イベント

  • ユーザーが Class.UIDragDetector.DragStart|DragStart が初期化された後に UI 要素を引き続きドラッグすると、ファイアが発生します。

  • ユーザーが UI 要素をドラッグしていないときに発動します。

  • ユーザーが UI 要素をドラッグし始めると、ファイアが発生します。

プロパティ

ActivatedCursorIcon

ContentId
並列読み取り

マウスがこの UIDragDetector の上にあるときにカーソルアイコンを表示するように設定します。このプロパティを空の場合は、ディテクターはデフォルトのアイコンを使用します。

アクティブなカーソルアイコンを変更するには、このプロパティを使用している画像のアセット ID に設定します。

並列読み取り

探知機の BoundingUI が設定されたとき、ドラッグ UI オブジェクトの境界行動を決定します。探知機の Enum.UIDragDetectorBoundingBehavior に関する詳細は、枚数.UIDragWindowBoundingBehaviour を参照してください。

BoundingUI

並列読み取り

設定する定されると、UIDragDetector インスタンスは、親の GuiObject をバウンド UI インスタンスの外にドラッグすることを許可しません。

GuiObject の一部が バウンディングUI の境界の外にある場合、ドラッグ開始時の最初の入力位置とドラッグ中の相対位置は、ドラッグオブジェクト全体が境界内にあるまで、境界検知用に使用されます。その後、オブジェクトは境界内に制限されます。

CursorIcon

ContentId
並列読み取り

この UIDragDetector の親にカーソルポインターを表示するときにカーソルアイコンを設定します。このプロパティを空の場合、ディテクターはデフォルトのアイコンを使用します。

カーソルアイコンを変更するには、このプロパティを使用したい画像のアセット ID に設定します。

DragAxis

並列読み取り

Vector2 値は、DragStyleEnum.UIDragDetectorDragStyle.TranslateLine に設定されているときにドラッグオブジェクトの軸を定義し

並列読み取り

Class.UIドラッグディテクター: Class.UIDragDetector: SetDragStyleFunction()| Class.UIDragDetector: AddConstraintFunction() または AddConstraintFunction() を通じて、カスタムドラッグ関数を登録した場合にのみ適用されます。パラダイムは、登録された関数の入力/出力のレラビティを定義するドラッグディテクターのパラダイ

DragRotation

並列読み取り

現在のドラッグによって実行される回転。この値は、UIDragDetector 以外のローカルスペースの ReferenceUIInstance の場合、または、Class.UIDragDetector の場合、その回転をローカルスペースの 2>UIDragDetector2> の中から、およびその正の X

このプロパティは、ドラッグしたオブジェクトを回転するためのアクティブなドラッグがない場合に変更できます。

並列読み取り

Class.UIドラッグディテクター: Class.UI拖行スタイル関数を設定 または Class.UI拖行スタイル関数 を通じて、カスタムドラッグ関数を登録した場合にのみ適用されます。パラダイムを設定し、登録された関数の入力/出力のスペースを定義します。

たとえば、Class.GuiObject の親 GuiObject が、Class.GuiObject の親 1>Class.GuiObject1> の子である場合:

  • Datatype.UDim2.fromOffset(1, 0) を含むレジストラクションから Enum.UIDragDetectorDragSpace.Parent の親を移動すると、GuiObject の親をローカルスペースの影響を受けた 1>Enum.UI拖空.Parent1> に移動します。

  • Datatype.UDim2.fromOffset(1, 0) を含むレジストラクションのプロパティセットを Enum.UIDragDetectorDragSpace.LayerCollector に返すと、GuiObject のディテクタの親 1>Class.GuiObject1> が、4>Class.层Collector4> のスペースに

並列読み取り

提案された動作を生成するために使用されるパラダイム、入力位置ベクトルのストリームを与えます。オプションは、Enum.UIDragDetectorDragStyle を参照してください。

DragUDim2

並列読み取り

現在のドラッグが UDim2 の値に表示された翻訳を行います。翻訳は Offset または Scale

このプロパティは、ドラッグしたオブジェクトを移動するためのアクティブなドラッグがない場合に変更できます。

Enabled

並列読み取り

If true は、ユーザーの入力に応答します。If UIDragDetector は、応答しません。

MaxDragAngle

並列読み取り

このプロパティが MinDragAngle より大きい場合、回転は MinDragAngleMaxDragAngle の範囲内に収まります。ポジティブ値はクロック方向の回�

これは制限ではありません;単に、探知機の試みを制限するためにモーションを生成するためのディテクターの試みを妨げます。を参照してAddConstraintFunction() をドラッグに追加します。

Class.UIドラッグディテクター.DragStyle|DragStyle が Enum.UIDragDetectorDragStyle.Rotate である場合にのみ関連します。

MaxDragTranslation

並列読み取り

Class.UIDragDetector.MinDragTranslation|MinDragTranslation と/または Scale の値が、すべての次元で MinDragTranslation と 1>

これは制限ではありません;単に、探知機の試みを制限するためにモーションを生成するためのディテクターの試みを妨げます。を参照してAddConstraintFunction() をドラッグに追加します。

Only relevant if DragStyleEnum.UIDragDetectorDragStyle.TranslateLine または Enum.UIDragDetectorDragStyle.TranslatePlane です。

MinDragAngle

並列読み取り

このプロパティが MaxDragAngle 以下の範囲内にある場合、回転は MinDragAngleMaxDragAngle の範囲内にあります。ポジティブ値はクロック方

これは制限ではありません;単に、探知機の試みを制限するためにモーションを生成するためのディテクターの試みを妨げます。を参照してAddConstraintFunction() をドラッグに追加します。

Class.UIドラッグディテクター.DragStyle|DragStyle が Enum.UIDragDetectorDragStyle.Rotate である場合にのみ関連します。

MinDragTranslation

並列読み取り

Class.UDim.MaxDragTranslation|MaxDragTranslation と/または Scale の値が、すべての次元で MaxDragTranslation の範囲内に含

これは制限ではありません;単に、探知機の試みを制限するためにモーションを生成するためのディテクターの試みを妨げます。を参照してAddConstraintFunction() をドラッグに追加します。

Only relevant if DragStyleEnum.UIDragDetectorDragStyle.TranslateLine または Enum.UIDragDetectorDragStyle.TranslatePlane です。

ReferenceUIInstance

並列読み取り

Class.GuiObject インスタンスのローカルスペースと絶対中心位置は、DragUDim2 の参照スペースであり、この参照スペースに設定すると、DragRotation 、<

並列読み取り

提案された動きが計算され、可能に制限された場合、このパラダイムは、GuiObject を含む UIDragDetector が影響を受ける Enum.UIDragDetectorResponseStyle の移動方法を決定するために使用されます。2>Enums.UIDragDetectorResponseStyle2> にオプションがあります。

SelectionModeDragSpeed

並列読み取り

最大ドラッグ速度を ScaleOffset の組み合わせで定義します。これは、最初の祖先の ScreenGui または

SelectionModeRotateSpeed

並列読み取り

IDUDRAGDECTOR が回転できる最大角度を秒あたりで定義します。この値は正数である必要があり、0 以下の値は 0 に収まります。

UIDragSpeedAxisMapping

並列読み取り

Enum.UIDragSpeedAxisMapping 値は、 X / Y 次元のドラッグ速度を決定します。

方法

AddConstraintFunction

提案された動作を変更または制限する機能を追加します。機能は、UDim2 (位置) とDatatype.UDim2 (回転) の入力を受信し、UDim2 と2> Datatype.UDim22>

入力は、DragSpace プロパティのデルタまたは最終目的位置/回転に基づいて表現されます。 Class.UIDragDetectorDragRelativity プロパティのデルタ

追加の制限関数を削除するには、Disconnect() を返された接続オブジェクトに呼び出します。

パラメータ

priority: number

このメソッドを介して追加された関数の優先度のオーダー。上の値は、下の値より優先されます。

function: function

機能は、提案された動作を変更または制限するための機能です。この機能は、入力 UDim2 と浮動の 提案された動作 との間のフロートを取得し、 Dat


戻り値

この接続オブジェクトを使用して、制限関数を削除します。

GetReferencePosition

Class.UIragDetector.ReferenceUIInstance|ReferenceUIInstance が設定する定されていないとき、この関数は、ドラッグオブジェクトの即座の親 UDim2 (ある場合) の位置を返します。GuiObject (場合があります)、またはドラッグオブジェクトの位置を返します。

Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance が設定する定されると、この関数は、その参照インスタンスの UDim2 位置を返します。


戻り値

UDim2 現在のドラッグの参照エレメントの位置。

GetReferenceRotation

Class.UIragDetector.ReferenceUIInstance|ReferenceUIInstance が設設定するされていない場合、この関数は、ドラッグオブジェクトの即座の親 GuiObject (ある場合) またはドラッグオブジェクトの即座の親の回転を返します (ドラッグオブジェクトが存在する場合)。

Class.UIDragDetector.ReferenceUIInstance|ReferenceUIInstance が設定する定されると、この関数はその参照インスタンスの回転を返します。


戻り値

現在のドラッグの参照エレメントの回転。

SetDragStyleFunction

void

Class.UIDragDetector.DragStyle|DragStyle が Enum.UIDragDetectorDragStyle.Scriptable に設定されている場合、 Datatype. Vector

関数が nil を返すと、オブジェクトは移動されません。これは、スクリプトが正しい答えを提供する必要がある場合、または一時的にオブジェクトを保持しておく必要がある場合に便利です。

パラメータ

function: function

モニタリングの機能は、DragContinue 信号のモニタリングをモニタリングします。この機能は、シンガルの画面スペース入力位置を受信し、UDim2 と浮動を含むドラッグの必要な動きを必要なスペースとレリティの両方で返


戻り値

void

イベント

DragContinue

ユーザーが Class.UIDragDetector.DragStart|DragStart が初期化された後に UI 要素を引き続きドラッグすると、ファイアが発生します。

パラメータ

inputPosition: Vector2

Vector2 は、現在の入力位置を表示します。


DragEnd

ユーザーが UI 要素をドラッグしていないときに発動します。

パラメータ

inputPosition: Vector2

Vector2 は、現在の入力位置を表示します。


DragStart

ユーザーが UI 要素をドラッグし始めると、ファイアが発生します。

パラメータ

inputPosition: Vector2

Vector2 は、現在の入力位置を表示します。