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
|
// Copyright (c) 2006-2008 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_ICON_LOADER_H__
#define CHROME_BROWSER_ICON_LOADER_H__
#include "base/logging.h"
#include <string>
#include <windows.h>
namespace {
class IconLoaderProcessor;
}
class SkBitmap;
////////////////////////////////////////////////////////////////////////////////
//
// A facility to read a file containing an icon asynchronously in the IO
// thread. Clients has the option to get the icon in the form of two HICON
// handles (one for a small icon size and one for a large icon) or in the form
// of an SkBitmap.
//
// This class currently only supports reading .ico files. Please extend as
// needed.
//
////////////////////////////////////////////////////////////////////////////////
class IconLoader {
public:
enum IconType {
SK_BITMAP = 0,
WINDOWS_HICON
};
enum IconSize {
SMALL = 0, // 16x16
NORMAL, // 32x32
LARGE
};
class Delegate {
public:
// Invoked when an icon has been read. |source| is the IconLoader. If the
// icon has been successfully loaded, result is non-null. This method must
// return true if it is taking ownership of the returned bitmap.
//
// This method is only called when GetIconType() above returns SK_BITMAP.
virtual bool OnSkBitmapLoaded(IconLoader* source, SkBitmap* result) = 0;
// Invoked when the small and the large HICONS have been read. |source| is
// the IconLoader. If the small icon has been successfully loaded,
// small_icon is non-null. The same applies to the large_icon. This method
// must return true if it is taking ownership of the returned icon handles.
//
// This method is only called when GetIconType() above returns
// WINDOWS_HICON.
virtual bool OnHICONLoaded(IconLoader* source,
HICON small_icon,
HICON large_icon) = 0;
};
// Create a new IconLoader that loads the icon from the data at contained in
// the file at |path|. |icon_type| specifies which format to generate and
// which method is invoked on the |delegate| once the icon was loaded.
static IconLoader* CreateIconLoaderForFile(const std::wstring& path,
IconType icon_type,
Delegate* delegate);
// Create a new IconLoader that loads the icon in the resource of the file
// at |path|. This is used with .exe/.dll files.
// Note that this generates a SkBitmap (and consequently OnSkBitmapLoaded is
// invoked on the delegate once the load has completed).
static IconLoader* CreateIconLoaderForFileResource(const std::wstring& path,
IconSize size,
Delegate* delegate);
~IconLoader();
// Start the read operation
void Start();
// Cancel the read operation. The delegate will no longer be contacted. Call
// this method if you need to delete the delegate.
void Cancel();
private:
friend class IconLoaderProcessor;
// Use the factory methods CreateIconLoader* instead of using this constructor
IconLoader(const std::wstring& path,
IconType type,
bool from_resource,
IconSize size,
Delegate* delegate);
// Invoked by the processor when the file has been read and an SkBitmap
// object was requested.
bool OnLoadComplete(SkBitmap* result);
// Invoked by the processor when the file has been read and HICON handles
// (small and large) were requested.
bool OnLoadComplete(HICON small_icon, HICON large_icon);
// The path.
std::wstring path_;
// The delegate.
Delegate* delegate_;
// Whether we are loading the icon from the resource in the file (if false,
// the icon is simply loaded from the file content).
bool loading_from_resource_;
// The size of the icon that should be loaded from the file resource.
// Not used if loading_from_resource_ is false.
IconSize icon_size_;
// The type of icon that should be generated.
// Not used if loading_from_resource_ is true.
IconType icon_type_;
// The underlying object performing the read.
IconLoaderProcessor* processor_;
DISALLOW_EVIL_CONSTRUCTORS(IconLoader);
};
#endif // CHROME_BROWSER_ICON_LOADER_H__
|
