├── .gitignore ├── DBPrefsWindowController.xcodeproj ├── project.pbxproj └── project.xcworkspace │ └── contents.xcworkspacedata ├── README.md ├── Resources ├── Advanced.png ├── Colors.tiff ├── English.lproj │ └── MainMenu.xib ├── General.png ├── Info.plist ├── Playback.tiff ├── Preferences.xib └── Updates.tiff ├── Source ├── AppController.h ├── AppController.m ├── AppPrefsWindowController.h ├── AppPrefsWindowController.m ├── DBPrefsWindowController.h ├── DBPrefsWindowController.m └── main.m └── prefswindow.png /.gitignore: -------------------------------------------------------------------------------- 1 | build 2 | .DS_Store 3 | *.pbxuser 4 | *.perspectivev3 5 | xcuserdata 6 | *.zip 7 | *.app 8 | dsa_priv.pem 9 | *.pyc 10 | -------------------------------------------------------------------------------- /DBPrefsWindowController.xcodeproj/project.pbxproj: -------------------------------------------------------------------------------- 1 | // !$*UTF8*$! 2 | { 3 | archiveVersion = 1; 4 | classes = { 5 | }; 6 | objectVersion = 46; 7 | objects = { 8 | 9 | /* Begin PBXBuildFile section */ 10 | 31CF33040B3EF55E00359553 /* AppController.m in Sources */ = {isa = PBXBuildFile; fileRef = 31CF33030B3EF55E00359553 /* AppController.m */; }; 11 | 31CF330B0B3EF57E00359553 /* DBPrefsWindowController.m in Sources */ = {isa = PBXBuildFile; fileRef = 31CF330A0B3EF57E00359553 /* DBPrefsWindowController.m */; }; 12 | 3E7A778F0BA325F4006CEBA9 /* Updates.tiff in Resources */ = {isa = PBXBuildFile; fileRef = 3E7A778E0BA325F4006CEBA9 /* Updates.tiff */; }; 13 | 3E7A77910BA3261F006CEBA9 /* Colors.tiff in Resources */ = {isa = PBXBuildFile; fileRef = 3E7A77900BA3261F006CEBA9 /* Colors.tiff */; }; 14 | 3E7A77940BA32641006CEBA9 /* Playback.tiff in Resources */ = {isa = PBXBuildFile; fileRef = 3E7A77930BA32641006CEBA9 /* Playback.tiff */; }; 15 | 3ED08F3A0B9F00D80091ED60 /* AppPrefsWindowController.m in Sources */ = {isa = PBXBuildFile; fileRef = 3ED08F390B9F00D80091ED60 /* AppPrefsWindowController.m */; }; 16 | 3EFD779E0BA35B1E00864CFF /* Advanced.png in Resources */ = {isa = PBXBuildFile; fileRef = 3EFD779D0BA35B1E00864CFF /* Advanced.png */; }; 17 | 3EFD77A40BA35B7800864CFF /* General.png in Resources */ = {isa = PBXBuildFile; fileRef = 3EFD77A30BA35B7800864CFF /* General.png */; }; 18 | 732FFA561598E26400546247 /* Preferences.xib in Resources */ = {isa = PBXBuildFile; fileRef = 732FFA551598E26400546247 /* Preferences.xib */; }; 19 | 732FFA591598E26C00546247 /* MainMenu.xib in Resources */ = {isa = PBXBuildFile; fileRef = 732FFA571598E26C00546247 /* MainMenu.xib */; }; 20 | 8D11072D0486CEB800E47090 /* main.m in Sources */ = {isa = PBXBuildFile; fileRef = 29B97316FDCFA39411CA2CEA /* main.m */; settings = {ATTRIBUTES = (); }; }; 21 | 8D11072F0486CEB800E47090 /* Cocoa.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 1058C7A1FEA54F0111CA2CBB /* Cocoa.framework */; }; 22 | /* End PBXBuildFile section */ 23 | 24 | /* Begin PBXFileReference section */ 25 | 1058C7A1FEA54F0111CA2CBB /* Cocoa.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Cocoa.framework; path = /System/Library/Frameworks/Cocoa.framework; sourceTree = ""; }; 26 | 29B97316FDCFA39411CA2CEA /* main.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = main.m; sourceTree = ""; }; 27 | 29B97324FDCFA39411CA2CEA /* AppKit.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = AppKit.framework; path = /System/Library/Frameworks/AppKit.framework; sourceTree = ""; }; 28 | 29B97325FDCFA39411CA2CEA /* Foundation.framework */ = {isa = PBXFileReference; lastKnownFileType = wrapper.framework; name = Foundation.framework; path = /System/Library/Frameworks/Foundation.framework; sourceTree = ""; }; 29 | 31CF33020B3EF55E00359553 /* AppController.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = AppController.h; sourceTree = ""; }; 30 | 31CF33030B3EF55E00359553 /* AppController.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = AppController.m; sourceTree = ""; }; 31 | 31CF33090B3EF57E00359553 /* DBPrefsWindowController.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = DBPrefsWindowController.h; sourceTree = ""; }; 32 | 31CF330A0B3EF57E00359553 /* DBPrefsWindowController.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = DBPrefsWindowController.m; sourceTree = ""; }; 33 | 3E7A778E0BA325F4006CEBA9 /* Updates.tiff */ = {isa = PBXFileReference; lastKnownFileType = image.tiff; path = Updates.tiff; sourceTree = ""; }; 34 | 3E7A77900BA3261F006CEBA9 /* Colors.tiff */ = {isa = PBXFileReference; lastKnownFileType = image.tiff; path = Colors.tiff; sourceTree = ""; }; 35 | 3E7A77930BA32641006CEBA9 /* Playback.tiff */ = {isa = PBXFileReference; lastKnownFileType = image.tiff; path = Playback.tiff; sourceTree = ""; }; 36 | 3ED08F380B9F00D80091ED60 /* AppPrefsWindowController.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = AppPrefsWindowController.h; sourceTree = ""; }; 37 | 3ED08F390B9F00D80091ED60 /* AppPrefsWindowController.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = AppPrefsWindowController.m; sourceTree = ""; }; 38 | 3EFD779D0BA35B1E00864CFF /* Advanced.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = Advanced.png; sourceTree = ""; }; 39 | 3EFD77A30BA35B7800864CFF /* General.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = General.png; sourceTree = ""; }; 40 | 732FFA551598E26400546247 /* Preferences.xib */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = file.xib; path = Preferences.xib; sourceTree = ""; }; 41 | 732FFA581598E26C00546247 /* English */ = {isa = PBXFileReference; lastKnownFileType = file.xib; name = English; path = English.lproj/MainMenu.xib; sourceTree = ""; }; 42 | 8D1107310486CEB800E47090 /* Info.plist */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = ""; }; 43 | 8D1107320486CEB800E47090 /* DBPrefsWindowController.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = DBPrefsWindowController.app; sourceTree = BUILT_PRODUCTS_DIR; }; 44 | /* End PBXFileReference section */ 45 | 46 | /* Begin PBXFrameworksBuildPhase section */ 47 | 8D11072E0486CEB800E47090 /* Frameworks */ = { 48 | isa = PBXFrameworksBuildPhase; 49 | buildActionMask = 2147483647; 50 | files = ( 51 | 8D11072F0486CEB800E47090 /* Cocoa.framework in Frameworks */, 52 | ); 53 | runOnlyForDeploymentPostprocessing = 0; 54 | }; 55 | /* End PBXFrameworksBuildPhase section */ 56 | 57 | /* Begin PBXGroup section */ 58 | 080E96DDFE201D6D7F000001 /* Classes */ = { 59 | isa = PBXGroup; 60 | children = ( 61 | 31CF33020B3EF55E00359553 /* AppController.h */, 62 | 31CF33030B3EF55E00359553 /* AppController.m */, 63 | 3ED08F380B9F00D80091ED60 /* AppPrefsWindowController.h */, 64 | 3ED08F390B9F00D80091ED60 /* AppPrefsWindowController.m */, 65 | 31CF33090B3EF57E00359553 /* DBPrefsWindowController.h */, 66 | 31CF330A0B3EF57E00359553 /* DBPrefsWindowController.m */, 67 | 29B97316FDCFA39411CA2CEA /* main.m */, 68 | ); 69 | name = Classes; 70 | path = Source; 71 | sourceTree = ""; 72 | }; 73 | 19C28FACFE9D520D11CA2CBB /* Products */ = { 74 | isa = PBXGroup; 75 | children = ( 76 | 8D1107320486CEB800E47090 /* DBPrefsWindowController.app */, 77 | ); 78 | name = Products; 79 | sourceTree = ""; 80 | }; 81 | 29B97314FDCFA39411CA2CEA /* Simple Preferences */ = { 82 | isa = PBXGroup; 83 | children = ( 84 | 080E96DDFE201D6D7F000001 /* Classes */, 85 | 29B97317FDCFA39411CA2CEA /* Resources */, 86 | 29B97323FDCFA39411CA2CEA /* Frameworks */, 87 | 19C28FACFE9D520D11CA2CBB /* Products */, 88 | ); 89 | name = "Simple Preferences"; 90 | sourceTree = ""; 91 | }; 92 | 29B97317FDCFA39411CA2CEA /* Resources */ = { 93 | isa = PBXGroup; 94 | children = ( 95 | 3EFD77A30BA35B7800864CFF /* General.png */, 96 | 3E7A77900BA3261F006CEBA9 /* Colors.tiff */, 97 | 3E7A77930BA32641006CEBA9 /* Playback.tiff */, 98 | 3E7A778E0BA325F4006CEBA9 /* Updates.tiff */, 99 | 3EFD779D0BA35B1E00864CFF /* Advanced.png */, 100 | 8D1107310486CEB800E47090 /* Info.plist */, 101 | 732FFA571598E26C00546247 /* MainMenu.xib */, 102 | 732FFA551598E26400546247 /* Preferences.xib */, 103 | ); 104 | path = Resources; 105 | sourceTree = ""; 106 | }; 107 | 29B97323FDCFA39411CA2CEA /* Frameworks */ = { 108 | isa = PBXGroup; 109 | children = ( 110 | 1058C7A1FEA54F0111CA2CBB /* Cocoa.framework */, 111 | 29B97324FDCFA39411CA2CEA /* AppKit.framework */, 112 | 29B97325FDCFA39411CA2CEA /* Foundation.framework */, 113 | ); 114 | name = Frameworks; 115 | sourceTree = ""; 116 | }; 117 | /* End PBXGroup section */ 118 | 119 | /* Begin PBXNativeTarget section */ 120 | 8D1107260486CEB800E47090 /* DBPrefsWindowController */ = { 121 | isa = PBXNativeTarget; 122 | buildConfigurationList = C01FCF4A08A954540054247B /* Build configuration list for PBXNativeTarget "DBPrefsWindowController" */; 123 | buildPhases = ( 124 | 8D1107290486CEB800E47090 /* Resources */, 125 | 8D11072C0486CEB800E47090 /* Sources */, 126 | 8D11072E0486CEB800E47090 /* Frameworks */, 127 | ); 128 | buildRules = ( 129 | ); 130 | dependencies = ( 131 | ); 132 | name = DBPrefsWindowController; 133 | productInstallPath = "$(HOME)/Applications"; 134 | productName = "Simple Preferences"; 135 | productReference = 8D1107320486CEB800E47090 /* DBPrefsWindowController.app */; 136 | productType = "com.apple.product-type.application"; 137 | }; 138 | /* End PBXNativeTarget section */ 139 | 140 | /* Begin PBXProject section */ 141 | 29B97313FDCFA39411CA2CEA /* Project object */ = { 142 | isa = PBXProject; 143 | attributes = { 144 | LastUpgradeCheck = 0460; 145 | }; 146 | buildConfigurationList = C01FCF4E08A954540054247B /* Build configuration list for PBXProject "DBPrefsWindowController" */; 147 | compatibilityVersion = "Xcode 3.2"; 148 | developmentRegion = English; 149 | hasScannedForEncodings = 1; 150 | knownRegions = ( 151 | en, 152 | English, 153 | ); 154 | mainGroup = 29B97314FDCFA39411CA2CEA /* Simple Preferences */; 155 | projectDirPath = ""; 156 | projectRoot = ""; 157 | targets = ( 158 | 8D1107260486CEB800E47090 /* DBPrefsWindowController */, 159 | ); 160 | }; 161 | /* End PBXProject section */ 162 | 163 | /* Begin PBXResourcesBuildPhase section */ 164 | 8D1107290486CEB800E47090 /* Resources */ = { 165 | isa = PBXResourcesBuildPhase; 166 | buildActionMask = 2147483647; 167 | files = ( 168 | 3E7A778F0BA325F4006CEBA9 /* Updates.tiff in Resources */, 169 | 3E7A77910BA3261F006CEBA9 /* Colors.tiff in Resources */, 170 | 3E7A77940BA32641006CEBA9 /* Playback.tiff in Resources */, 171 | 3EFD779E0BA35B1E00864CFF /* Advanced.png in Resources */, 172 | 3EFD77A40BA35B7800864CFF /* General.png in Resources */, 173 | 732FFA561598E26400546247 /* Preferences.xib in Resources */, 174 | 732FFA591598E26C00546247 /* MainMenu.xib in Resources */, 175 | ); 176 | runOnlyForDeploymentPostprocessing = 0; 177 | }; 178 | /* End PBXResourcesBuildPhase section */ 179 | 180 | /* Begin PBXSourcesBuildPhase section */ 181 | 8D11072C0486CEB800E47090 /* Sources */ = { 182 | isa = PBXSourcesBuildPhase; 183 | buildActionMask = 2147483647; 184 | files = ( 185 | 8D11072D0486CEB800E47090 /* main.m in Sources */, 186 | 31CF33040B3EF55E00359553 /* AppController.m in Sources */, 187 | 31CF330B0B3EF57E00359553 /* DBPrefsWindowController.m in Sources */, 188 | 3ED08F3A0B9F00D80091ED60 /* AppPrefsWindowController.m in Sources */, 189 | ); 190 | runOnlyForDeploymentPostprocessing = 0; 191 | }; 192 | /* End PBXSourcesBuildPhase section */ 193 | 194 | /* Begin PBXVariantGroup section */ 195 | 732FFA571598E26C00546247 /* MainMenu.xib */ = { 196 | isa = PBXVariantGroup; 197 | children = ( 198 | 732FFA581598E26C00546247 /* English */, 199 | ); 200 | name = MainMenu.xib; 201 | sourceTree = ""; 202 | }; 203 | /* End PBXVariantGroup section */ 204 | 205 | /* Begin XCBuildConfiguration section */ 206 | C01FCF4B08A954540054247B /* Debug */ = { 207 | isa = XCBuildConfiguration; 208 | buildSettings = { 209 | ARCHS = "$(ARCHS_STANDARD_64_BIT)"; 210 | CLANG_ENABLE_OBJC_ARC = YES; 211 | COPY_PHASE_STRIP = NO; 212 | GCC_DYNAMIC_NO_PIC = NO; 213 | GCC_MODEL_TUNING = G5; 214 | GCC_OPTIMIZATION_LEVEL = 0; 215 | INFOPLIST_FILE = Resources/Info.plist; 216 | INSTALL_PATH = "$(HOME)/Applications"; 217 | MACOSX_DEPLOYMENT_TARGET = 10.6.8; 218 | PRODUCT_NAME = DBPrefsWindowController; 219 | VALID_ARCHS = "i386 x86_64"; 220 | WRAPPER_EXTENSION = app; 221 | ZERO_LINK = NO; 222 | }; 223 | name = Debug; 224 | }; 225 | C01FCF4C08A954540054247B /* Release */ = { 226 | isa = XCBuildConfiguration; 227 | buildSettings = { 228 | ARCHS = "$(ARCHS_STANDARD_64_BIT)"; 229 | CLANG_ENABLE_OBJC_ARC = YES; 230 | GCC_GENERATE_DEBUGGING_SYMBOLS = NO; 231 | GCC_MODEL_TUNING = G5; 232 | INFOPLIST_FILE = Resources/Info.plist; 233 | INSTALL_PATH = "$(HOME)/Applications"; 234 | MACOSX_DEPLOYMENT_TARGET = 10.6.8; 235 | PRODUCT_NAME = DBPrefsWindowController; 236 | VALID_ARCHS = "i386 x86_64"; 237 | WRAPPER_EXTENSION = app; 238 | }; 239 | name = Release; 240 | }; 241 | C01FCF4F08A954540054247B /* Debug */ = { 242 | isa = XCBuildConfiguration; 243 | buildSettings = { 244 | GCC_WARN_ABOUT_RETURN_TYPE = YES; 245 | GCC_WARN_UNUSED_VARIABLE = YES; 246 | INFOPLIST_FILE = Resources; 247 | SDKROOT = macosx; 248 | }; 249 | name = Debug; 250 | }; 251 | C01FCF5008A954540054247B /* Release */ = { 252 | isa = XCBuildConfiguration; 253 | buildSettings = { 254 | GCC_WARN_ABOUT_RETURN_TYPE = YES; 255 | GCC_WARN_UNUSED_VARIABLE = YES; 256 | INFOPLIST_FILE = Resources; 257 | SDKROOT = macosx; 258 | }; 259 | name = Release; 260 | }; 261 | /* End XCBuildConfiguration section */ 262 | 263 | /* Begin XCConfigurationList section */ 264 | C01FCF4A08A954540054247B /* Build configuration list for PBXNativeTarget "DBPrefsWindowController" */ = { 265 | isa = XCConfigurationList; 266 | buildConfigurations = ( 267 | C01FCF4B08A954540054247B /* Debug */, 268 | C01FCF4C08A954540054247B /* Release */, 269 | ); 270 | defaultConfigurationIsVisible = 0; 271 | defaultConfigurationName = Release; 272 | }; 273 | C01FCF4E08A954540054247B /* Build configuration list for PBXProject "DBPrefsWindowController" */ = { 274 | isa = XCConfigurationList; 275 | buildConfigurations = ( 276 | C01FCF4F08A954540054247B /* Debug */, 277 | C01FCF5008A954540054247B /* Release */, 278 | ); 279 | defaultConfigurationIsVisible = 0; 280 | defaultConfigurationName = Release; 281 | }; 282 | /* End XCConfigurationList section */ 283 | }; 284 | rootObject = 29B97313FDCFA39411CA2CEA /* Project object */; 285 | } 286 | -------------------------------------------------------------------------------- /DBPrefsWindowController.xcodeproj/project.xcworkspace/contents.xcworkspacedata: -------------------------------------------------------------------------------- 1 | 2 | 4 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | DBPrefsWindowController 2 | ====== 3 | 4 | Originally created by [Dave Batton](http://www.mere-mortal-software.com/blog/details.php?d=2007-03-11). 5 | 6 | Application preference windows aren’t difficult to create. Just create an NSWindowController, set up a toolbar, create a nib file with either a series of custom views, or with an NSTabView object. The problem is, just setting up the toolbar and view swapping mechanism takes a lot of code, and it’s basically the same for every application. Sounds like an excellent opportunity to create a new class. 7 | 8 | ![](https://github.com/kgn/DBPrefsWindowController/raw/master/prefswindow.png) 9 | 10 | The goal of DBPrefsWindowController is to reduce the overhead of creating preference tabs to one line of code for each toolbar icon. This is achieved with an NSWindowController subclass named DBPrefsWindowController. 11 | 12 | Using DBPrefsWindowController 13 | ------ 14 | 15 | If you’re comfortable with subclassing and working with Interface Builder, you’ll be able to figure out how to use it from the included example project. Basically you just subclass it and connect your .h file to a nib file of custom views. The nib file should be named *Preferences*. Then just call `-addView:label:` to specify which views to display and what labels to use: 16 | 17 | - (void)setupToolbar 18 | { 19 | [self addView:generalPreferenceView label:@"General"]; 20 | [self addView:colorsPreferenceView label:@"Colors"]; 21 | [self addView:playbackPreferenceView label:@"Playback"]; 22 | [self addView:updatePreferenceView label:@"Update"]; 23 | [self addView:advancedPreferenceView label:@"Advanced"]; 24 | } 25 | 26 | When setup this way, DBPrefsWindowController will look for image files with names that match the labels supplied here. If your application is localized, you can instead call `-addView:label:image:` to specify the images to use for the toolbar icons. 27 | 28 | That’s really all there is to it. If you’ve already created a nib file with separate views for your preferences window, you can just use it instead of creating a new nib file. Either rename your nib file *Preferences*, or override the +nibName class method so it returns the name of your existing nib file. 29 | 30 | Documentation 31 | ------ 32 | 33 | The DBPrefsWindowController class is designed to be subclassed for each application in which it is used. The subclass should be set as the File’s Owner for a nib file named “Preferences.” The subclass should have NSView instances which are IBOutlets connected to views in the nib file. 34 | 35 | The nib file does not need to be connected to a window. If it is, it will be ignored and a new window will be created to display the preference views. 36 | 37 | + (DBPrefsWindowController *)sharedPrefsWindowController 38 | 39 | This class method returns a shared instance of the DBPrefsWindowController class. 40 | 41 | + (NSString *)nibName 42 | 43 | Override this class if you want to use a nib file named something other than *Preferences*. 44 | 45 | - (void)setupToolbar 46 | 47 | Override this method with calls to `-addView:label:` or `-addView:label:image:` to populate the toolbar. 48 | 49 | - (void)addView:(NSView *)view label:(NSString *)label 50 | 51 | Call this method as many times as needed from `-setupToolbar` to add new toolbar icons and custom views to the preferences window. An image with a name that matches the label should be available in the application bundle. It will be used as the toolbar icon. 52 | 53 | - (void)addView:(NSView *)view label:(NSString *)label image:(NSImage *)image 54 | 55 | This method can be used instead of `-addView:label:` if the application is localized, or if you just want to use icons with names that differ from the toolbar button labels. 56 | 57 | - (IBAction)showWindow:(id)sender 58 | 59 | Call this method to display the preferences window. For example: `[[AppPrefsWindowController sharedPrefsWindowController] showWindow:nil];` 60 | 61 | - (void)setCrossFade:(BOOL)fade` 62 | 63 | Call this method to enable or disable the cross-fade effect when switching views. The default value is `YES`. 64 | 65 | - (void) setShiftSlowsAnimation:(BOOL)slow 66 | 67 | Call this method to enable or disable the use of the shift key to slow down the animation when switching views. The default value is `YES`. 68 | 69 | -------------------------------------------------------------------------------- /Resources/Advanced.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kgn/DBPrefsWindowController/b7d34e07a97ca9d3bed63d3abe5043a19b632490/Resources/Advanced.png -------------------------------------------------------------------------------- /Resources/Colors.tiff: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kgn/DBPrefsWindowController/b7d34e07a97ca9d3bed63d3abe5043a19b632490/Resources/Colors.tiff -------------------------------------------------------------------------------- /Resources/English.lproj/MainMenu.xib: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 1070 5 | 11E2620 6 | 2541 7 | 1138.47 8 | 569.00 9 |

13 | 14 | NSCustomObject 15 | NSMenu 16 | NSMenuItem 17 | 18 | 19 | com.apple.InterfaceBuilder.CocoaPlugin 20 | 21 |

25 | 26 |

31 |

34 |

37 |

478 |

481 | 482 |

1111 |

1134 | 0 1135 | IBCocoaFramework 1136 |

1140 | YES 1141 | 3 1142 | 1143 | {11, 11} 1144 | {10, 3} 1145 | 1146 | 1147 | 1148 | -------------------------------------------------------------------------------- /Resources/General.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kgn/DBPrefsWindowController/b7d34e07a97ca9d3bed63d3abe5043a19b632490/Resources/General.png -------------------------------------------------------------------------------- /Resources/Info.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | CFBundleDevelopmentRegion 6 | English 7 | CFBundleExecutable 8 | ${EXECUTABLE_NAME} 9 | CFBundleIconFile 10 | 11 | CFBundleIdentifier 12 | com.mere-mortal-software.dbprefswindowcontroller 13 | CFBundleInfoDictionaryVersion 14 | 6.0 15 | CFBundleName 16 | ${PRODUCT_NAME} 17 | CFBundlePackageType 18 | APPL 19 | CFBundleSignature 20 | ???? 21 | CFBundleVersion 22 | 1.0 23 | NSMainNibFile 24 | MainMenu 25 | NSPrincipalClass 26 | NSApplication 27 | 28 | 29 | -------------------------------------------------------------------------------- /Resources/Playback.tiff: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kgn/DBPrefsWindowController/b7d34e07a97ca9d3bed63d3abe5043a19b632490/Resources/Playback.tiff -------------------------------------------------------------------------------- /Resources/Preferences.xib: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 1070 5 | 11E2620 6 | 2541 7 | 1138.47 8 | 569.00 9 |

39 | 40 |

43 |

46 |

49 |

361 |

536 |

592 |

595 |

672 |

960 | 961 |

2324 |

2373 | 0 2374 | IBCocoaFramework 2375 |

2379 | YES 2380 | 3 2381 | 2382 | {11, 11} 2383 | {10, 3} 2384 | {15, 15} 2385 | 2386 | 2387 | 2388 | -------------------------------------------------------------------------------- /Resources/Updates.tiff: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kgn/DBPrefsWindowController/b7d34e07a97ca9d3bed63d3abe5043a19b632490/Resources/Updates.tiff -------------------------------------------------------------------------------- /Source/AppController.h: -------------------------------------------------------------------------------- 1 | // 2 | // AppController.m 3 | // 4 | 5 | #import 6 | 7 | @interface AppController : NSObject 8 | 9 | - (IBAction)openPreferences:(id)sender; 10 | 11 | @end 12 | -------------------------------------------------------------------------------- /Source/AppController.m: -------------------------------------------------------------------------------- 1 | // 2 | // AppController.m 3 | // 4 | 5 | #import "AppController.h" 6 | #import "AppPrefsWindowController.h" 7 | 8 | @implementation AppController 9 | 10 | + (void)initialize{ 11 | NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; 12 | NSDictionary *appDefaults = [NSDictionary dictionaryWithObjectsAndKeys: 13 | @"YES", @"openAtStartup", 14 | @"YES", @"fade", 15 | @"YES", @"shiftSlowsAnimation", 16 | nil]; 17 | [defaults registerDefaults:appDefaults]; 18 | } 19 | 20 | - (void)awakeFromNib{ 21 | NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; 22 | [defaults addObserver:self 23 | forKeyPath:@"fade" 24 | options:NSKeyValueObservingOptionOld 25 | context:NULL]; 26 | [defaults addObserver:self 27 | forKeyPath:@"shiftSlowsAnimation" 28 | options:NSKeyValueObservingOptionOld 29 | context:NULL]; 30 | if([[NSUserDefaults standardUserDefaults] boolForKey:@"openAtStartup"]){ 31 | [self openPreferences:self]; 32 | } 33 | } 34 | 35 | - (void)dealloc{ 36 | NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; 37 | [defaults removeObserver:self forKeyPath:@"fade"]; 38 | [defaults removeObserver:self forKeyPath:@"shiftSlowsAnimation"]; 39 | } 40 | 41 | - (IBAction)openPreferences:(id)sender{ 42 | [[AppPrefsWindowController sharedPrefsWindowController] showWindow:nil]; 43 | } 44 | 45 | - (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object change:(NSDictionary *)change context:(void *)context{ 46 | [[AppPrefsWindowController sharedPrefsWindowController] setCrossFade:[[NSUserDefaults standardUserDefaults] boolForKey:@"fade"]]; 47 | [[AppPrefsWindowController sharedPrefsWindowController] setShiftSlowsAnimation:[[NSUserDefaults standardUserDefaults] boolForKey:@"shiftSlowsAnimation"]]; 48 | } 49 | 50 | @end 51 | -------------------------------------------------------------------------------- /Source/AppPrefsWindowController.h: -------------------------------------------------------------------------------- 1 | // 2 | // AppPrefsWindowController.h 3 | // 4 | 5 | #import 6 | #import "DBPrefsWindowController.h" 7 | 8 | @interface AppPrefsWindowController : DBPrefsWindowController 9 | 10 | @property (strong, nonatomic) IBOutlet NSView *generalPreferenceView; 11 | @property (strong, nonatomic) IBOutlet NSView *colorsPreferenceView; 12 | @property (strong, nonatomic) IBOutlet NSView *playbackPreferenceView; 13 | @property (strong, nonatomic) IBOutlet NSView *updatesPreferenceView; 14 | @property (strong, nonatomic) IBOutlet NSView *advancedPreferenceView; 15 | 16 | @end 17 | -------------------------------------------------------------------------------- /Source/AppPrefsWindowController.m: -------------------------------------------------------------------------------- 1 | // 2 | // AppPrefsWindowController.m 3 | // 4 | 5 | #import "AppPrefsWindowController.h" 6 | 7 | @implementation AppPrefsWindowController 8 | 9 | - (void)setupToolbar{ 10 | [self addView:self.generalPreferenceView label:@"General"]; 11 | [self addView:self.colorsPreferenceView label:@"Colors"]; 12 | [self addView:self.playbackPreferenceView label:@"Playback"]; 13 | [self addView:self.updatesPreferenceView label:@"Updates"]; 14 | [self addFlexibleSpacer]; 15 | [self addView:self.advancedPreferenceView label:@"Advanced"]; 16 | 17 | // Optional configuration settings. 18 | [self setCrossFade:[[NSUserDefaults standardUserDefaults] boolForKey:@"fade"]]; 19 | [self setShiftSlowsAnimation:[[NSUserDefaults standardUserDefaults] boolForKey:@"shiftSlowsAnimation"]]; 20 | } 21 | 22 | @end 23 | -------------------------------------------------------------------------------- /Source/DBPrefsWindowController.h: -------------------------------------------------------------------------------- 1 | // 2 | // DBPrefsWindowController.h 3 | // 4 | // Created by Dave Batton 5 | // http://www.Mere-Mortal-Software.com/blog/ 6 | // 7 | // Updated by David Keegan 8 | // https://github.com/kgn/DBPrefsWindowController 9 | // 10 | // Copyright 2007. Some rights reserved. 11 | // This work is licensed under a Creative Commons license: 12 | // http://creativecommons.org/licenses/by/3.0/ 13 | 14 | #import 15 | 16 | @interface DBPrefsWindowController : NSWindowController 17 | 18 | @property (nonatomic) BOOL crossFade; 19 | @property (nonatomic) BOOL shiftSlowsAnimation; 20 | 21 | + (DBPrefsWindowController *)sharedPrefsWindowController; 22 | + (NSString *)nibName; 23 | 24 | - (void)setupToolbar; 25 | - (void)addFlexibleSpacer; 26 | - (void)addView:(NSView *)view label:(NSString *)label; 27 | - (void)addView:(NSView *)view label:(NSString *)label image:(NSImage *)image; 28 | 29 | - (void)toggleActivePreferenceView:(NSToolbarItem *)toolbarItem; 30 | - (void)displayViewForIdentifier:(NSString *)identifier animate:(BOOL)animate; 31 | - (void)crossFadeView:(NSView *)oldView withView:(NSView *)newView; 32 | - (NSRect)frameForView:(NSView *)view; 33 | 34 | // select both the view & toolbar item for the given identifier 35 | - (void)loadViewForIdentifier:(NSString *)identifier animate:(BOOL)animate; 36 | 37 | @end 38 | -------------------------------------------------------------------------------- /Source/DBPrefsWindowController.m: -------------------------------------------------------------------------------- 1 | // 2 | // DBPrefsWindowController.m 3 | // 4 | 5 | #import "DBPrefsWindowController.h" 6 | 7 | @interface DBPrefsWindowController() 8 | @property (nonatomic, strong) NSMutableArray *toolbarIdentifiers; 9 | @property (nonatomic, strong) NSMutableDictionary *toolbarViews; 10 | @property (nonatomic, strong) NSMutableDictionary *toolbarItems; 11 | @property (nonatomic, strong) NSViewAnimation *viewAnimation; 12 | @property (nonatomic, strong) NSView *contentSubview; 13 | @end 14 | 15 | @implementation DBPrefsWindowController 16 | 17 | #pragma mark - 18 | #pragma mark Class Methods 19 | 20 | + (DBPrefsWindowController *)sharedPrefsWindowController{ 21 | static DBPrefsWindowController *_sharedPrefsWindowController = nil; 22 | if(!_sharedPrefsWindowController){ 23 | _sharedPrefsWindowController = [[self alloc] initWithWindowNibName:[self nibName]]; 24 | } 25 | return _sharedPrefsWindowController; 26 | } 27 | 28 | // Subclasses can override this to use a nib with a different name. 29 | + (NSString *)nibName{ 30 | return @"Preferences"; 31 | } 32 | 33 | 34 | #pragma mark - 35 | #pragma mark Setup & Teardown 36 | 37 | - (id)initWithWindow:(NSWindow *)window{ 38 | if((self = [super initWithWindow:nil])){ 39 | // Set up an array and some dictionaries to keep track 40 | // of the views we'll be displaying. 41 | self.toolbarIdentifiers = [[NSMutableArray alloc] init]; 42 | self.toolbarViews = [[NSMutableDictionary alloc] init]; 43 | self.toolbarItems = [[NSMutableDictionary alloc] init]; 44 | 45 | // Set up an NSViewAnimation to animate the transitions. 46 | self.viewAnimation = [[NSViewAnimation alloc] init]; 47 | [self.viewAnimation setAnimationBlockingMode:NSAnimationNonblocking]; 48 | [self.viewAnimation setAnimationCurve:NSAnimationEaseInOut]; 49 | [self.viewAnimation setDelegate:(id)self]; 50 | 51 | self.crossFade = YES; 52 | self.shiftSlowsAnimation = YES; 53 | } 54 | return self; 55 | } 56 | 57 | - (void)windowDidLoad{ 58 | // Create a new window to display the preference views. 59 | // If the developer attached a window to this controller 60 | // in Interface Builder, it gets replaced with this one. 61 | NSWindow *window = 62 | [[NSWindow alloc] initWithContentRect:NSMakeRect(0,0,1000,1000) 63 | styleMask:(NSTitledWindowMask | 64 | NSClosableWindowMask | 65 | NSMiniaturizableWindowMask) 66 | backing:NSBackingStoreBuffered 67 | defer:YES]; 68 | [self setWindow:window]; 69 | self.contentSubview = [[NSView alloc] initWithFrame:[[[self window] contentView] frame]]; 70 | [self.contentSubview setAutoresizingMask:(NSViewMinYMargin | NSViewWidthSizable)]; 71 | [[[self window] contentView] addSubview:self.contentSubview]; 72 | [[self window] setShowsToolbarButton:NO]; 73 | } 74 | 75 | 76 | #pragma mark - 77 | #pragma mark Configuration 78 | 79 | - (void)setupToolbar{ 80 | // Subclasses must override this method to add items to the 81 | // toolbar by calling -addView:label: or -addView:label:image:. 82 | } 83 | 84 | - (void)addToolbarItemForIdentifier:(NSString *)identifier 85 | label:(NSString *)label 86 | image:(NSImage *)image 87 | selector:(SEL)selector { 88 | [self.toolbarIdentifiers addObject:identifier]; 89 | 90 | NSToolbarItem *item = [[NSToolbarItem alloc] initWithItemIdentifier:identifier]; 91 | [item setLabel:label]; 92 | [item setImage:image]; 93 | [item setTarget:self]; 94 | [item setAction:selector]; 95 | 96 | (self.toolbarItems)[identifier] = item; 97 | } 98 | 99 | - (void)addFlexibleSpacer { 100 | [self addToolbarItemForIdentifier:NSToolbarFlexibleSpaceItemIdentifier label:nil image:nil selector:nil]; 101 | } 102 | 103 | - (void)addView:(NSView *)view label:(NSString *)label{ 104 | [self addView:view label:label image:[NSImage imageNamed:label]]; 105 | } 106 | 107 | - (void)addView:(NSView *)view label:(NSString *)label image:(NSImage *)image{ 108 | if(view == nil){ 109 | return; 110 | } 111 | 112 | NSString *identifier = [label copy]; 113 | (self.toolbarViews)[identifier] = view; 114 | [self addToolbarItemForIdentifier:identifier 115 | label:label 116 | image:image 117 | selector:@selector(toggleActivePreferenceView:)]; 118 | } 119 | 120 | 121 | #pragma mark - 122 | #pragma mark Overriding Methods 123 | 124 | - (IBAction)showWindow:(id)sender{ 125 | // This forces the resources in the nib to load. 126 | [self window]; 127 | 128 | // Clear the last setup and get a fresh one. 129 | [self.toolbarIdentifiers removeAllObjects]; 130 | [self.toolbarViews removeAllObjects]; 131 | [self.toolbarItems removeAllObjects]; 132 | [self setupToolbar]; 133 | 134 | if(![_toolbarIdentifiers count]){ 135 | return; 136 | } 137 | 138 | if([[self window] toolbar] == nil){ 139 | NSToolbar *toolbar = [[NSToolbar alloc] initWithIdentifier:@"DBPreferencesToolbar"]; 140 | [toolbar setAllowsUserCustomization:NO]; 141 | [toolbar setAutosavesConfiguration:NO]; 142 | [toolbar setSizeMode:NSToolbarSizeModeDefault]; 143 | [toolbar setDisplayMode:NSToolbarDisplayModeIconAndLabel]; 144 | [toolbar setDelegate:(id)self]; 145 | [[self window] setToolbar:toolbar]; 146 | } 147 | 148 | NSString *firstIdentifier = (self.toolbarIdentifiers)[0]; 149 | [[[self window] toolbar] setSelectedItemIdentifier:firstIdentifier]; 150 | [self displayViewForIdentifier:firstIdentifier animate:NO]; 151 | 152 | [[self window] center]; 153 | 154 | [super showWindow:sender]; 155 | } 156 | 157 | 158 | #pragma mark - 159 | #pragma mark Toolbar 160 | 161 | - (NSArray *)toolbarDefaultItemIdentifiers:(NSToolbar*)toolbar{ 162 | return self.toolbarIdentifiers; 163 | } 164 | 165 | - (NSArray *)toolbarAllowedItemIdentifiers:(NSToolbar*)toolbar{ 166 | return self.toolbarIdentifiers; 167 | } 168 | 169 | - (NSArray *)toolbarSelectableItemIdentifiers:(NSToolbar *)toolbar{ 170 | return self.toolbarIdentifiers; 171 | } 172 | 173 | - (NSToolbarItem *)toolbar:(NSToolbar *)toolbar itemForItemIdentifier:(NSString *)identifier willBeInsertedIntoToolbar:(BOOL)willBeInserted{ 174 | return (self.toolbarItems)[identifier]; 175 | } 176 | 177 | - (void)toggleActivePreferenceView:(NSToolbarItem *)toolbarItem{ 178 | [self displayViewForIdentifier:[toolbarItem itemIdentifier] animate:YES]; 179 | } 180 | 181 | - (void)displayViewForIdentifier:(NSString *)identifier animate:(BOOL)animate{ 182 | // Find the view we want to display. 183 | NSView *newView = (self.toolbarViews)[identifier]; 184 | 185 | // See if there are any visible views. 186 | NSView *oldView = nil; 187 | if([[self.contentSubview subviews] count] > 0) { 188 | // Get a list of all of the views in the window. Usually at this 189 | // point there is just one visible view. But if the last fade 190 | // hasn't finished, we need to get rid of it now before we move on. 191 | NSEnumerator *subviewsEnum = [[self.contentSubview subviews] reverseObjectEnumerator]; 192 | 193 | // The first one (last one added) is our visible view. 194 | oldView = [subviewsEnum nextObject]; 195 | 196 | // Remove any others. 197 | NSView *reallyOldView = nil; 198 | while((reallyOldView = [subviewsEnum nextObject]) != nil){ 199 | [reallyOldView removeFromSuperviewWithoutNeedingDisplay]; 200 | } 201 | } 202 | 203 | if(![newView isEqualTo:oldView]){ 204 | NSRect frame = [newView bounds]; 205 | frame.origin.y = NSHeight([self.contentSubview frame]) - NSHeight([newView bounds]); 206 | [newView setFrame:frame]; 207 | [self.contentSubview addSubview:newView]; 208 | [[self window] setInitialFirstResponder:newView]; 209 | 210 | if(animate && [self crossFade]){ 211 | [self crossFadeView:oldView withView:newView]; 212 | }else{ 213 | [oldView removeFromSuperviewWithoutNeedingDisplay]; 214 | [newView setHidden:NO]; 215 | [[self window] setFrame:[self frameForView:newView] display:YES animate:animate]; 216 | } 217 | 218 | [[self window] setTitle:[(self.toolbarItems)[identifier] label]]; 219 | } 220 | } 221 | 222 | - (void)loadViewForIdentifier:(NSString *)identifier animate:(BOOL)animate { 223 | [[[self window] toolbar] setSelectedItemIdentifier:identifier]; 224 | [self displayViewForIdentifier:identifier animate:animate]; 225 | } 226 | 227 | 228 | #pragma mark - 229 | #pragma mark Cross-Fading Methods 230 | 231 | - (void)crossFadeView:(NSView *)oldView withView:(NSView *)newView{ 232 | [self.viewAnimation stopAnimation]; 233 | 234 | if([self shiftSlowsAnimation] && [[[self window] currentEvent] modifierFlags] & NSShiftKeyMask){ 235 | [self.viewAnimation setDuration:1.25]; 236 | }else{ 237 | [self.viewAnimation setDuration:0.25]; 238 | } 239 | 240 | NSDictionary *fadeOutDictionary = 241 | @{NSViewAnimationTargetKey: oldView, 242 | NSViewAnimationEffectKey: NSViewAnimationFadeOutEffect}; 243 | 244 | NSDictionary *fadeInDictionary = 245 | @{NSViewAnimationTargetKey: newView, 246 | NSViewAnimationEffectKey: NSViewAnimationFadeInEffect}; 247 | 248 | NSDictionary *resizeDictionary = 249 | @{NSViewAnimationTargetKey: [self window], 250 | NSViewAnimationStartFrameKey: [NSValue valueWithRect:[[self window] frame]], 251 | NSViewAnimationEndFrameKey: [NSValue valueWithRect:[self frameForView:newView]]}; 252 | 253 | NSArray *animationArray = 254 | @[fadeOutDictionary, 255 | fadeInDictionary, 256 | resizeDictionary]; 257 | 258 | [self.viewAnimation setViewAnimations:animationArray]; 259 | [self.viewAnimation startAnimation]; 260 | } 261 | 262 | - (void)animationDidEnd:(NSAnimation *)animation{ 263 | NSView *subview; 264 | 265 | // Get a list of all of the views in the window. Hopefully 266 | // at this point there are two. One is visible and one is hidden. 267 | NSEnumerator *subviewsEnum = [[self.contentSubview subviews] reverseObjectEnumerator]; 268 | 269 | // This is our visible view. Just get past it. 270 | [subviewsEnum nextObject]; 271 | 272 | // Remove everything else. There should be just one, but 273 | // if the user does a lot of fast clicking, we might have 274 | // more than one to remove. 275 | while((subview = [subviewsEnum nextObject]) != nil){ 276 | [subview removeFromSuperviewWithoutNeedingDisplay]; 277 | } 278 | 279 | // This is a work-around that prevents the first 280 | // toolbar icon from becoming highlighted. 281 | [[self window] makeFirstResponder:nil]; 282 | } 283 | 284 | // Calculate the window size for the new view. 285 | - (NSRect)frameForView:(NSView *)view{ 286 | NSRect windowFrame = [[self window] frame]; 287 | NSRect contentRect = [[self window] contentRectForFrameRect:windowFrame]; 288 | float windowTitleAndToolbarHeight = NSHeight(windowFrame) - NSHeight(contentRect); 289 | 290 | windowFrame.size.height = NSHeight([view frame]) + windowTitleAndToolbarHeight; 291 | windowFrame.size.width = NSWidth([view frame]); 292 | windowFrame.origin.y = NSMaxY([[self window] frame]) - NSHeight(windowFrame); 293 | 294 | return windowFrame; 295 | } 296 | 297 | // Close the window with cmd+w incase the app doesn't have an app menu 298 | - (void)keyDown:(NSEvent *)theEvent{ 299 | NSString *key = [theEvent charactersIgnoringModifiers]; 300 | if(([theEvent modifierFlags] & NSCommandKeyMask) && [key isEqualToString:@"w"]){ 301 | [self close]; 302 | }else{ 303 | [super keyDown:theEvent]; 304 | } 305 | } 306 | 307 | @end 308 | -------------------------------------------------------------------------------- /Source/main.m: -------------------------------------------------------------------------------- 1 | // 2 | // main.m 3 | // 10 March 2007 4 | // 5 | 6 | 7 | #import 8 | 9 | int main(int argc, char *argv[]) 10 | { 11 | return NSApplicationMain(argc, (const char **) argv); 12 | } 13 | -------------------------------------------------------------------------------- /prefswindow.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kgn/DBPrefsWindowController/b7d34e07a97ca9d3bed63d3abe5043a19b632490/prefswindow.png --------------------------------------------------------------------------------