ui/base/win/shell.h

   1 // Copyright (c) 2011 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 UI_BASE_WIN_SHELL_H_
   6 #define UI_BASE_WIN_SHELL_H_
   7
   8 #include <windows.h>
   9
  10 #include "base/strings/string16.h"
  11 #include "ui/base/ui_base_export.h"
  12
  13 namespace base {
  14 class FilePath;
  15 }
  16
  17 namespace ui {
  18 namespace win {
  19
  20 // Open or run a file via the Windows shell. In the event that there is no
  21 // default application registered for the file specified by 'full_path',
  22 // ask the user, via the Windows "Open With" dialog.
  23 // Returns 'true' on successful open, 'false' otherwise.
  24 UI_BASE_EXPORT bool OpenItemViaShell(const base::FilePath& full_path);
  25
  26 // The download manager now writes the alternate data stream with the
  27 // zone on all downloads. This function is equivalent to OpenItemViaShell
  28 // without showing the zone warning dialog.
  29 UI_BASE_EXPORT bool OpenItemViaShellNoZoneCheck(
  30     const base::FilePath& full_path);
  31
  32 // Lower level function that allows opening of non-files like urls or GUIDs
  33 // don't use it if one of the above will do. |mask| is a valid combination
  34 // of SEE_MASK_FLAG_XXX as stated in msdn. If there is no default application
  35 // registered for the item, it behaves the same as OpenItemViaShell.
  36 UI_BASE_EXPORT bool OpenAnyViaShell(const base::string16& full_path,
  37                                     const base::string16& directory,
  38                                     const base::string16& args,
  39                                     DWORD mask);
  40
  41 // Ask the user, via the Windows "Open With" dialog, for an application to use
  42 // to open the file specified by 'full_path'.
  43 // Returns 'true' on successful open, 'false' otherwise.
  44 bool OpenItemWithExternalApp(const base::string16& full_path);
  45
  46 // Disables the ability of the specified window to be pinned to the taskbar or
  47 // the Start menu. This will remove "Pin this program to taskbar" from the
  48 // taskbar menu of the specified window.
  49 UI_BASE_EXPORT bool PreventWindowFromPinning(HWND hwnd);
  50
  51 // Sets the application id, app icon, relaunch command and relaunch display name
  52 // for the given window.
  53 UI_BASE_EXPORT void SetAppDetailsForWindow(
  54     const base::string16& app_id,
  55     const base::string16& app_icon,
  56     const base::string16& relaunch_command,
  57     const base::string16& relaunch_display_name,
  58     HWND hwnd);
  59
  60 // Sets the application id given as the Application Model ID for the window
  61 // specified.  This method is used to insure that different web applications
  62 // do not group together on the Win7 task bar.
  63 UI_BASE_EXPORT void SetAppIdForWindow(const base::string16& app_id, HWND hwnd);
  64
  65 // Sets the application icon for the window specified.
  66 UI_BASE_EXPORT void SetAppIconForWindow(const base::string16& app_icon,
  67                                         HWND hwnd);
  68
  69 // Sets the relaunch command and relaunch display name for the window specified.
  70 // Windows will use this information for grouping on the taskbar, and to create
  71 // a shortcut if the window is pinned to the taskbar.
  72 UI_BASE_EXPORT void SetRelaunchDetailsForWindow(
  73     const base::string16& relaunch_command,
  74     const base::string16& display_name,
  75     HWND hwnd);
  76
  77 // Returns true if composition is available and turned on on the current
  78 // platform.
  79 UI_BASE_EXPORT bool IsAeroGlassEnabled();
  80
  81 }  // namespace win
  82 }  // namespace ui
  83
  84 #endif  // UI_BASE_WIN_SHELL_H_