chrome/browser/ui/exclusive_access/exclusive_access_bubble_hide_callback.h

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

#ifndef CHROME_BROWSER_UI_EXCLUSIVE_ACCESS_EXCLUSIVE_ACCESS_BUBBLE_HIDE_CALLBACK_H_
#define CHROME_BROWSER_UI_EXCLUSIVE_ACCESS_EXCLUSIVE_ACCESS_BUBBLE_HIDE_CALLBACK_H_

#include "base/callback_forward.h"

enum class ExclusiveAccessBubbleHideReason {
  // The bubble was never shown. e.g.
  // 1. View destroyed before the bubble could be shown.
  // 2. This is a request to dismiss bubble. e.g.
  //    a. |MouseLockController| sends request A to lock mouse, then
  //    b. |MLC| sends request B to unlock mouse with NULL bubble type.
  //    Resulted callbacks: A <= |kInterrupted|, B <= |kNotShown|.
  kNotShown,

  // The bubble hasn't been displayed for at least
  // |ExclusiveAccessBubble::kInitialDelayMs|, and was dismissed due to user
  // or script actions. e.g.
  // 1. User pressed ESC or switched to another window;
  // 2. Script called |exitPointerLock()|, or triggered mouse lock and
  //    fullscreen at the same time.
  kInterrupted,

  // The bubble has been displayed for at least
  // |ExclusiveAccessBubble::kInitialDelayMs|, and was dismissed by the timer.
  kTimeout,
};

using ExclusiveAccessBubbleHideCallback =
    base::OnceCallback<void(ExclusiveAccessBubbleHideReason)>;

// Repeating callback meant for testing.
using ExclusiveAccessBubbleHideCallbackForTest =
    base::RepeatingCallback<void(ExclusiveAccessBubbleHideReason)>;

#endif  // CHROME_BROWSER_UI_EXCLUSIVE_ACCESS_EXCLUSIVE_ACCESS_BUBBLE_HIDE_CALLBACK_H_