chromium/ui/android/java/src/org/chromium/ui/widget/RectProvider.java

// Copyright 2018 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

package org.chromium.ui.widget;

import android.graphics.Rect;

/** Provides a {@link Rect} object that represents a position in screen space. */
public class RectProvider {
    /** An observer to be notified of changes to the {@Rect} position. */
    public interface Observer {
        /**
         * Called when the {@link Rect} location has changed. The new {@link Rect} can be retrieved
         * using {@link #getRect()}.
         */
        void onRectChanged();

        /** Called when the {@link Rect} is no longer visible. */
        void onRectHidden();
    }

    /**
     * The {@link Rect} provided by this provider. This is the Rect that will be passed to
     * observers and returned from {@link #getRect()}.
     */
    protected final Rect mRect = new Rect();

    private Observer mObserver;

    /** Creates an instance of a {@link RectProvider}. */
    public RectProvider() {}

    /**
     * Creates an instance of a {@link RectProvider}.
     * @param rect The {@link Rect} to provide.
     */
    public RectProvider(Rect rect) {
        mRect.set(rect);
    }

    /**
     * Sets the {@link Rect} provided by this provider.
     * @param rect The {@link Rect} to provide.
     */
    public void setRect(Rect rect) {
        mRect.set(rect);
        notifyRectChanged();
    }

    /**
     * Start observing changes to the {@link Rect}'s position in the window. This does not guarantee
     * an immediate call to observer methods. Use {@link #getRect()} to retrieve the {@link Rect}.
     * @param observer The {@link Observer} to be notified of changes.
     */
    public void startObserving(Observer observer) {
        assert mObserver == null || mObserver == observer;

        mObserver = observer;
    }

    /** Stop observing changes to the {@link Rect}'s position in the window. */
    public void stopObserving() {
        mObserver = null;
    }

    /** @return The {@link Rect} that this provider represents. */
    public Rect getRect() {
        return mRect;
    }

    /** Notify the observer that the {@link Rect} changed. */
    protected void notifyRectChanged() {
        if (mObserver != null) mObserver.onRectChanged();
    }

    /** Notify the observer that the {@link Rect} is hidden. */
    protected void notifyRectHidden() {
        if (mObserver != null) mObserver.onRectHidden();
    }
}