Retired Document
Important: This sample code may not represent best practices for current development. The project may use deprecated symbols and illustrate technologies and techniques that are no longer recommended.
OpenURLPanel.m
/* |
File: OpenURLPanel.m |
Abstract: Contains code to handle opening URLs in our application. |
Version: 1.0 |
Disclaimer: IMPORTANT: This Apple software is supplied to you by |
Apple Inc. ("Apple") in consideration of your agreement to the |
following terms, and your use, installation, modification or |
redistribution of this Apple software constitutes acceptance of these |
terms. If you do not agree with these terms, please do not use, |
install, modify or redistribute this Apple software. |
In consideration of your agreement to abide by the following terms, and |
subject to these terms, Apple grants you a personal, non-exclusive |
license, under Apple's copyrights in this original Apple software (the |
"Apple Software"), to use, reproduce, modify and redistribute the Apple |
Software, with or without modifications, in source and/or binary forms; |
provided that if you redistribute the Apple Software in its entirety and |
without modifications, you must retain this notice and the following |
text and disclaimers in all such redistributions of the Apple Software. |
Neither the name, trademarks, service marks or logos of Apple Inc. |
may be used to endorse or promote products derived from the Apple |
Software without specific prior written permission from Apple. Except |
as expressly stated in this notice, no other rights or licenses, express |
or implied, are granted by Apple herein, including but not limited to |
any patent rights that may be infringed by your derivative works or by |
other works in which the Apple Software may be incorporated. |
The Apple Software is provided by Apple on an "AS IS" basis. APPLE |
MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION |
THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS |
FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND |
OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS. |
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL |
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, |
MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED |
AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), |
STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE |
POSSIBILITY OF SUCH DAMAGE. |
Copyright (C) 2004 - 2007 Apple Inc. All Rights Reserved. |
*/ |
#import "OpenURLPanel.h" |
// user defaults keys |
#define kUserDefaultURLsKey @"UserDefaultURLsKey" |
// maximum urls |
#define kMaximumURLs 15 |
@implementation OpenURLPanel |
static OpenURLPanel *openURLPanel = nil; |
// class methods |
+ (id)openURLPanel |
{ |
if (openURLPanel == nil) |
openURLPanel = [[self alloc] init]; |
return openURLPanel; |
} |
- (id)init |
{ |
[super init]; |
// init |
[self setURLArray:[NSMutableArray arrayWithCapacity:10]]; |
// listen for app termination notifications |
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(writeURLs:) name:NSApplicationWillTerminateNotification object:NSApp]; |
return self; |
} |
- (void)dealloc |
{ |
[[NSNotificationCenter defaultCenter] removeObserver:self]; |
[self setURLArray:nil]; |
[super dealloc]; |
} |
// getters |
- (NSString *)urlString |
{ |
NSString *urlString = nil; |
// get the url |
urlString = [mUrlComboBox stringValue]; |
if (urlString == nil) |
urlString = [mUrlComboBox objectValueOfSelectedItem]; |
if ([urlString length] == 0) |
urlString = nil; |
return urlString; |
} |
- (NSURL *)url |
{ |
NSURL *url = nil; |
NSString *urlString; |
// get the url |
urlString = [self urlString]; |
if (urlString) |
url = [NSURL URLWithString:urlString]; |
return url; |
} |
// setters |
- (void)setURLArray:(NSMutableArray *)urlLArray |
{ |
[urlLArray retain]; |
[mUrlArray retain]; |
mUrlArray = urlLArray; |
} |
// delegates |
- (void)awakeFromNib |
{ |
NSArray *urls; |
// restore the previous urls |
urls = [[NSUserDefaults standardUserDefaults] objectForKey:kUserDefaultURLsKey]; |
[mUrlArray addObjectsFromArray:urls]; |
if (urls) |
[mUrlComboBox addItemsWithObjectValues:urls]; |
} |
// notifications |
- (void)writeURLs:(NSNotification *)notification |
{ |
NSUserDefaults *userDefaults; |
if ([mUrlArray count]) |
{ |
// init |
userDefaults = [NSUserDefaults standardUserDefaults]; |
// write out the urls |
[userDefaults setObject:mUrlArray forKey:kUserDefaultURLsKey]; |
[userDefaults synchronize]; |
} |
} |
// actions |
- (IBAction)doOpenURL:(id)sender |
{ |
NSString *urlString; |
NSURL *url; |
BOOL informDelegate = YES; |
IMP callback; |
if ([sender tag] == NSOKButton) { |
// validate the URL |
url = [self url]; |
urlString = [self urlString]; |
if (url) { |
// save the url |
if (![mUrlArray containsObject:urlString]) { |
// save the url |
[mUrlArray addObject:urlString]; |
// add the url to the combo box |
[mUrlComboBox addItemWithObjectValue:urlString]; |
// remove the oldest url if the maximum has been exceeded |
if ([mUrlArray count] > kMaximumURLs) { |
[mUrlArray removeObjectAtIndex:0]; |
[mUrlComboBox removeItemAtIndex:0]; |
} |
} else { |
// move the url to the bottom of the list |
[mUrlArray removeObject:urlString]; |
[mUrlArray addObject:urlString]; |
[mUrlComboBox removeItemWithObjectValue:urlString]; |
[mUrlComboBox addItemWithObjectValue:urlString]; |
} |
} else { |
if (mIsSheet) |
NSRunAlertPanel(@"Invalid URL", @"The URL is not valid.", nil, nil, nil); |
else |
NSBeginAlertSheet(@"Invalid URL", nil, nil, nil, mPanel, nil, nil, nil, nil, @"The URL is not valid."); |
informDelegate = NO; |
} |
} |
// inform the delegate |
if (informDelegate && mDelegate && mDidEndSelector) { |
callback = [mDelegate methodForSelector:mDidEndSelector]; |
callback(mDelegate, mDidEndSelector, self, [sender tag], mContextInfo); |
} |
} |
// methods |
- (void)beginSheetWithWindow:(NSWindow *)window delegate:(id)delegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo |
{ |
// will this run as a sheet |
mIsSheet = (window ? YES : NO); |
// save the delegate, did end selector, and context info |
mDelegate = delegate; |
mDidEndSelector = (didEndSelector); |
mContextInfo = contextInfo; |
// load the bundle (if necessary) |
if (mPanel == nil) |
[NSBundle loadNibNamed:@"OpenURLPanel" owner:self]; |
// start the sheet (or window) |
[NSApp beginSheet:mPanel modalForWindow:window modalDelegate:nil didEndSelector:nil contextInfo:nil]; |
} |
- (void)close |
{ |
// close it down |
[NSApp endSheet:mPanel]; |
[mPanel close]; |
} |
@end |
Copyright © 2007 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2007-08-31