CocoaDev

Edit AllPages

If you are unfamiliar with nib files read this article before moving on:

http://cocoadevcentral.com/articles/000064.php

This project will build an General/NSMatrix view that uses General/NSTableView’s for cells. So here we go….

*Launch General/XCode and create a new Cocoa Application named General/TableViewMatrix *Create a new Objective-C General/NSView subclass named “General/TableViewMatrix” (File -> New File -> Objective-C General/NSView subclass) *Open “General/TableViewMatrix.h” in an editor, delete everything and paste the following code into this header

General/TableViewMatrix.h

#import <General/AppKit/General/AppKit.h>

@class General/TVMatrix, General/TVCell, General/TVTableView, General/TVScrollView;

@interface General/MainScrollView : General/NSScrollView { General/TVMatrix *tvMatrix; } @end

@interface General/TVMatrix : General/NSMatrix { General/NSMutableArray *registeredCells; General/NSMutableDictionary *chalkboard; float minCellWidth; float minCellHeight;

}

@end

@interface General/TVScrollView : General/NSScrollView { General/TVMatrix *tvMatrix; General/NSPoint mouseDownPoint; General/NSSize mouseDownCellSize; General/TVCell *tvCell; General/NSTimer *timer; }

@interface General/TVTableView : General/NSTableView { General/TVMatrix *tvMatrix; }

@interface General/TVCell : General/NSCell { General/NSRect scrollFrame; General/TVTableView *tableView; General/IBOutlet General/TVScrollView *scrollView; BOOL isTableConfigured; General/NSMutableArray *tableData; General/NSArray *nibObjects; General/TVMatrix *tvMatrix; }

*Open “General/TableViewMatrix.m” in an editor, delete everything and paste the following code

General/TableViewMatrix.m

#import “General/TableViewMatrix.h”

General/NSNib *General/TableViewResourceNib = nil; General/NSImageRep *General/ResizeIcon = nil;

@implementation General/MainScrollView

@end

@implementation General/TVMatrix

}

@end

@implementation General/TVScrollView

@implementation General/TVTableView

@implementation General/TVCell

@end

*Create a new Objective-C subclass named “General/TableViewMatrixController” (File -> New File -> Objective-C General/NSView subclass) *Open “General/TableViewMatrixController.h” in an editor, delete everything and paste the following code into this header

** General/TableViewMatrixController.h**

#import <Cocoa/Cocoa.h> @class General/TVMatrix;

@interface General/TableViewMatrixController : General/NSObject { General/TVMatrix *tvMatrix; General/IBOutlet id mainScrollView;

} @end

*Open “General/TableViewMatrixController.m” in an editor, delete everything and paste the following code

General/TableViewMatrixController.m

#import “General/TableViewMatrixController.h” #import “General/TableViewMatrix.h”

@implementation General/TableViewMatrixController

}

-(BOOL)tableView:(id)aTableView shouldSelectRow:(int)rowIndex { General/TVCell cell = (General/TVCell *)[aTableView delegate]; General/NSMutableArray *tableData = [cell tableData]; if (rowIndex < [tableData count]) { / do somthing here */ } return YES; }

}

@end

*Build the project *Now open the [[MainMenu.nib file (Double click on the General/MainMenu.nib icon located in the Resources group in the Group&Files outline view) *General/InterfaceBuilder should launch and open the nib file. The contents of the nib file are displayed in a window with a tab view that has tabs named Instances, Classes, Images, Sounds and Nib. This tab view will be refered to as the nib’s tab view. *Click on the nib’s tab view to make this nib active in General/InterfaceBuilder *Now read in the two header files you created in General/XCode (General/TableViewMatrix.h and General/TableViewMatrixController.h)

*To read in header files select the menu item (Classes -> Read Files…)

*After the files have been successfully parsed, click on the Classes tab in the General/MainMenu.nib tab view. *Scroll to the far left of the class browser and select General/NSObject *Scroll through General/NSObject’s subclasses until you see General/TableViewMatrixController *Select General/TableViewMatrixController (make sure General/TableViewMatrixController is highlighted blue) and instantiate this subclass (Classes -> Instantiate General/TableViewMatrixController). Notice that the Classes menu was dynamically updated to show that General/TableViewMatrixController is selected in the class browser. *If General/TableViewMatrixController was successfully instantiated, the General/MainMenu.nib tab view should have changed tabs so that a newly instantiated “General/TableViewMatrixController object” is now visible in the “Instances” tab. *In the “Instances” tab double click on the “Window” icon. This action should make the main window key. *Drag and drop a “Custom View” object onto the main window (The “Custom View” object is located in the Interface Builder palettes window under Cocoa-Containers) *Resize the custom view so that it fills the window. *Select the custom view by clicking on it. *Hit Command + “3” to configure the autoresizing mode of the custom view. *Command + “3” brings up the inspector window. This window has eight different modes for inspecting the active object. The first five are described below. Notice that the inspector window’s title tells you the class of the active object.

*Command + “1” allows you to configure attributes *Command + “2” allows you to configure connections *Command + “3” allows you to configure autoresizing settings *Command + “4” allows you to configure bindings *Command + “5” allows you to configure a custom class for the active object

*Select the inner springs (both vertical and horizontal) in the autoresizing view (the inner springs are the springs inside the box). *With the custom view still selected Hit Command + “5” to set the class for the custom view. *You should see a class named General/MainScrollView in the “Custom Class” list. Select General/MainScrollView as the custom class for the custom view. *Drag a connection from the “General/TableViewMatrixController object” (in the “Instance” tab of the General/MainMenu.nib tab view) to the “General/MainScrollView” custom view that you dropped onto the main window. See file:///Developer/Documentation/General/DeveloperTools/Conceptual/General/IBTips/Articles/General/MakingConnections.html for info on making connections. *Select the outlet named “mainScrollView” for this connection. *Save General/MainMenu.nib (File -> Save) *Close the General/MainMenu.nib window (the window with the General/MainMenu.nib tab view). *Create a new empty Cocoa nib file (File -> New -> Cocoa - Empty) *Make sure you save this file into the folder of the project under the name “General/TableViewMatrix” *Save this nib as “General/TableViewMatrix” (File -> Save). *While you are saving the nib you will be asked which targets in the project you would like the nib file to be associated with. General/TableViewMatrix should be checked, but if it isn’t check this target and add the nib to the project. *Select the Classes tab in the nib’s tab view. *Now read in “General/TableViewMatrix.h” (Classes -> Read Files…) *Select the Instances tab in the nib’s tab view. *Select the “File’s Owner” object in the nib’s tab view. *With the “File’s Owner” object selected, Hit Command + “5” and set the class for the nib file’s owner to “General/TVCell” *Now drag a “Custom View” onto the nib’s tab view. *You should now see an instance of a custom view in the “Instances” tab. *Double click on the “View” instance *Enlarge the view to a workable size and drop a table view from the Cocoa-Data pallet onto the view. *Enlarge the table view to a workable size and select the first table column *Hit Command + “1” to configure the selected table column. *Set the title of the first column to “ID”, set the identifier to “id” and set the sort key to “id”. *Select the second column of the table view. *Set the title of the first column to “Name”, set the identifier to “name” and set the sort key to “name”. *Now you need to configure the class of the table view and the scroll view. *First deselect everything in the “Custom View” (i.e. if the table view, one of the table headers or if the scroll view is selected). To deselect the “Custom View’s” contents simply click on the “Custom View” without touching the table view. Nothing should be highlighted or banded with resizing marks. *Click ONE TIME on the table view. This action should create a banding with resizing marks around the table view. The inspector window’s title should be “General/NSScrollView Info”. *Hit Command + “5” to set the custom class of the scroll view to General/TVScrollView *The inspector window’s title should now read “General/TVScrollView Info”. *Now double click on the table view. This action should highlight the content space of the table view. The inspector window’s title should read “General/NSTableView Info” *Hit Command + “5” to set the custom class of the table view to General/TVTableView *The inspector window’s title should now read “General/TVTableView Info”. *Drag a connection from the “File’s Owner” instance object to the table view’s scroll view

*This operation is kind of tricky because there are five views that can be connected (the main parent “Custom View”, the table view, two table columns and the scroll view that holds the table view). While you are dragging a connection line from the “File’s Owner” instance object toward the custom view, you will be able to dynamically see where the connection line is terminating by watching each view’s outline highlight as the mouse is dragged over each element. When the table view is terminating the connection, the table view’s inner content space will be highlighted. When table columns are terminating the connection, each individual column header will highlight. When the scroll view that contains the table view is terminating the connection, the entire table view’s outline (including the table column headers and the scrollers) will be highlighted. When the “Custom View” is terminating the connection the outline of the entire parent view (the “Custom View”) will be highlighted. You want to drag a connection line from the “File’s Owner” instance object to the scroll view that contains the table view. The easiest way to do this is to drag a connection line so that it terminates on one of the scrollers of the scroll view.

*Select “scrollView” as the outlet for this connection *resave the nib (File -> Save)

At this point you should be ready to launch this application. Go back to General/XCode and build and run General/TableViewMatrix (Build -> Build and Run).