Switch branches/tags
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
115 lines (89 sloc) 3.32 KB
// DPSetupWindowView.h
// DPSetupWindow
// Created by Dan Palmer on 05/10/2012.
// Copyright (c) 2012 Dan Palmer. All rights reserved.
#import <Cocoa/Cocoa.h>
#define kDPNotification_addNextViewController @"kDPNotification_addNextViewController"
#define kDPNotification_addFinalViewController @"kDPNotification_addFinalViewController"
#define kDPNotification_deleteViewController @"kDPNotification_deleteViewController"
#define kDPNotification_key_viewController @"kDPNotification_key_viewController"
#define kDPNotification_key_viewControllerClass @"kDPNotification_key_viewControllerClass"
@class DPSetupWindow;
@protocol DPSetupWindowStageViewController <NSObject>
Stage view controllers must implement these as they will be observed by the setup window to determine whether the interface buttons should be enabled.
@property (readonly) BOOL canContinue;
@property (readonly) BOOL canGoBack;
Each view controller will be given a reference to the setup window through this method so that it may add extra stages for a dynamic setup process.
//- (void)setSetupWindow:(DPSetupWindow *)setupWindow;
These methods allow each stage to define their own titles for the interface buttons. For example, one may wish to have "Next, Next and Finish" as the continue button titles for three stages.
*Note: a custom title will not get carried over to the next stage, each stage must specify it's own.*
- (NSString *)continueButtonTitle;
- (NSString *)backButtonTitle;
- (NSString *)cancelButtonTitle;
These methods are used to notify the view controllers in the setup flow of any changes they may be interested in.
To illustrate the times each method will be called, the italicised stage is the one that will receive the method call.
*current* -> next
- (void)willProgressToNextStage;
- (void)didProgressToNextStage;
current -> *next*
- (void)willProgressToStage;
- (void)didProgressToStage;
previous <- *current*
- (void)willRevertToPreviousStage;
- (void)didRevertToPreviousStage;
*previous* <- current
- (void)willRevertToStage;
- (void)didRevertToStage;
*clean* every field, check, radio to initial state
- (void)resetToInitialState;
@interface DPSetupWindow : NSWindow {
NSImage *_backgroundImage;
NSInteger currentStage;
@property (retain) NSImage *backgroundImage;
@property (assign) BOOL animates;
@property (retain) NSArray *viewControllers;
@property (assign) BOOL funnelsRepresentedObjects;
- (id)initWithViewControllers:(NSArray *)viewControllers completionHandler:(void (^)(BOOL completed))completionHandler;
- (void)addNextViewController:(NSViewController<DPSetupWindowStageViewController> *)viewController;
- (void)addFinalViewController:(NSViewController<DPSetupWindowStageViewController> *)viewController;
- (void)progressToNextStage;
- (void)revertToPreviousStage;
- (void)resetToZeroStage;
@interface NSObject (PerformSelectorIfExists)
- (id)performSelectorIfExists:(SEL)selector;
@implementation NSObject (PerformSelectorIfExists)
- (id)performSelectorIfExists:(SEL)selector {
if ([self respondsToSelector:selector]) {
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Warc-performSelector-leaks"
return [self performSelector:selector];
#pragma clang diagnostic pop
} else {
return nil;