Notify about major session changes events.

ash/session_state_delegate.h

 // Copyright (c) 2013 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 ASH_SESSION_STATE_DELEGATE_H_
 #define ASH_SESSION_STATE_DELEGATE_H_
 
 #include <string>
 #include <vector>
 
@@ skipping 27 matching lines @@
 // TODO(oshima): Replace MultiProfileIndex with BrowsreContext, bacause
 // GetUserXXX are useful for non multi profile scenario in ash_shell.
 class ASH_EXPORT SessionStateDelegate {
  public:
   // Defines the cycle direction for |CycleActiveUser|.
   enum CycleUser {
     CYCLE_TO_NEXT_USER = 0,  // Cycle to the next user.
     CYCLE_TO_PREVIOUS_USER,  // Cycle to the previous user.
   };
 
+  // Defines session state i.e. whether session is running or not and
+  // whether user session is blocked by things like multi-profile login.
+  enum SessionState {
+    // When primary user login UI is shown i.e. after boot or sign out,
+    // no active user session exists yet.
+    SESSION_STATE_LOGIN_PRIMARY = 0,
+
+    // Inside user session, no blocking UI (login/lock) is shown.

[Daniel Erat, 2014/04/11 14:43:41]

update this comment since this now includes the lock screen

[Nikita (slow), 2014/04/14 08:53:16]

Done.

+    SESSION_STATE_ACTIVE,
+
+    // When secondary user login UI is shown i.e. other users are
+    // already logged in and is currently adding another user to the session.
+    SESSION_STATE_LOGIN_SECONDARY,
+  };
+
   virtual ~SessionStateDelegate() {};
 
   // Returns the browser context for the user given by |index|.
   virtual content::BrowserContext* GetBrowserContextByIndex(
       MultiProfileIndex index) = 0;
 
   // Returns the browser context associated with the window.
   virtual content::BrowserContext* GetBrowserContextForWindow(
       aura::Window* window) = 0;
 
@@ skipping 24 matching lines @@
   virtual void LockScreen() = 0;
 
   // Unlocks the screen.
   virtual void UnlockScreen() = 0;
 
   // Returns |true| if user session blocked by some overlying UI. It can be
   // login screen, lock screen or screen for adding users into multi-profile
   // session.
   virtual bool IsUserSessionBlocked() const = 0;
 
+  // Returns current session state.
+  virtual SessionState GetSessionState() const = 0;
+
   // Gets the displayed name for the user with the given |index|.
   // Note that |index| can at maximum be |NumberOfLoggedInUsers() - 1|.
   virtual const base::string16 GetUserDisplayName(
       MultiProfileIndex index) const = 0;
 
   // Gets the display email address for the user with the given |index|.
   // The display email address might contains some periods in the email name
   // as well as capitalized letters. For example: "Foo.Bar@mock.com".
   // Note that |index| can at maximum be |NumberOfLoggedInUsers() - 1|.
   virtual const std::string GetUserEmail(MultiProfileIndex index) const = 0;
@@ skipping 19 matching lines @@
   virtual void CycleActiveUser(CycleUser cycle_user) = 0;
 
   // Adds or removes sessions state observer.
   virtual void AddSessionStateObserver(SessionStateObserver* observer) = 0;
   virtual void RemoveSessionStateObserver(SessionStateObserver* observer) = 0;
 };
 
 }  // namespace ash
 
 #endif  // ASH_SESSION_STATE_DELEGATE_H_