Home | History | Annotate | Download | only in extensions 
      1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef CHROME_BROWSER_UI_EXTENSIONS_APPLICATION_LAUNCH_H_
      6 #define CHROME_BROWSER_UI_EXTENSIONS_APPLICATION_LAUNCH_H_
      7 
      8 #include "base/files/file_path.h"
      9 #include "chrome/browser/ui/host_desktop.h"
     10 #include "chrome/common/extensions/extension_constants.h"
     11 #include "ui/base/window_open_disposition.h"
     12 #include "ui/gfx/rect.h"
     13 #include "url/gurl.h"
     14 
     15 class Browser;
     16 class CommandLine;
     17 class Profile;
     18 
     19 namespace content {
     20 class WebContents;
     21 }
     22 
     23 namespace extensions {
     24 class Extension;
     25 }
     26 
     27 struct AppLaunchParams {
     28   AppLaunchParams(Profile* profile,
     29                   const extensions::Extension* extension,
     30                   extensions::LaunchContainer container,
     31                   WindowOpenDisposition disposition);
     32 
     33   // Helper to create AppLaunchParams using extensions::GetLaunchContainer with
     34   // LAUNCH_TYPE_REGULAR to check for a user-configured container.
     35   AppLaunchParams(Profile* profile,
     36                   const extensions::Extension* extension,
     37                   WindowOpenDisposition disposition);
     38 
     39   // Helper to create AppLaunchParams using event flags that allows user to
     40   // override the user-configured container using modifier keys, falling back to
     41   // extensions::GetLaunchContainer() with no modifiers. |desktop_type|
     42   // indicates the desktop upon which to launch (Ash or Native).
     43   AppLaunchParams(Profile* profile,
     44                   const extensions::Extension* extension,
     45                   int event_flags,
     46                   chrome::HostDesktopType desktop_type);
     47 
     48   // The profile to load the application from.
     49   Profile* profile;
     50 
     51   // The extension to load.
     52   const extensions::Extension* extension;
     53 
     54   // The container type to launch the application in.
     55   extensions::LaunchContainer container;
     56 
     57   // If container is TAB, this field controls how the tab is opened.
     58   WindowOpenDisposition disposition;
     59 
     60   // The desktop type to launch on. Uses GetActiveDesktop() if unspecified.
     61   chrome::HostDesktopType desktop_type;
     62 
     63   // If non-empty, use override_url in place of the application's launch url.
     64   GURL override_url;
     65 
     66   // If non-empty, use override_boudns in place of the application's default
     67   // position and dimensions.
     68   gfx::Rect override_bounds;
     69 
     70   // If non-NULL, information from the command line may be passed on to the
     71   // application.
     72   const CommandLine* command_line;
     73 
     74   // If non-empty, the current directory from which any relative paths on the
     75   // command line should be expanded from.
     76   base::FilePath current_directory;
     77 };
     78 
     79 // Opens the application, possibly prompting the user to re-enable it.
     80 void OpenApplicationWithReenablePrompt(const AppLaunchParams& params);
     81 
     82 // Open the application in a way specified by |params|.
     83 content::WebContents* OpenApplication(const AppLaunchParams& params);
     84 
     85 // Open |url| in an app shortcut window. |override_bounds| param is optional.
     86 // There are two kinds of app shortcuts: Shortcuts to a URL,
     87 // and shortcuts that open an installed application.  This function
     88 // is used to open the former.  To open the latter, use
     89 // application_launch::OpenApplication().
     90 content::WebContents* OpenAppShortcutWindow(Profile* profile,
     91                                             const GURL& url,
     92                                             const gfx::Rect& override_bounds);
     93 
     94 #endif  // CHROME_BROWSER_UI_EXTENSIONS_APPLICATION_LAUNCH_H_
     95