src/chrome/browser/ui/extensions/application_launch.h

   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/command_line.h"
   9 #include "base/files/file_path.h"
  10 #include "chrome/browser/ui/host_desktop.h"
  11 #include "chrome/common/extensions/extension_constants.h"
  12 #include "ui/base/window_open_disposition.h"
  13 #include "ui/gfx/rect.h"
  14 #include "url/gurl.h"
  15
  16 class Browser;
  17 class Profile;
  18
  19 namespace base {
  20 class CommandLine;
  21 }
  22
  23 namespace content {
  24 class WebContents;
  25 }
  26
  27 namespace extensions {
  28 class Extension;
  29 }
  30
  31 struct AppLaunchParams {
  32   AppLaunchParams(Profile* profile,
  33                   const extensions::Extension* extension,
  34                   extensions::LaunchContainer container,
  35                   WindowOpenDisposition disposition);
  36
  37   // Helper to create AppLaunchParams using extensions::GetLaunchContainer with
  38   // LAUNCH_TYPE_REGULAR to check for a user-configured container.
  39   AppLaunchParams(Profile* profile,
  40                   const extensions::Extension* extension,
  41                   WindowOpenDisposition disposition);
  42
  43   // Helper to create AppLaunchParams using event flags that allows user to
  44   // override the user-configured container using modifier keys, falling back to
  45   // extensions::GetLaunchContainer() with no modifiers. |desktop_type|
  46   // indicates the desktop upon which to launch (Ash or Native).
  47   AppLaunchParams(Profile* profile,
  48                   const extensions::Extension* extension,
  49                   int event_flags,
  50                   chrome::HostDesktopType desktop_type);
  51
  52   ~AppLaunchParams();
  53
  54   // The profile to load the application from.
  55   Profile* profile;
  56
  57   // The extension to load.
  58   std::string extension_id;
  59
  60   // The container type to launch the application in.
  61   extensions::LaunchContainer container;
  62
  63   // If container is TAB, this field controls how the tab is opened.
  64   WindowOpenDisposition disposition;
  65
  66   // The desktop type to launch on. Uses GetActiveDesktop() if unspecified.
  67   chrome::HostDesktopType desktop_type;
  68
  69   // If non-empty, use override_url in place of the application's launch url.
  70   GURL override_url;
  71
  72   // If non-empty, use override_boudns in place of the application's default
  73   // position and dimensions.
  74   gfx::Rect override_bounds;
  75
  76   // If non-empty, information from the command line may be passed on to the
  77   // application.
  78   base::CommandLine command_line;
  79
  80   // If non-empty, the current directory from which any relative paths on the
  81   // command line should be expanded from.
  82   base::FilePath current_directory;
  83 };
  84
  85 // Opens the application, possibly prompting the user to re-enable it.
  86 void OpenApplicationWithReenablePrompt(const AppLaunchParams& params);
  87
  88 // Open the application in a way specified by |params|.
  89 content::WebContents* OpenApplication(const AppLaunchParams& params);
  90
  91 // Open |url| in an app shortcut window.
  92 // There are two kinds of app shortcuts: Shortcuts to a URL,
  93 // and shortcuts that open an installed application.  This function
  94 // is used to open the former.  To open the latter, use
  95 // application_launch::OpenApplication().
  96 content::WebContents* OpenAppShortcutWindow(Profile* profile,
  97                                             const GURL& url);
  98
  99 // Whether the extension can be launched by sending a
 100 // chrome.app.runtime.onLaunched event.
 101 bool CanLaunchViaEvent(const extensions::Extension* extension);
 102
 103 // Get the launch URL for a given extension, with optional override/fallback.
 104 // |override_url|, if non-empty, will be preferred over the extension's
 105 // launch url.
 106 GURL UrlForExtension(const extensions::Extension* extension,
 107                      const GURL& override_url);
 108
 109 #endif  // CHROME_BROWSER_UI_EXTENSIONS_APPLICATION_LAUNCH_H_