| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238 |
- #pragma once
- #include "BsScriptEditorPrerequisites.h"
- #include "BsGUIElementContainer.h"
- namespace BansheeEngine
- {
- /**
- * @brief GUI object that displays a field in which a GameObject can be dragged and dropped.
- * The field accepts a GameObject of a specific type and displays an optional label.
- */
- class BS_SCR_BED_EXPORT GUIGameObjectField : public GUIElementContainer
- {
- struct PrivatelyConstruct {};
- public:
- /**
- * Returns type name of the GUI element used for finding GUI element styles.
- */
- static const String& getGUITypeName();
- /**
- * @brief Creates a new game object GUI editor field with a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param labelContent Content to display in the editor field label.
- * @param labelWidth Width of the label in pixels.
- * @param options Options that allow you to control how is the element positioned and sized.
- * This will override any similar options set by style.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const GUIContent& labelContent, UINT32 labelWidth, const GUIOptions& options,
- const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field with a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param labelContent Content to display in the editor field label.
- * @param options Options that allow you to control how is the element positioned and sized.
- * This will override any similar options set by style.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const GUIContent& labelContent, const GUIOptions& options,
- const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field with a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param labelText Text to display in the editor field label.
- * @param labelWidth Width of the label in pixels.
- * @param options Options that allow you to control how is the element positioned and sized.
- * This will override any similar options set by style.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const HString& labelText, UINT32 labelWidth, const GUIOptions& options,
- const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field with a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param labelText Text to display in the editor field label.
- * @param options Options that allow you to control how is the element positioned and sized.
- * This will override any similar options set by style.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const HString& labelText, const GUIOptions& options,
- const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field without a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param options Options that allow you to control how is the element positioned and sized.
- * This will override any similar options set by style.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const GUIOptions& options, const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field with a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param labelContent Content to display in the editor field label.
- * @param labelWidth Width of the label in pixels.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const GUIContent& labelContent, UINT32 labelWidth,
- const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field with a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param labelContent Content to display in the editor field label.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const GUIContent& labelContent,
- const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field with a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param labelText Text to display in the editor field label.
- * @param labelWidth Width of the label in pixels.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const HString& labelText, UINT32 labelWidth,
- const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field with a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param labelText Text to display in the editor field label.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const HString& labelText,
- const String& style = StringUtil::BLANK);
- /**
- * @brief Creates a new game object GUI editor field without a label.
- *
- * @param typeNamespace Namespace of the type this field accepts.
- * @param type Type name of the type this field accepts. Must derive from GameObject.
- * @param style Optional style to use for the element. Style will be retrieved
- * from GUISkin of the GUIWidget the element is used on. If not specified
- * default style is used.
- */
- static GUIGameObjectField* create(const String& typeNamespace, const String& type, const String& style = StringUtil::BLANK);
- GUIGameObjectField(const PrivatelyConstruct& dummy, const String& typeNamespace, const String& type, const GUIContent& labelContent,
- UINT32 labelWidth, const String& style, const GUIDimensions& dimensions, bool withLabel);
- /**
- * @brief Returns the game object currently referenced by the field, if any.
- */
- HGameObject getValue() const;
- /**
- * @brief Sets the game object referenced by the field.
- */
- void setValue(const HGameObject& value);
- /**
- * @copydoc GUIElement::setTint
- */
- virtual void setTint(const Color& color) override;
- /**
- * @copydoc GUIElement::_updateLayoutInternal
- */
- void _updateLayoutInternal(const GUILayoutData& data) override;
- /**
- * @copydoc GUIElement::_getOptimalSize
- */
- Vector2I _getOptimalSize() const override;
- /**
- * @brief Triggered whenever the referenced game object changes.
- */
- Event<void(const HGameObject&)> onValueChanged;
- private:
- virtual ~GUIGameObjectField();
- /**
- * @brief Sets the game object referenced by the field.
- *
- * @param value Game object to reference.
- * @param triggerEvent Determines should the ::onValueChanged event be triggered if the new object is different
- * from the previous one.
- */
- void setValue(const HGameObject& value, bool triggerEvent);
- /**
- * @copydoc GUIElement::styleUpdated
- */
- void styleUpdated() override;
- /**
- * @brief Triggered when a drag and drop operation finishes over this element.
- */
- void dataDropped(void* data);
- /**
- * @brief Triggered when the drop button that displays the game object label is clicked.
- */
- void onDropButtonClicked();
- /**
- * @brief Triggered when the clear button is clicked.
- */
- void onClearButtonClicked();
- private:
- static const UINT32 DEFAULT_LABEL_WIDTH;
- GUILayout* mLayout;
- GUILabel* mLabel;
- GUIDropButton* mDropButton;
- GUIButton* mClearButton;
- String mType;
- String mNamespace;
- UINT64 mInstanceId;
- };
- }
|