forked from iMediaSandboxing/iMedia
-
Notifications
You must be signed in to change notification settings - Fork 0
/
IMBQLPreviewPanel.h
274 lines (203 loc) · 9.47 KB
/
IMBQLPreviewPanel.h
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
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
/*
iMedia Browser Framework <http://karelia.com/imedia/>
Copyright (c) 2005-2012 by Karelia Software et al.
iMedia Browser is based on code originally developed by Jason Terhorst,
further developed for Sandvox by Greg Hulands, Dan Wood, and Terrence Talbot.
The new architecture for version 2.0 was developed by Peter Baumgartner.
Contributions have also been made by Matt Gough, Martin Wennerberg and others
as indicated in source files.
The iMedia Browser Framework is licensed under the following terms:
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in all or substantial portions of the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to permit
persons to whom the Software is furnished to do so, subject to the following
conditions:
Redistributions of source code must retain the original terms stated here,
including this list of conditions, the disclaimer noted below, and the
following copyright notice: Copyright (c) 2005-2012 by Karelia Software et al.
Redistributions in binary form must include, in an end-user-visible manner,
e.g., About window, Acknowledgments window, or similar, either a) the original
terms stated here, including this list of conditions, the disclaimer noted
below, and the aforementioned copyright notice, or b) the aforementioned
copyright notice and a link to karelia.com/imedia.
Neither the name of Karelia Software, nor Sandvox, nor the names of
contributors to iMedia Browser may be used to endorse or promote products
derived from the Software without prior and express written permission from
Karelia Software or individual contributors, as appropriate.
Disclaimer: THE SOFTWARE IS PROVIDED BY THE COPYRIGHT OWNER AND CONTRIBUTORS
"AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE,
AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH, THE
SOFTWARE OR THE USE OF, OR OTHER DEALINGS IN, THE SOFTWARE.
*/
// Author: Peter Baumgartner
//----------------------------------------------------------------------------------------------------------------------
// When building against 10.5 SDK QLPreviewPanel et al are not available. However we still want to be ablew to
// use the QLPreviewPanel when we are running on a Snow Leopard machine. For this reason we need to declare the
// necessary classes and methods here to shut up the compiler and linker...
#pragma mark
#if IMB_COMPILING_WITH_SNOW_LEOPARD_OR_NEWER_SDK
#else
#define QLPREVIEWPANEL NSClassFromString(@"QLPreviewPanel")
//----------------------------------------------------------------------------------------------------------------------
@protocol QLPreviewItem;
@protocol QLPreviewPanelDataSource;
@protocol QLPreviewPanelDelegate;
@interface QLPreviewPanel : NSPanel
//{
//@private
// QLPreviewPanelReserved * _reserved;
//}
/*
* Getting the Preview Panel
*/
/*!
* @abstract Returns the QLPreviewPanel instance, creating it if it doesn’t exist yet.
*/
+ (QLPreviewPanel *)sharedPreviewPanel;
/*!
* @abstract Returns YES if the shared Preview Panel has been created, NO if it hasn’t..
*/
+ (BOOL)sharedPreviewPanelExists;
/*
* Getting the Preview Panel controller
*/
/*!
* @abstract The current first responder accepting to control the Preview Panel.
* @discussion You should never change preview panel state (delegate, datasource, etc.) if you are not controlling it.
*/
@property(readonly) id currentController;
/*!
* @abstract Asks the Preview Panel to update its current controller.
* @discussion The Preview Panel automatically updates its controller (by searching the responder chain) whenever the main or key window changes. Invoke updateController if the responder chain changes without explicit notice.
*/
- (void)updateController;
/*
* Acessing the previewed items
*/
/*!
* @abstract The Preview Panel data source.
*/
@property(assign) id <QLPreviewPanelDataSource> dataSource;
/*!
* @abstract Asks the Preview Panel to reload its data from its data source.
* @discussion This method does not refresh the visible item if it has not changed.
*/
- (void)reloadData;
/*!
* @abstract Asks the Preview Panel to recompute the preview of the currently previewed item.
*/
- (void)refreshCurrentPreviewItem;
/*!
* @abstract The index of the currently previewed item in the preview panel or NSNotFound if there is none.
*/
@property NSInteger currentPreviewItemIndex;
/*!
* @abstract The currently previewed item in the preview panel or nil if there is none.
*/
@property(readonly) id <QLPreviewItem> currentPreviewItem;
/*!
* @abstract The current panel's display state.
*/
@property(retain) id displayState;
/*
* Setting the delegate
*/
/*!
* @abstract The Preview Panel delegate.
*/
@property(assign) id <QLPreviewPanelDelegate> delegate;
/*
* Managing Full screen mode
*/
/*!
* @abstract Enters full screen mode.
* @discussion If panel is not on-screen, the panel will go directly to full screen mode.
*/
- (BOOL)enterFullScreenMode:(NSScreen *)screen withOptions:(NSDictionary *)options;
/*!
* @abstract Exits full screen mode.
*/
- (void)exitFullScreenModeWithOptions:(NSDictionary *)options;
/*!
* @abstract YES if the panel is currently open and in full screen mode.
*/
@property(readonly, getter=isInFullScreenMode) BOOL inFullScreenMode;
@end
#if 0
/*!
* @abstract Methods to implement by any object in the responder chain to control the Preview Panel
* @discussion QLPreviewPanel shows previews for items provided by the first object in the responder chain accepting to control it. You generally implement these methods in your window controller or delegate. You should never try to modify Preview panel state if you're not controlling the panel.
*/
@interface NSObject (QLPreviewPanelController)
/*!
* @abstract Sent to each object in the responder chain to find a controller.
* @param panel The Preview Panel looking for a controller.
* @result YES if the receiver accepts to control the panel. You should never call this method directly.
*/
- (BOOL)acceptsPreviewPanelControl:(QLPreviewPanel *)panel;
/*!
* @abstract Sent to the object taking control of the Preview Panel.
* @param panel The Preview Panel the receiver will control.
* @discussion The receiver should setup the preview panel (data source, delegate, binding, etc.) here. You should never call this method directly.
*/
- (void)beginPreviewPanelControl:(QLPreviewPanel *)panel;
/*!
* @abstract Sent to the object in control of the Preview Panel just before stopping its control.
* @param panel The Preview Panel that the receiver will stop controlling.
* @discussion The receiver should unsetup the preview panel (data source, delegate, binding, etc.) here. You should never call this method directly.
*/
- (void)endPreviewPanelControl:(QLPreviewPanel *)panel;
@end
/*!
* @abstract The QLPreviewPanelDataSource protocol declares the methods that the Preview Panel uses to access the contents of its data source object.
*/
@protocol QLPreviewPanelDataSource
@required
/*!
* @abstract Returns the number of items that the preview panel should preview.
* @param panel The Preview Panel.
* @result The number of items.
*/
- (NSInteger)numberOfPreviewItemsInPreviewPanel:(QLPreviewPanel *)panel;
/*!
* @abstract Returns the item that the preview panel should preview.
* @param panel The Preview Panel.
* @param index The index of the item to preview.
* @result An item conforming to the QLPreviewItem protocol.
*/
- (id <QLPreviewItem>)previewPanel:(QLPreviewPanel *)panel previewItemAtIndex:(NSInteger)index;
@end
/*!
* @abstract QLPreviewPanelDelegate is the protocol for the delegate of the Preview Panel object. You can implement these methods to perform custom tasks in response to events in the Preview Panel.
*/
@protocol QLPreviewPanelDelegate <NSWindowDelegate>
@optional
/*!
* @abstract Invoked by the preview panel when it receives an event it doesn't handle.
* @result Returns NO if the receiver did not handle the event.
*
*/
- (BOOL)previewPanel:(QLPreviewPanel *)panel handleEvent:(NSEvent *)event;
/*
* Zoom effect
*/
/*!
* @abstract Invoked when the preview panel opens or closes to provide a zoom effect.
* @discussion Return NSZeroRect if there is no origin point, this will produce a fade of the panel. The coordinates are screen based.
*/
- (NSRect)previewPanel:(QLPreviewPanel *)panel sourceFrameOnScreenForPreviewItem:(id <QLPreviewItem>)item;
/*!
* @abstract Invoked when the preview panel opens or closes to provide a smooth transition when zooming.
* @param contentRect The rect within the image that actually represents the content of the document. For example, for icons the actual rect is generally smaller than the icon itself.
* @discussion Return an image the panel will crossfade with when opening or closing. You can specify the actual "document" content rect in the image in contentRect.
*/
- (id)previewPanel:(QLPreviewPanel *)panel transitionImageForPreviewItem:(id <QLPreviewItem>)item contentRect:(NSRect *)contentRect;
@end
#endif
//----------------------------------------------------------------------------------------------------------------------
#endif