Index: base/win/shortcut.h |
diff --git a/base/win/shortcut.h b/base/win/shortcut.h |
deleted file mode 100644 |
index 6f7d10c8ee715a397fe49b5faf0964305ee44c82..0000000000000000000000000000000000000000 |
--- a/base/win/shortcut.h |
+++ /dev/null |
@@ -1,168 +0,0 @@ |
-// Copyright (c) 2012 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 BASE_WIN_SHORTCUT_H_ |
-#define BASE_WIN_SHORTCUT_H_ |
- |
-#include <windows.h> |
- |
-#include "base/base_export.h" |
-#include "base/files/file_path.h" |
-#include "base/logging.h" |
-#include "base/strings/string16.h" |
- |
-namespace base { |
-namespace win { |
- |
-enum ShortcutOperation { |
- // Create a new shortcut (overwriting if necessary). |
- SHORTCUT_CREATE_ALWAYS = 0, |
- // Overwrite an existing shortcut (fails if the shortcut doesn't exist). |
- // If the arguments are not specified on the new shortcut, keep the old |
- // shortcut's arguments. |
- SHORTCUT_REPLACE_EXISTING, |
- // Update specified properties only on an existing shortcut. |
- SHORTCUT_UPDATE_EXISTING, |
-}; |
- |
-// Properties for shortcuts. Properties set will be applied to the shortcut on |
-// creation/update, others will be ignored. |
-// Callers are encouraged to use the setters provided which take care of |
-// setting |options| as desired. |
-struct BASE_EXPORT ShortcutProperties { |
- enum IndividualProperties { |
- PROPERTIES_TARGET = 1U << 0, |
- PROPERTIES_WORKING_DIR = 1U << 1, |
- PROPERTIES_ARGUMENTS = 1U << 2, |
- PROPERTIES_DESCRIPTION = 1U << 3, |
- PROPERTIES_ICON = 1U << 4, |
- PROPERTIES_APP_ID = 1U << 5, |
- PROPERTIES_DUAL_MODE = 1U << 6, |
- // Be sure to update the values below when adding a new property. |
- PROPERTIES_BASIC = PROPERTIES_TARGET | |
- PROPERTIES_WORKING_DIR | |
- PROPERTIES_ARGUMENTS | |
- PROPERTIES_DESCRIPTION | |
- PROPERTIES_ICON, |
- PROPERTIES_WIN7 = PROPERTIES_APP_ID | PROPERTIES_DUAL_MODE, |
- PROPERTIES_ALL = PROPERTIES_BASIC | PROPERTIES_WIN7 |
- }; |
- |
- ShortcutProperties(); |
- ~ShortcutProperties(); |
- |
- void set_target(const FilePath& target_in) { |
- target = target_in; |
- options |= PROPERTIES_TARGET; |
- } |
- |
- void set_working_dir(const FilePath& working_dir_in) { |
- working_dir = working_dir_in; |
- options |= PROPERTIES_WORKING_DIR; |
- } |
- |
- void set_arguments(const string16& arguments_in) { |
- // Size restriction as per MSDN at http://goo.gl/TJ7q5. |
- DCHECK(arguments_in.size() < MAX_PATH); |
- arguments = arguments_in; |
- options |= PROPERTIES_ARGUMENTS; |
- } |
- |
- void set_description(const string16& description_in) { |
- // Size restriction as per MSDN at http://goo.gl/OdNQq. |
- DCHECK(description_in.size() < MAX_PATH); |
- description = description_in; |
- options |= PROPERTIES_DESCRIPTION; |
- } |
- |
- void set_icon(const FilePath& icon_in, int icon_index_in) { |
- icon = icon_in; |
- icon_index = icon_index_in; |
- options |= PROPERTIES_ICON; |
- } |
- |
- void set_app_id(const string16& app_id_in) { |
- app_id = app_id_in; |
- options |= PROPERTIES_APP_ID; |
- } |
- |
- void set_dual_mode(bool dual_mode_in) { |
- dual_mode = dual_mode_in; |
- options |= PROPERTIES_DUAL_MODE; |
- } |
- |
- // The target to launch from this shortcut. This is mandatory when creating |
- // a shortcut. |
- FilePath target; |
- // The name of the working directory when launching the shortcut. |
- FilePath working_dir; |
- // The arguments to be applied to |target| when launching from this shortcut. |
- // The length of this string must be less than MAX_PATH. |
- string16 arguments; |
- // The localized description of the shortcut. |
- // The length of this string must be less than MAX_PATH. |
- string16 description; |
- // The path to the icon (can be a dll or exe, in which case |icon_index| is |
- // the resource id). |
- FilePath icon; |
- int icon_index; |
- // The app model id for the shortcut (Win7+). |
- string16 app_id; |
- // Whether this is a dual mode shortcut (Win8+). |
- bool dual_mode; |
- // Bitfield made of IndividualProperties. Properties set in |options| will be |
- // set on the shortcut, others will be ignored. |
- uint32 options; |
-}; |
- |
-// This method creates (or updates) a shortcut link at |shortcut_path| using the |
-// information given through |properties|. |
-// Ensure you have initialized COM before calling into this function. |
-// |operation|: a choice from the ShortcutOperation enum. |
-// If |operation| is SHORTCUT_REPLACE_EXISTING or SHORTCUT_UPDATE_EXISTING and |
-// |shortcut_path| does not exist, this method is a no-op and returns false. |
-BASE_EXPORT bool CreateOrUpdateShortcutLink( |
- const FilePath& shortcut_path, |
- const ShortcutProperties& properties, |
- ShortcutOperation operation); |
- |
-// Resolves Windows shortcut (.LNK file). |
-// This methods tries to resolve selected properties of a shortcut .LNK file. |
-// The path of the shortcut to resolve is in |shortcut_path|. |options| is a bit |
-// field composed of ShortcutProperties::IndividualProperties, to specify which |
-// properties to read. It should be non-0. The resulting data are read into |
-// |properties|, which must not be NULL. Note: PROPERTIES_TARGET will retrieve |
-// the target path as stored in the shortcut but won't attempt to resolve that |
-// path so it may not be valid. The function returns true if all requested |
-// properties are successfully read. Otherwise some reads have failed and |
-// intermediate values written to |properties| should be ignored. |
-BASE_EXPORT bool ResolveShortcutProperties(const FilePath& shortcut_path, |
- uint32 options, |
- ShortcutProperties* properties); |
- |
-// Resolves Windows shortcut (.LNK file). |
-// This is a wrapper to ResolveShortcutProperties() to handle the common use |
-// case of resolving target and arguments. |target_path| and |args| are |
-// optional output variables that are ignored if NULL (but at least one must be |
-// non-NULL). The function returns true if all requested fields are found |
-// successfully. Callers can safely use the same variable for both |
-// |shortcut_path| and |target_path|. |
-BASE_EXPORT bool ResolveShortcut(const FilePath& shortcut_path, |
- FilePath* target_path, |
- string16* args); |
- |
-// Pins a shortcut to the Windows 7 taskbar. The shortcut file must already |
-// exist and be a shortcut that points to an executable. The app id of the |
-// shortcut is used to group windows and must be set correctly. |
-BASE_EXPORT bool TaskbarPinShortcutLink(const wchar_t* shortcut); |
- |
-// Unpins a shortcut from the Windows 7 taskbar. The shortcut must exist and |
-// already be pinned to the taskbar. The app id of the shortcut is used as the |
-// identifier for the taskbar item to remove and must be set correctly. |
-BASE_EXPORT bool TaskbarUnpinShortcutLink(const wchar_t* shortcut); |
- |
-} // namespace win |
-} // namespace base |
- |
-#endif // BASE_WIN_SHORTCUT_H_ |