Blog Archives

Change Company Name in XCode __MyCompanyName__ Objective-C Cocoa

See references below for original article.

There are a couple ways to change the __MyCompanyName__ value.

Permanently (open terminal and enter):

defaults write com.apple.Xcode PBXCustomTemplateMacroDefinitions -dict ORGANIZATIONNAME "__MyCompanyName__

Alternatively, changing the “Me” card in Address book or going to Project->Edit Project Settings->General Tab in XCode 3.2.3 also work.

References
codza.com, http://www.codza.com/change-mycompanyname-in-xcode-templates

Advertisements

Get Current Directory in Objective-C

Since Mac OS X is a unix based system, you can always use “getcwd” from the standard C library, but in general if you want to stick within the context of Objective-C/Cocoa, see the examples below.

Here’s one snippet you will probably Google quickly, but ultimately not the solution I chose.

(original code from stackoverflow see reference below)

NSFileManager *filemgr;
NSString *currentpath;

filemgr = [[NSFileManager alloc] init];

currentpath = [filemgr currentDirectoryPath];

Solution

Using the “bundle path” rather than “executable path” turned out to work much better in my instance:

NSString *currentpath = [[[[NSBundle mainBundle] bundlePath] stringByDeletingPathExtension] stringByDeletingLastPathcomponent];
NSString *fileName = [NSString stringWithFormat:@"%@/%@/",currentpath,@"filename.pdf"];

References
stackoverflow.com, http://stackoverflow.com/questions/3692489/getting-current-directory-in-objective-c
friendlydeveloper.com, “NSFileManager”, http://www.friendlydeveloper.com/tag/nsfilemanager/
techtopia.com, “Working with Directories in Objective c”, http://www.techotopia.com/index.php/Working_with_Directories_in_Objective-C
Macrumors Forums, http://forums.macrumors.com/showthread.php?t=524754
stackoverflow, “Find Parent Directory of a path”, http://stackoverflow.com/questions/1309524/cocoa-objc-find-parent-directory-of-a-path

Concatenate string in Objective-C

Unfortunately, this is not as straight forward as it seems it should be. This really comes down to roughly two approaches in my opinion:

stringByAppendingString approach:

NSString *robot= @"Ronnie";
NSString *robotname = [robot stringByAppendingString:@" is the name of a robot."];

strigWithFormat approach:

NSString *robot= @"Ronnie";
NSString *robotname= @" is the name of the a robot.";
NSString *robotknowledge = @" knows eight languages.";
[NSString stringWithFormat:@"%@/%@/%@", robot, robotname, robot, robotknowledge];

References
StackOverflow, http://stackoverflow.com/questions/510269/how-do-i-concatenate-strings-in-objective-c
cocoadevcentral.com, “Learn Objective-C”, http://cocoadevcentral.com/d/learn_objectivec/

Show Dialog Message Box in Objective-C Cocoa

There are a few ways to achieve this in Objective-C/Cocoa, and I found NSAlert to be the simplest base class for this purpose.

See example below of a small Utility class with this functionality.

Util.h

#import <Cocoa/Cocoa.h>

@interface Util: NSObject {
}

+(void)MessageBox:(char*) header:(char*) message: (unsigned long) message_type;

+(void)MessageBox:(NSString *) header:(NSString *) message;

@end

Util.m


#import "Util.h"

@implementation Util

+(void)MessageBox:(NSString *) header:(NSString *) message
{
CFOptionFlags result;

CFUserNotificationDisplayAlert(
0, //timeout
kCFUserNotificationNoteAlertLevel, //icon
NULL, //icon url
NULL,
NULL,
header,
message,
NULL, //button options default to just "ok"
CFSTR("Cancel"),
NULL,
&result //response
);

if (result==kCFUserNotificationDefaultResponse)
return NSAlertDefaultReturn;
else
return NSAlertErrorReturn;
}

+(void)MessageBox:(char*) header:(char*) message: (unsigned long) message_type
{
CFStringRef header_ref = CFStringCreateWithCString(NULL,header,strlen(header));
CFStringRef message_ref = CFStringCreateWithCString(NULL,message,strlen(message));

CFOptionFlags result;

CFUserNotificationDisplayAlert(
0,
kCFUserNotificationNoteAlertLevel,
NULL,
NULL,
NULL,
header_ref,
message_ref,
NULL,
CFSTR("Cancel"),
NULL,
&result
);

CFRelease(header_ref);
CFRelease(message_ref);

if (result==kCFUserNotificationDefaultResponse)
return NSAlertDefaultReturn;
else
return NSAlertErrorReturn;
}
@end

References
iphonedevsdk.com, http://www.iphonedevsdk.com/forum/iphone-sdk-development/8478-simple-message-box-popup.html
blogspot.com, Jorge Arimany, http://jorgearimany.blogspot.com/2010/05/messagebox-from-windows-to-mac.html
Google Codesearch (“kCFUserNotification”),

View PDF in Objective-C Cocoa on Mac OS X using PDFKit

The code below has been tested and works clean on the latest version of Mac OS X 10.5 Leopard.

Since it applies to native Mac OS X, and not iOS, porting this to work on iPhone/iPad is a bit different, however, it is overall very easy once you have the base concept and the main functionality below is the same.

Note: If you create this as a blank new project and are new to PDFKit, first make sure to add the Quartz framework to your project. (ref)

First, create a class (and corresponding header) to utilize the PDF. (CODE IS CASE SENSITIVE)

PDFImageView.h

#import <Cocoa/Cocoa.h>
#import <Quartz/Quartz.h>

@interface PDFImageView : NSImageView

- (void) loadFromPath: (NSString *) path;

@end

PDFImageView.m

#import "PDFImageView.h"
#import "DraggableScrollView.h"

@implementation PDFImageView

- (NSPDFImageRep *) pdfRep
{
return [[[self image] representations] lastObject];
}

- (void) loadFromPath: (NSString *)path
{
NSPDFImageRep *pdfRep;
NSImage *pdfImage;
NSRect frame;

pdfRep = [NSPDFImageRep imageRepWithContentsOfFile:path];
pdfImage = [[[NSImage alloc] init]autorelease];
[pdfImage addRepresentation: pdfRep];

frame = [pdfRep bounds];
frame.size.height *= [pdfRep pageCount];

[self setImage: pdfImage];

[super setFrame: frame];

if ([self isFlipped])
    [self scrollPoint: NSMakePoint(0,0)];
else {
    [self scrollPoint: NSMakePoint(0,frame.size.height)];
}
}

- (void) drawRect: (NSRect) rect
{
NSPDFImageRep *rep;
int pageCount, pageNumber;
NSRect onePageBounds;

[[NSColor whiteColor] set];
NSRectFill (rect);

rep = [self pdfRep];
pageCount = [rep pageCount];

for (pageNumber=0;pageNumber<pageCount;pageNumber++)
{
onePageBounds = [self rectForPage: (1+pageNumber)];
if (! NSIntersectsRect(rect, onePageBounds))
continue;

[rep setCurrentPage: pageNumber];
[rep drawInRect: onePageBounds];
}
}

- (void) mouseDown: (NSEvent *) theEvent
{
NSScrollView *scrollView;
scrollView=[self enclosingScrollView];
if ([scrollView respondsToSelector: @selector(dragDocumentWithMouseDown:)])
[(DraggableScrollView*)scrollView dragDocumentWithMouseDown: theEvent];
else {
[super mouseDown: theEvent];
}

- (void) setFrameSize: (NSSize) newSize
{
NSSize PDFsize;
float correctHeight;

PDFsize = [[self pdfRep] bounds].size;
correctHeight = [[self pdfRep] pageCount] * (PDfsize.height/PDFsize.width) * newSize.width;
correctHeight = ceil(correctHeight);

if (abs (correctHeight - newSize.height) > 3.0)
newSize.height = correctHeight;

[super setFrameSize: newSize];
}

- (BOOL) knowsPageRange: (NSRangePointer) range
{
range->location=1;
range->length=[[self pdfRep] pageCount];

return YES;
}

- (NSRect) rectForPage: (int) pageNumber
{
NSPDFImageRep *rep;
int pageCount;
NSRect result;

rep = [self pdfRep];
pageCount = [rep PageCount];

result = [rep bounds];
if (! [self isFlipped])
result = NSOffsetRect(result,0.0,(pageCount-1)*result.size.height);

if ([self isFlipped])
result = NSOffsetRect (result,0.0,(pageNumber-1)*result.size.height);
else {
result = NSOffsetRect (result,0.0,-(pageNumber-1)*result.size.height);

return result;
}
}
@end

This class is courtesy of Apple DC and used in the above PDFViewer class. You shouldn’t have to really do anything additional in this one, just plug and play. Allows user to scroll with mouse. I removed alot of comments for brevity to minimize code lines. See Apple reference at bottom for full source and additional info.

DraggableScrollView.h

#import <Cocoa/Cocoa.h>
 
@interface DraggableScrollView : NSScrollView
 
- (BOOL) dragDocumentWithMouseDown:
    (NSEvent *) theEvent;
 
@end

DraggableScrollView.m

#import "DraggableScrollView.h"
 
@implementation DraggableScrollView
 
#pragma mark PRIVATE CLASS METHODS
 
+ (NSCursor *) dragCursor
{
    static NSCursor *openHandCursor = nil;
 
    if (openHandCursor == nil)
    {
        NSImage     *image;
 
        image = [NSImage imageNamed: @"fingerCursor"];
        openHandCursor = [[NSCursor alloc] initWithImage: image
            hotSpot: NSMakePoint (8, 8)]; // guess that the center is good
    }
 
    return openHandCursor;
}
 
 
#pragma mark PRIVATE INSTANCE METHODS
 
- (BOOL) canScroll
{
    if ([[self documentView] frame].size.height > [self documentVisibleRect].size.height)
        return YES;
    if ([[self documentView] frame].size.width > [self documentVisibleRect].size.width)
        return YES;
 
    return NO;
}
 
 
#pragma mark PUBLIC INSTANCE METHODS -- OVERRIDES FROM NSScrolLView
 
- (void) tile
{
    [super tile];
 
    //  If the user can scroll right now, make our document cursor reflect that.
    if ([self canScroll])
        [self setDocumentCursor: [[self class] dragCursor]];
    else
        [self setDocumentCursor: [NSCursor arrowCursor]];
}
 
 
#pragma mark PUBLIC INSTANCE METHODS
 
//  dragDocumentWithMouseDown: -- Given a mousedown event, which should be in
//  our document view, track the mouse to let the user drag the document.
- (BOOL) dragDocumentWithMouseDown: (NSEvent *) theEvent // RETURN: YES => user dragged (not clicked)
{
    NSPoint         initialLocation;
    NSRect          visibleRect;
    BOOL            keepGoing;
    BOOL            result = NO;
 
    initialLocation = [theEvent locationInWindow];
    visibleRect = [[self documentView] visibleRect];
    keepGoing = YES;
 
    while (keepGoing)
    {
        theEvent = [[self window] nextEventMatchingMask: NSLeftMouseUpMask | NSLeftMouseDraggedMask];
        switch ([theEvent type])
        {
            case NSLeftMouseDragged:
            {
                NSPoint newLocation;
                NSRect  newVisibleRect;
                float   xDelta, yDelta;
 
                newLocation = [theEvent locationInWindow];
                xDelta = initialLocation.x - newLocation.x;
                yDelta = initialLocation.y - newLocation.y;
 
                //  This was an amusing bug: without checking for flipped,
                //  you could drag up, and the document would sometimes move down!
                if ([[self documentView] isFlipped])
                    yDelta = -yDelta;
 
                //  If they drag MORE than one pixel, consider it a drag
                if ( (abs (xDelta) > 1) || (abs (yDelta) > 1) )
                    result = YES;
 
                newVisibleRect = NSOffsetRect (visibleRect, xDelta, yDelta);
                [[self documentView] scrollRectToVisible: newVisibleRect];
            }
            break;
 
            case NSLeftMouseUp:
                keepGoing = NO;
                break;
 
            default:
                /* Ignore any other kind of event. */
                break;
        }                               // end of switch (event type)
    }                                   // end of mouse-tracking loop
 
    return result;
}
 
@end

And now for the main class of our application which will use the above PDFImageView class and bind/map to our interface.

MainView.h

#import <Cocoa/Cocoa.h>
#import <Quartz/Quartz.h>

@interface MainView : NSDocument {
IBOutlet PDFView *_pdfView;
}

@end

MainView.m

#import "MainView.h"

@implementation MainView

//will load PDF from local filesystem in current path as .app is launched from
-(void)awakeFromNib{
NSFileManager *filemgr;
filemgr = [[NsFileManager alloc]init];

NSString *currentpath = [[[[NSBundle mainBundle] bundlePath] stringByDeletingPathExtension] stringByDeletingLastPathcomponent];

//[Util MessageBox:@"currentpath":currentpath]; //SEE MY REFERENCE BELOW FOR DEBUG UTILITY CLASS

NSString *fileName = [NSString stringWithFormat:@"%@/%@/",currentpath,@"filename.pdf"];
PDFDocument *pdfDoc = [[PDFDocument alloc] initWithURL:[NSURL fileURLWithPath:fileName]];
[_pdfView setDocument: pdfDoc];
}

@end

References
Apple DC, http://developer.apple.com/library/mac/#samplecode/PDFView/Introduction/Intro.html
“Show Dialog Message Box in Objective-C Cocoa”, https://ronniediaz.com/2011/06/13/show-dialog-message-box-in-objective-c-cocoa/
Google CodeSearch (“_pdfView”), http://www.google.com/codesearch#search&q=_pdfView+lang:objectivec