h_scrolling_frame.hpp

Go to the documentation of this file.

/*
    Copyright 2020-2021 natinusala
    Copyright 2021 XITRIX
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
 
        http://www.apache.org/licenses/LICENSE-2.0
 
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
*/
 
#pragma once
 
#include <aurore/views/scrolling_frame.hpp>
 
namespace aurore
{
 
// A vertical-only frame that can scroll if its content overflows.
// This frame can only contain one child view.
// The content view is detached from the rest of the tree
// so that its height can grow as much as possible.
class HScrollingFrame : public Box
{
  public:
    HScrollingFrame();
    ~HScrollingFrame();
 
    void draw(NVGcontext* vg, float x, float y, float width, float height, Style style, FrameContext* ctx) override;
    void onFocusGained() override;
    void onChildFocusGained(View* directChild, View* focusedView) override;
    void onChildFocusLost(View* directChild, View* focusedView) override;
    void willAppear(bool resetState) override;
    void addView(View* view) override;
    void removeView(View* view, bool free = true) override;
    void onLayout() override;
    void setPadding(float top, float right, float bottom, float left) override;
    void setPaddingTop(float top) override;
    void setPaddingRight(float right) override;
    void setPaddingBottom(float bottom) override;
    void setPaddingLeft(float left) override;
    View* getParentNavigationDecision(View* from, View* newFocus, FocusDirection direction) override;
    View* getNextFocus(FocusDirection direction, View* currentView) override;
    View* getDefaultFocus() override;
    enum Sound getFocusSound() override;
    Rect getVisibleFrame();
 
    void setContentView(View* view);
 
    void setScrollingBehavior(ScrollingBehavior behavior);
 
    float getContentOffsetX() const
    {
        return contentOffsetX;
    }
 
    void setContentOffsetX(float value, bool animated);
 
    void setScrollingIndicatorVisible(bool visible)
    {
        showScrollingIndicator = visible;
    }
 
    static View* create();
 
  private:
    View* contentView             = nullptr;
    Rectangle* scrollingIndicator = nullptr;
 
    bool updateScrollingOnNextFrame = false;
    bool childFocused               = false;
    bool showScrollingIndicator     = true;
 
    float middleX = 0; // y + height/2
    float rightX  = 0; // y + height
 
    Animatable contentOffsetX = 0.0f;
 
    void prebakeScrolling();
    bool updateScrolling(bool animated);
    void startScrolling(bool animated, float newScroll);
    void animateScrolling(float newScroll, float time);
    void scrollAnimationTick();
 
    float getScrollingAreaLeftBoundary();
    float getScrollingAreaWidth();
 
    float getContentWidth();
 
    ScrollingBehavior behavior     = ScrollingBehavior::NATURAL;
    bool naturalScrollingCanScroll = false;
    bool isRubberBanding           = false; 
    void naturalScrollingBehaviour();
    void naturalScrollingButtonProcessing(FocusDirection focusDirection, bool* repeat);
    View* findLeftMostFocusableView();
 
    void setupScrollingIndicator();
    void updateScrollingIndicatior();
 
    Event<InputType>::Subscription inputTypeSubscription;
};
 
} // namespace aurore