Subversion Repositories TruePreview

[/] [trunk/] [Source/] [TruePreview.h] - Blame information for rev 12

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 1 jhriggs
/*
2
 * Copyright (c) 2009, Jim Riggs, Christian Serving, L.L.C.
3
 * All rights reserved.
4
 *
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions are
7
 * met:
8
 *     * Redistributions of source code must retain the above copyright
9
 *       notice, this list of conditions and the following disclaimer.
10
 *     * Redistributions in binary form must reproduce the above
11
 *       copyright notice, this list of conditions and the following
12
 *       disclaimer in the documentation and/or other materials provided
13
 *       with the distribution.
14
 *     * Neither the name of Christian Serving, L.L.C. nor the names of
15
 *       its contributors may be used to endorse or promote products
16
 *       derived from this software without specific prior written
17
 *       permission.
18
 *
19
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23
 * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
 */
31
 
32
/*!
33
 * @header
34
 * Defines the <code>TruePreview</code> Mail bundler (the entrypoint for the
35
 * plugin) and the <code>TruePreviewObject</code> category for
36
 * <code>NSObject</code>.
37
 * @copyright Copyright (c) 2009 Jim Riggs, Christian Serving, L.L.C. All rights reserved.
38
 * @version \@(#) $Id: TruePreview.h 2 2009-06-27 07:02:45Z jhriggs $
39
 * @updated $Date: 2009-06-27 02:02:45 -0500 (Sat, 27 Jun 2009) $
40
 */
41
 
42
#import <objc/objc-class.h>
43
 
44
#import <Mail/MVMailBundle.h>
45
#import <Mail/TableViewManager.h>
46
#import <Message/LibraryMessage.h>
47
 
48
#import "TruePreviewPreferencesModule.h"
49
 
50
/*!
51
 * @class
52
 * The <code>TruePreview</code> class is the subclass of
53
 * <code>MVMailBundle</code> that provide the plugin entrypoint for the
54
 * TruePreview plugin.
55
 * @version \@(#) $Id: TruePreview.h 2 2009-06-27 07:02:45Z jhriggs $
56
 * @updated $Date: 2009-06-27 02:02:45 -0500 (Sat, 27 Jun 2009) $
57
 */
58
@interface TruePreview : MVMailBundle {
59
}
60
 
61
#pragma mark Class initialization
62
/*! @group Class initialization */
63
 
64
/*!
65
 * Registers this plugin and swizzles the methods necessary for TruePreview's
66
 * functionality.
67
 */
68
+ (void)initialize;
69
 
70
#pragma mark MVMailBundle class methods
71
/*! @group MVMailBundle class methods */
72
 
73
/*!
74
 * Indicates that this plugin has a preference panel.
75
 * @result
76
 *   <code>YES</code>.
77
 */
78
+ (BOOL)hasPreferencesPanel;
79
 
80
/*!
81
 * Returns the class name for this plugin's preference panel owner.
82
 * @result
83
 *   <code>TruePreviewPreferencesModule</code>.
84
 */
85
+ (NSString*)preferencesOwnerClassName;
86
 
87
/*!
88
 * Returns the name for this plugin's preferences panel.
89
 * @result
90
 *   <code>TruePreview</code>.
91
 */
92
+ (NSString*)preferencesPanelName;
93
 
94
@end
95
 
96
/*!
97
 * @category
98
 * Adds a method for method swizzling to <code>NSObject</code> instances.
99
 * @version \@(#) $Id: TruePreview.h 2 2009-06-27 07:02:45Z jhriggs $
100
 * @updated $Date: 2009-06-27 02:02:45 -0500 (Sat, 27 Jun 2009) $
101
 */
102
@interface NSObject (TruePreviewObject)
103
 
104
#pragma mark Class methods
105
/*! @group Class methods */
106
 
107
/*!
108
 * Swaps ("swizzles") two methods.  Based on
109
 * <a href="http://www.cocoadev.com/index.pl?MethodSwizzling">http://www.cocoadev.com/index.pl?MethodSwizzling</a>.
110
 * @param inOriginalSelector
111
 *   The selector specifying the method being replaced.
112
 * @param inReplacementSelector
113
 *   The selector specifying the replacement method.
114
 * @param inIsClassMethod
115
 *   The <code>BOOL</code> indicating whether or not the methods being swizzled
116
 *   are class methods.
117
 */
118
+ (void)truePreviewSwizzleMethod:(SEL)inOriginalSelector withMethod:(SEL)inReplacementSelector isClassMethod:(BOOL)inIsClassMethod;
119
 
120
@end