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
|
// 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__
|
