Version: 2018.1

Dropdown

class in UnityEngine.UI

/

継承:UI.Selectable


実装インターフェース:ICancelHandler, IEventSystemHandler, IPointerClickHandler, ISubmitHandler

マニュアルに切り替える

説明

クリックされると選択肢のリストが表示され、その中の1つを選択できる標準的なドロップダウンです。

Dropdown コンポーネントは Selectable を継承しています。あるオプションが選択されると、コントロールUIのラベルや、画像が選択されたオプションのものに変わります。

ドロップダウンのイベントが発生すると、 onValueChanged に登録されているすべてのリスナーにコールバックが送信されます。

変数

captionImage現在選択されているオプションの画像を保持する Image コンポーネント
captionText現在選択されているオプションのテキストを保持する Text コンポーネント
itemImage要素の画像を保持する Image コンポーネント
itemText要素のテキストを保持する Text コンポーネント
onValueChangedユーザーがドロップダウンリストのオプションをクリックしたときに実行される UnityEvent
options利用可能なオプションのリスト。テキスト文字列と画像はそれぞれのオプション用に指定することができます。
templateドロップダウンリストに使用するテンプレートの Rect Transform
valueThe Value is the index number of the current selection in the Dropdown. 0 is the first option in the Dropdown, 1 is the second, and so on.

Public 関数

AddOptionsOptionData オブジェクトのリストに基づいてドロップダウンのオプションに複数のオプションを追加します。
ClearOptionsドロップダウンのオプションのリストをクリアします。
Hideドロップダウンリストを非表示にします。
OnCancelキャンセルイベントが発生したときに BaseInputModule によって呼び出されます。
OnPointerClickドロップダウンを 'クリックした' ときのイベントを処理します。
OnSubmitイベントシステムが Submit イベントを送信するときに実行されます。
RefreshShownValue現在選択されているオプションの(利用可能な)画像を保持する Image コンポーネントオプションのリストを変更した場合、その後ドロップダウンの表示状態が更新されたオプションに対応していることを確認するこのメソッドを呼び出す必要があります。
Showドロップダウンリストを表示します。

Protected 関数

CreateBlockerこのメソッドをオーバーライドすることで、ブロッカーゲームオブジェクトの取得方法を変えることができます。
CreateDropdownListこのメソッドをオーバーライドすることで、ドロップダウンリストゲームオブジェクトの取得方法を変更することができます。
CreateItemこのメソッドを上書きすることでオプション要素の取得方法を変更できます。
DestroyBlockerこのメソッドをオーバーライドすることで、ドロップダウンリストが開いている間は他のコントロールUIのクリックを防ぐブロッカーゲームオブジェクトの破棄方法を変えることができます。
DestroyDropdownListこのメソッドをオーバーライドすることで、ドロップダウンリストゲームオブジェクトの破棄方法を変更することができます。
DestroyItemこのメソッドを上書きすることで、オプション要素の破棄方法を変更することができます。

継承メンバー

Static 変数

allSelectablesシーン内で現在アクティブなすべての Selectable オブジェクトのリスト

変数

enabled有効であれば更新され、無効であれば更新されません。
isActiveAndEnabledBehaviour が有効かどうか
gameObjectこのコンポーネントはゲームオブジェクトにアタッチされます。コンポーネントはいつもゲームオブジェクトにアタッチされています。
tagゲームオブジェクトのタグ
transformThe Transform attached to this GameObject.
runInEditModeAllow a specific instance of a MonoBehaviour to run in edit mode (only available in the editor).
useGUILayoutこれを無効にすると、GUI のレイアウトフェーズをスキップすることができます
hideFlagsオブジェクトは非表示、シーンに保存、ユーザーが編集可能、などを設定する。
nameオブジェクト名
animationTriggersこの Selectable オブジェクトのための AnimationTriggers
animatorゲームオブジェクトの Animator コンポーネントを取得するための便利関数
colorsこの Selectable オブジェクトのための ColorBlock
image参照されたグラフィックを Image に変換する便利な関数
interactableUse to enable or disable the ability to select a selectable UI element (for example, a Button).
navigationこの Selectable オブジェクトへの Navigation 設定
spriteStateこの Selectable オブジェクトのための SpriteState
targetGraphic遷移使用されるグラフィック
transitionステートが変更するときに targetGraphic に適用される遷移の種類

Public 関数

BroadcastMessageゲームオブジェクトまたは子オブジェクトにあるすべての MonoBehaviour を継承したクラスにある methodName 名のメソッドを呼び出します。
CompareTagこのゲームオブジェクトは tag とタグ付けされているかどうか
GetComponentゲームオブジェクトに type がアタッチされている場合は type のタイプを使用してコンポーネントを返します。ない場合は null です
GetComponentInChildren GameObject や深さ優先探索を活用して、親子関係にある子オブジェクトから type のタイプのコンポーネントを取得します。
GetComponentInParent GameObject や深さ優先探索を活用して、親子関係にある親オブジェクトから type のタイプのコンポーネントを取得します。
GetComponents GameObject から type のタイプのコンポーネントを「すべて」取得します。
GetComponentsInChildren GameObject や深さ優先探索を活用して、親子関係にある子オブジェクトから type のタイプのコンポーネントを「すべて」取得します。
GetComponentsInParent GameObject や深さ優先探索を活用して、親子関係にある親オブジェクトから type のタイプのコンポーネントを「すべて」取得します。
SendMessageゲームオブジェクトにアタッチされているすべての MonoBehaviour にある methodName と名付けたメソッドを呼び出します
SendMessageUpwardsゲームオブジェクトと親(の親、さらに親 ... )にアタッチされているすべての MonoBehaviour にある methodName と名付けたメソッドを呼び出します
CancelInvokeすべての Invoke をキャンセルします
Invoke設定した時間(単位は秒)にメソッドを呼び出します
InvokeRepeating設定した時間(単位は秒)にメソッドを呼び出し、repeatRate 秒ごとにリピートします
IsInvokingメソッドの呼出が保留中かどうか
StartCoroutineコルーチンを開始します
StopAllCoroutinesBehaviour 上で実行されているコルーチンをすべて停止します
StopCoroutineこの Behaviour 上で実行されている methodName という名のコルーチン、または routine として保持されているコルーチンをすべて停止します
GetInstanceIDオブジェクトのインスタンス ID を返します
ToStringReturns the name of the GameObject.
FindSelectableこの次の Selectable オブジェクトを一つ検索します
FindSelectableOnDown下にある Selectable オブジェクトを一つ検索します
FindSelectableOnLeftこのオブジェクトの左にある Selectable オブジェクトを一つ検索します
FindSelectableOnRightこのオブジェクトの右にある Selectable オブジェクトを一つ検索します
FindSelectableOnUpこのオブジェクトの上にある Selectable オブジェクトを検索します
IsInteractableUI.Selectable.IsInteractable
OnDeselect設定解除し、適切なステートへ遷移します
OnMove次の Selectable オブジェクトを見つける方向を 4 つの移動方向から決定します
OnPointerDown現在の状態と、Pressed (押され)ステートへの遷移を評価します
OnPointerEnter現在のステートと、適切なステートへの遷移を評価します
OnPointerExit現在のステートと通常ステートへの遷移を評価します
OnPointerUpeventData と適切なステートへの遷移を評価します
OnSelect選択と適切なステートへの遷移を設定します
Selectこの Selectable を選択します
IsActive GameObject と Component がアクティブになっている場合は true を返します。
IsDestroyedネイティブ表示の振る舞いが破棄された場合は true を返します。

Protected 関数

DoStateTransitionSelectable を入力されたステートへ遷移させます
InstantClearState(無効のときに使用される) Selectable の内部状態をクリアします
IsHighlightedReturns whether the selectable is currently 'highlighted' or not.
IsPressedWhether the current selectable is being pressed.
OnDisable MonoBehaviour.OnDisable を参照してください。
UpdateSelectionState内部的に Selectable の選択状態を更新します
Awake MonoBehaviour.Awake を参照してください
OnBeforeTransformParentChangedMonoBehaviour.OnBeforeTransformParentChanged を参照してください
OnCanvasGroupChangedMonoBehaviour.OnCanvasGroupChanged を参照してください
OnCanvasHierarchyChanged親の Canvas の状態が変更されたとき呼び出されます。
OnDestroy MonoBehaviour.OnDestroy を参照してください
OnDidApplyAnimationProperties LayoutGroup.OnDidApplyAnimationProperties を参照してください
OnDisable MonoBehaviour.OnDisable を参照してください。
OnEnable MonoBehaviour.OnEnable を参照してください
OnRectTransformDimensionsChangeThis callback is called if an associated RectTransform has its dimensions changed.
OnTransformParentChangedMonoBehaviour.OnRectTransformParentChanged を参照してください
OnValidate MonoBehaviour.OnValidate を参照してください
Reset MonoBehaviour.Reset を参照してください
Start MonoBehaviour.Start を参照してください

Static 関数

printUnity コンソールにログを出力します (Debug.Log と同じです)
Destroyゲームオブジェクトやコンポーネント、アセットを削除します
DestroyImmediateDestroys the object obj immediately. You are strongly recommended to use Destroy instead.
DontDestroyOnLoad新しいシーンを読み込んでもオブジェクトが自動で破壊されないように設定します
FindObjectOfTypeタイプ type から最初に見つけたアクティブのオブジェクトを返します
FindObjectsOfTypeタイプから見つけたすべてのアクティブのオブジェクト配列を返します
Instantiateoriginal のオブジェクトをクローンします

Operator

boolオブジェクトが存在するかどうか
operator !=二つのオブジェクトが異なるオブジェクトを参照しているか比較します
operator ==2つのオブジェクト参照が同じオブジェクトを参照しているか比較します。

メッセージ

Awakeスクリプトのインスタンスがロードされたときに呼び出されます
FixedUpdateFrame-rate independent MonoBehaviour.FixedUpdate message for physics calculations.
LateUpdate Behaviour が有効の場合、LateUpdate は毎フレーム呼びだされます
OnAnimatorIKアニメーション IK (インバースキネマティクス)をセットアップするときのコールバック
OnAnimatorMoveルートモーションを修正するアニメーション動作を処理するコールバック
OnApplicationFocusプレイヤーがフォーカスを取得、または、失ったときに、すべてのゲームオブジェクトに送信されます。
OnApplicationPauseプレイヤーが一時停止したときにすべてのゲームオブジェクトに送信されます
OnApplicationQuitSent to all game objects before the application quits.
OnAudioFilterReadOnAudioFilterRead が実装されている場合、Unity は DSP チェーンにカスタムフィルターを挿入します。
OnBecameInvisibleOnBecameInvisible はレンダラーがカメラから見えなくなったときに呼び出されます
OnBecameVisibleOnBecameVisible はレンダラーが任意のカメラから見えるようになると呼び出されます
OnCollisionEnterこの collider/rigidbody は他の collider/rigidbody に触れたときに OnCollisionEnter は呼び出されます。
OnCollisionEnter2Dオブジェクトのコライダーが別のコライダーに衝突したときに呼び出されます(2D 物理挙動のみ)
OnCollisionExitこの collider/rigidbody が他の collider/rigidbody と触れ合うのをやめたときに OnCollisionExit は呼び出されます。
OnCollisionExit2Dオブジェクトのコライダーと別のオブジェクトコライダーが衝突から離れた瞬間に呼び出されます(2D 物理挙動のみ)
OnCollisionStay:ref::OnCollisionStay is called once per frame for every collider/rigidbody that is touching rigidbody/collider.
OnCollisionStay2Dオブジェクトのコライダーと別のオブジェクトのコライダーが衝突している間、毎フレーム呼び出され続けます(2D 物理挙動のみ)
OnConnectedToServerサーバーとの接続に成功したときにクライアント上で呼び出されます
OnControllerColliderHitOnControllerColliderHit はキャラクターコントローラーが移動中にコライダーに衝突した際に、呼び出されます。
OnDestroyDestroying the attached Behaviour will result in the game or scene receiving OnDestroy.
OnDisableThis function is called when the behaviour becomes disabled.
OnDisconnectedFromServerサーバーとの接続が失われたか切断されたときにクライアント上で呼び出されます
OnDrawGizmos選択可能にしたり、常に描画したいギズモを描画するには OnDrawGizmos を使用します
OnDrawGizmosSelectedオブジェクトが選択されている場合は、ギズモを描画するために OnDrawGizmosSelected を実装します。
OnEnableこの関数はオブジェクトが有効/アクティブになったときに呼び出されます
OnFailedToConnect接続試行がなんらかの理由で失敗したときにクライアント上で呼び出されます
OnFailedToConnectToMasterServerMasterServer への接続に問題がある場合に、クライアントまたはサーバーで呼び出されます
OnGUIOnGUI はレンダリングと GUI イベントのハンドリングのために呼び出されます
OnJointBreakゲームオブジェクトに対するジョイントが外れたとき呼び出されます
OnJointBreak2Dゲームオブジェクトにアタッチした Joint2D が壊れたときに呼び出されます。
OnMasterServerEventMasterServer からイベントを報告してくるときにクライアントやサーバー上で呼び出されます。
OnMouseDown OnMouseDown is called when the user has pressed the mouse button while over the GUIElement or Collider.
OnMouseDragOnMouseDrag はユーザーが GUIElement または Collider をマウスでクリックし、ドラッグしている間呼び出されます。
OnMouseEnterOnMouseEnter は GUIElement または Collider 上にマウスが乗ったときに呼び出されます
OnMouseExitOnMouseExit は GUIElement または Collider 上からマウス離れたときに呼び出されます
OnMouseOverOnMouseOver は GUIElement または Collider 上にマウスがあり続ける限り毎フレーム呼び出され続けます
OnMouseUpOnMouseUp はユーザーがマウスボタンを離したときに呼び出されます
OnMouseUpAsButtonOnMouseUpAsButton はマウスを押した時と同じ GUIElement や Collider 上でマウスを離した時のみに呼び出されます。
OnNetworkInstantiateNetwork.Instantiate でインスタンス化されたオブジェクトに対して呼び出されます
OnParticleCollisionパーティクルがコライダーにヒットしたときに OnParticleCollision が呼び出されます
OnParticleTriggerOnParticleTrigger は、パーティクルシステムのパーティクルが Triggers モジュールの条件を満たすときに呼び出されます。
OnPlayerConnected新しいプレイヤーが接続に成功したときにサーバー上で呼び出されます
OnPlayerDisconnectedプレイヤーがサーバーから接続が切断されるたびにサーバー上で呼び出されます
OnPostRenderOnPostRender はカメラがシーンのレンダリングを完了した後に呼び出されます
OnPreCullOnPreCull はカメラがシーンのカリングを行う直前に呼び出されます。
OnPreRenderOnPreRender はカメラがシーンのレンダリングを開始する前に呼び出されます。
OnRenderImageOnRenderImage はすべてのレンダリングが RenderImage へと完了したときに呼び出されます。
OnRenderObjectOnRenderObject はカメラがシーンをレンダリングした後に呼び出されます。
OnSerializeNetworkViewネットワークビューによって監視されるスクリプトの変数の同期をカスタマイズするために使用します
OnServerInitializedNetwork.InitializeServer が実行され完了したときにサーバー上で呼び出されます
OnTransformChildrenChangedこの関数は GameObject の Transform のすべての子の中で変更があったときに呼び出されます
OnTransformParentChangedこの関数は GameObject の Transform の parent プロパティーに変更があったときに呼び出されます
OnTriggerEnter Collider が他のトリガーイベントに侵入したときに OnTriggerEnter が呼び出されます。
OnTriggerEnter2Dオブジェクトにアタッチしたトリガーの中に別のオブジェクトが入ったときに呼び出されます。(2D 物理挙動のみ)
OnTriggerExit Collider が other のトリガーに触れるのをやめたときに OnTriggerExit は呼び出されます。
OnTriggerExit2Dトリガー状態のオブジェクトのコライダーと別のオブジェクトのコライダーが衝突から離れた瞬間に、呼び出されます。(2D 物理挙動のみ)
OnTriggerStayOnTriggerStay is called once per physics update for every Collider other that is touching the trigger.
OnTriggerStay2Dトリガー状態のオブジェクトのコライダーと別のオブジェクトのコライダー衝突している間、毎フレーム呼び出され続けます。(2D 物理挙動のみ)
OnValidateこの関数はスクリプトがロードされた時やインスペクターの値が変更されたときに呼び出されます(この呼出はエディター上のみ)
OnWillRenderObjectOnWillRenderObject is called for each camera if the object is visible and not a UI element.
Resetデフォルト値にリセットします
StartStart is called on the frame when a script is enabled just before any of the Update methods are called the first time.
UpdateUpdate は MonoBehaviour が有効の場合に、毎フレーム呼び出されます