blob: a6b2c5859fc329aab0b0b9de859a0715fa53e0a8 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
// Copyright 2014 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 CHROME_BROWSER_JUMPLIST_UPDATER_WIN_H_
#define CHROME_BROWSER_JUMPLIST_UPDATER_WIN_H_
#include <windows.h>
#include <shobjidl.h>
#include <stddef.h>
#include <string>
#include <vector>
#include "base/command_line.h"
#include "base/macros.h"
#include "base/memory/ref_counted.h"
#include "base/win/scoped_comptr.h"
#include "third_party/skia/include/core/SkBitmap.h"
// Represents a class used for creating an IShellLink object.
// Even though an IShellLink also needs the absolute path to an application to
// be executed, this class does not have any variables for it because current
// users always use "chrome.exe" as the application.
class ShellLinkItem : public base::RefCountedThreadSafe<ShellLinkItem> {
public:
ShellLinkItem();
const std::wstring& title() const { return title_; }
const std::wstring& icon_path() const { return icon_path_; }
int icon_index() const { return icon_index_; }
const SkBitmap& icon_data() const { return icon_data_; }
std::wstring GetArguments() const;
base::CommandLine* GetCommandLine();
void set_title(const std::wstring& title) {
title_ = title;
}
void set_icon(const std::wstring& path, int index) {
icon_path_ = path;
icon_index_ = index;
}
void set_icon_data(const SkBitmap& data) {
icon_data_ = data;
}
private:
friend class base::RefCountedThreadSafe<ShellLinkItem>;
~ShellLinkItem();
// Used for storing and appending command-line arguments.
base::CommandLine command_line_;
// The string to be displayed in a JumpList.
std::wstring title_;
// The absolute path to an icon to be displayed in a JumpList.
std::wstring icon_path_;
// The icon index in the icon file. If an icon file consists of two or more
// icons, set this value to identify the icon. If an icon file consists of
// one icon, this value is 0.
int icon_index_;
// Icon bitmap. Used by the browser JumpList.
// Note that an icon path must be supplied to IShellLink, so users of this
// class must save icon data to disk.
SkBitmap icon_data_;
DISALLOW_COPY_AND_ASSIGN(ShellLinkItem);
};
typedef std::vector<scoped_refptr<ShellLinkItem> > ShellLinkItemList;
// A utility class that hides the boilerplate for updating Windows JumpLists.
// Note that JumpLists are available in Windows 7 and later only.
//
// Example of usage:
//
// JumpListUpdater updater(app_id);
// if (updater.BeginUpdate()) {
// updater.AddTasks(...);
// updater.AddCustomCategory(...);
// updater.CommitUpdate();
// }
//
// Note:
// - Each JumpListUpdater instance is expected to be used once only.
// - The JumpList must be updated in its entirety, i.e. even if a category has
// not changed, all its items must be added in each update.
class JumpListUpdater {
public:
explicit JumpListUpdater(const std::wstring& app_user_model_id);
~JumpListUpdater();
// Returns true if JumpLists are enabled on this OS.
static bool IsEnabled();
// Returns the current user setting for the maximum number of items to display
// in JumpLists. The setting is retrieved in BeginUpdate().
size_t user_max_items() const { return user_max_items_; }
// Starts a transaction that updates the JumpList of this application.
// This must be called prior to updating the JumpList. If this function
// returns false, this instance should not be used.
bool BeginUpdate();
// Commits the update.
bool CommitUpdate();
// Updates the predefined "Tasks" category of the JumpList.
bool AddTasks(const ShellLinkItemList& link_items);
// Updates an unregistered category of the JumpList.
// This function cannot update registered categories (such as "Tasks")
// because special steps are required for updating them.
// |max_items| specifies the maximum number of items from |link_items| to add
// to the JumpList.
bool AddCustomCategory(const std::wstring& category_name,
const ShellLinkItemList& link_items,
size_t max_items);
private:
// The app ID.
std::wstring app_user_model_id_;
// Windows API interface used to modify JumpLists.
base::win::ScopedComPtr<ICustomDestinationList> destination_list_;
// The current user setting for "Number of recent items to display in Jump
// Lists" option in the "Taskbar and Start Menu Properties".
size_t user_max_items_;
DISALLOW_COPY_AND_ASSIGN(JumpListUpdater);
};
#endif // CHROME_BROWSER_JUMPLIST_UPDATER_WIN_H_
|
