urho3d/Source/Urho3D/UI/Menu.h

// Copyright (c) 2008-2023 the Urho3D project
// License: MIT

#pragma once

#include "../UI/Button.h"

namespace Urho3D
{

/// %Menu %UI element that optionally shows a popup.
class URHO3D_API Menu : public Button
{
    URHO3D_OBJECT(Menu, Button);

public:
    /// Construct.
    explicit Menu(Context* context);
    /// Destruct.
    ~Menu() override;
    /// Register object factory.
    /// @nobind
    static void RegisterObject(Context* context);

    using UIElement::LoadXML;
    using UIElement::SaveXML;

    /// Load from XML data with style. Return true if successful.
    bool LoadXML(const XMLElement& source, XMLFile* styleFile) override;
    /// Save as XML data. Return true if successful.
    bool SaveXML(XMLElement& dest) const override;

    /// Perform UI element update.
    void Update(float timeStep) override;
    /// React to mouse hover.
    void OnHover(const IntVector2& position, const IntVector2& screenPosition, MouseButtonFlags buttons, QualifierFlags qualifiers, Cursor* cursor) override;
    /// React to the popup being shown.
    virtual void OnShowPopup();

    /// React to the popup being hidden.
    virtual void OnHidePopup() { }

    /// Set popup element to show on selection.
    /// @property
    void SetPopup(UIElement* popup);
    /// Set popup element offset.
    /// @property
    void SetPopupOffset(const IntVector2& offset);
    /// Set popup element offset.
    void SetPopupOffset(int x, int y);
    /// Force the popup to show or hide.
    /// @property
    void ShowPopup(bool enable);
    /// Set accelerator key (set zero key code to disable).
    void SetAccelerator(int key, int qualifiers);

    /// Return popup element.
    /// @property
    UIElement* GetPopup() const { return popup_; }

    /// Return popup element offset.
    /// @property
    const IntVector2& GetPopupOffset() const { return popupOffset_; }

    /// Return whether popup is open.
    /// @property
    bool GetShowPopup() const { return showPopup_; }

    /// Return accelerator key code, 0 if disabled.
    /// @property
    int GetAcceleratorKey() const { return acceleratorKey_; }

    /// Return accelerator qualifiers.
    /// @property
    int GetAcceleratorQualifiers() const { return acceleratorQualifiers_; }

protected:
    /// Filter implicit attributes in serialization process.
    virtual bool FilterPopupImplicitAttributes(XMLElement& dest) const;
    /// Popup element.
    SharedPtr<UIElement> popup_;
    /// Popup element offset.
    IntVector2 popupOffset_;
    /// Show popup flag.
    bool showPopup_;
    /// Accelerator key code.
    int acceleratorKey_;
    /// Accelerator qualifiers.
    int acceleratorQualifiers_;

private:
    /// Handle press and release for selection and toggling popup visibility.
    void HandlePressedReleased(StringHash eventType, VariantMap& eventData);
    /// Handle global focus change to check for hiding the popup.
    void HandleFocusChanged(StringHash eventType, VariantMap& eventData);
    /// Handle keypress for checking accelerator.
    void HandleKeyDown(StringHash eventType, VariantMap& eventData);
    /// Auto popup flag.
    bool autoPopup_;
};

}