Program Listing for File locate_pointer.h

↰ Return to documentation for file (/home/docs/checkouts/readthedocs.org/user_builds/canonical-mir/checkouts/stable/include/miral/miral/locate_pointer.h)

/*
 * Copyright © Canonical Ltd.
 *
 * This program is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 or 3 as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef MIRAL_LOCATE_POINTER_H
#define MIRAL_LOCATE_POINTER_H

#include <mir/geometry/forward.h>
#include <miral/toolkit_event.h>

#include <chrono>
#include <functional>
#include <memory>

namespace mir
{
class Server;
}

namespace miral
{
namespace live_config { class Store; }
class LocatePointer
{
public:
    static auto enabled() -> LocatePointer;

    static auto disabled() -> LocatePointer;

    void operator()(mir::Server& server);

    explicit LocatePointer(miral::live_config::Store& config_store);

    LocatePointer& delay(std::chrono::milliseconds delay);

    LocatePointer& on_locate_pointer(std::function<void(mir::geometry::PointF pointer_position)>&&);

    // Enables locate pointer.
    // When already enabled, further calls have no effect.
    LocatePointer& enable();

    // Disables locate pointer.
    // When already disabled, further calls have no effect.
    LocatePointer& disable();

    void schedule_request();

    void cancel_request();

private:
    struct Self;
    explicit LocatePointer(std::shared_ptr<Self>);
    std::shared_ptr<Self> self;
};
}

#endif // MIRAL_LOCATE_POINTER_H