{"id":349,"date":"2023-09-30T07:33:13","date_gmt":"2023-09-30T07:33:13","guid":{"rendered":"https:\/\/fredpayet.fr\/?page_id=349"},"modified":"2023-09-30T07:33:13","modified_gmt":"2023-09-30T07:33:13","slug":"nstableview","status":"publish","type":"page","link":"https:\/\/fredpayet.fr\/index.php\/nstableview\/","title":{"rendered":"NSTableView"},"content":{"rendered":"\n

Basic methods<\/h2>\n
\r\n@interface PatientList : NSViewController {\r\n   NSMutableArray *patientArray;     \/\/ this array will genuinely contain the data to display\r\n   IBOutlet NSTableView *tableView;  \/\/ this array is a link for IB\r\n}\r\n<\/pre>\n
The 2 following methods must be implemented :<\/p>\n
\r\n- (int)numberOfRowsInTableView:(NSTableView *)aTableView\r\n{\r\n   return [patientArray count];\r\n}\r\n<\/pre>\n
\r\n- (id)tableView:(NSTableView *)aTableView objectValueForTableColumn:(NSTableColumn *)aTableColumn\r\n            row:(int)rowIndex\r\n{\r\n   NSString *identifier = [aTableColumn identifier];  \/\/ get the column identifier\r\n   Patient *unPatient = [patientArray objectAtIndex:rowIndex];\r\n   return [unPatient valueForKey:identifier];\r\n}\r\n<\/pre>\n
Optionally, a sort method can be implemented. Under the IB inspector, Table column Attribute <\/em><\/strong>needs “sortKey” and “Selector” to be set. sortKey is usually equal to the col identifier. Selector can be compare:<\/strong> or localizedStandardCompare:<\/strong>. For integer values in an NSTableView, use localizedStandardCompare:<\/strong>. For NSString, use compare:<\/strong>.<\/p>\n
\r\n- (void)tableView:(NSTableView *)aTableView sortDescriptorsDidChange:(NSArray *)oldDescriptors\r\n{\r\n   NSArray *newDescriptors = [aTableView sortDescriptors];\r\n   [patientArray sortUsingDescriptors:newDescriptors];\r\n   [tableView reloadData];\r\n}\r\n<\/pre>\n
IB connections<\/h2>\n
    \n
  1. File’s Owner Class Id must be set to PatientList<\/li>\n
  2. connect ‘File’s Owner’ tableView outlet to the NSTableView graphic<\/li>\n
  3. connect _NSTableView_ graphic -> datasource to ‘File’s Owner’<\/li>\n<\/ol>\n
    Note : if you do not see datasource in the inspector, it’s certainly because you have selected the NSScrollView<\/strong> instead. The NSTableView<\/strong> is inside the NSScrollView<\/strong>. The column identifier<\/strong> is used to be able to give the right value from patientArray. This must match the field name of Patient Class. From IB, select an entire column and set identifiers in a simple way, something as follows :<\/p>\n
    \n\r\n\r\n
    Title and Identifier relationship<\/caption>\n
    Title<\/th>\nIdentifier<\/th>\n<\/tr>\n<\/thead>\n
    Name<\/td>\nname<\/td>\n<\/tr>\n\r\n
    FirstName<\/td>\nfirstname<\/td>\n<\/tr>\n\r\n
    Nb Consults<\/td>\nnbConsults<\/td>\n<\/tr>\n<\/tbody><\/table><\/div>\n
    Capture row selection change<\/h2>\n
    This needs a delegate link from NSTableView IB to “File’s Owner”<\/p>\n
    \r\n- (void)tableViewSelectionDidChange:(NSNotification *)notification\r\n{\r\n   int row = [tableView selectedRow];\r\n   if (row == -1) return;\r\n   Patient* aPatient = [patientArray objectAtIndex:row];\r\n   NSInteger idp = aPatient.idPatient;\r\n   DLog(@&quot;%d&quot;,idp);\r\n}\r\n<\/pre>\n
    Reselect the same row after [tableView reloadata]<\/h2>\n
    \r\nNSInteger row = [self.tableView selectedRow];\r\n[self.tableView reloadData];\r\n[self.tableView selectRowIndexes:[NSIndexSet indexSetWithIndex:row] byExtendingSelection:NO];\r\n<\/pre>\n
    Deselect all rows<\/h2>\n
    \r\n[patientTableView deselectAll:self];\r\n<\/pre>\n
    Retrieve information from multiple selected rows<\/h2>\n
    We need to use the following method :<\/p>\n
    \r\n- (NSIndexSet *)selectedRowIndexes \/\/ Returns an index set containing the indexes of the selected rows.\r\n<\/pre>\n
    Let’s say multiple lines have been selected from an NSTableView<\/strong> : patientTableView. A button has been pushed and the action is addMember<\/strong>:<\/p>\n
    \r\n- (IBAction)addMember:(id)sender\r\n{\r\n   NSIndexSet *allrows = [patientTableView selectedRowIndexes];\r\n   if ([allrows count] == 0) { return; }\r\n\r\n   \/\/ Parse the different rows as follows\r\n   NSUInteger row = [allrows firstIndex];\r\n   while (row != NSNotFound)\r\n   {\r\n      \/\/ use the currentIndex\r\n      aPatient = [patientArray objectAtIndex:row];\r\n\r\n      \/\/ Do whatever you want with the aPatient instance, here we update a database\r\n      [self mysqlAddPatientToGroup:aPatient gid:10];\r\n\r\n      \/\/ step to the next row\r\n      row = [allrows indexGreaterThanIndex:row];\r\n   }\r\n}\r\n<\/pre>\n
    Multiple NSTableView in an NSView<\/h2>\n
    We only have some general delegate methods to deal with the different\u00a0NSTableView(s).
    \nSo we need to add some extra code to check with which NStableView instance the delegate method is dealing with.
    \nFor details, see http:\/\/stackoverflow.com\/questions\/12250028\/cocoa-multiple-view-based-nstableviews<\/a><\/p>\n
    \r\n@interface Comptes : NSViewController {\r\n   NSMutableArray *consultArray;\r\n   NSMutableArray *chargeArray;\r\n   IBOutlet NSTableView *consultTableView;\r\n   IBOutlet NSTableView *chargeTableView;\r\n}\r\n<\/pre>\n
    \r\n\/\/ **************************************************************\r\n\/\/ NSTableView functions\r\n\/\/\r\n\/\/ ==============================================================\r\n- (int)numberOfRowsInTableView:(NSTableView *)aTableView\r\n{\r\n   if (aTableView == consultTableView ) {\r\n      return [consultArray count];\r\n   }\r\n   if (aTableView == chargeTableView ) {\r\n      return [chargeArray count];\r\n   }\r\n   return 0;\r\n}\r\n\r\n\/\/ We use the column identifier to be able to give the right value from patientArray.\r\n- (id)tableView:(NSTableView *)aTableView objectValueForTableColumn:(NSTableColumn *)aTableColumn\r\n            row:(int)rowIndex\r\n{\r\n   ConsultExtent *aConsult;\r\n   Charge *aCharge;\r\n\r\n   NSString *identifier = [aTableColumn identifier];  \/\/ get the column identifier \r\n\r\n   if (aTableView == consultTableView ) {\r\n      aConsult = [consultArray objectAtIndex:rowIndex];\r\n      return [aConsult valueForKey:identifier];\r\n   }\r\n   if (aTableView == chargeTableView) {\r\n      aCharge = [chargeArray objectAtIndex:rowIndex];\r\n      return [aCharge valueForKey:identifier];\r\n   }\r\n\r\n   \/\/ some extra checks\r\n   assert(aTableView == consultTableView || aTableView == chargeTableView );\r\n   return 0;\r\n}\r\n\r\n\/\/ column sort\r\n- (void)tableView:(NSTableView *)aTableView sortDescriptorsDidChange:(NSArray *)oldDescriptors\r\n{\r\n   NSArray *newDescriptors = [aTableView sortDescriptors];\r\n\r\n   if (aTableView == consultTableView ) {\r\n      [consultArray sortUsingDescriptors:newDescriptors];\r\n      [consultTableView reloadData];\r\n      return;\r\n   }\r\n   if (aTableView == chargeTableView ) {\r\n      [chargeArray sortUsingDescriptors:newDescriptors];\r\n      [chargeTableView reloadData];\r\n      return;\r\n   }\r\n   assert(aTableView == consultTableView || aTableView == chargeTableView );\r\n}\r\n\r\n- (void)tableViewSelectionDidChange:(NSNotification *)notification\r\n{\r\n   NSTableView *aTableView = [notification object];\r\n\r\n   if (aTableView == consultTableView ) {\r\n      NSInteger row = [consultTableView selectedRow];\r\n      if (row == -1) { return; }\r\n      return;\r\n   }\r\n   if (aTableView == chargeTableView ) {\r\n      NSInteger row = [chargeTableView selectedRow];\r\n      if (row == -1) { return; }\r\n         return;\r\n   }\r\n   assert(aTableView == consultTableView || aTableView == chargeTableView );\r\n}\r\n<\/pre>\n
    Cells edition<\/h2>\n
    From the Interface Builder window<\/p>\n
      \n
    • select the NSTableView Oject<\/li>\n
    • Right click -> Delegate -> File’s Owner<\/li>\n
    • Add this method in the code :<\/li>\n<\/ul>\n
      \r\n- (void)tableView:(NSTableView *)aTableView setObjectValue:(id)anObject\r\n   forTableColumn:(NSTableColumn *)aTableColumn\r\n              row:(NSInteger)rowIndex\r\n{\r\n   ConsultExtent *uneConsult;\r\n\r\n   \/\/ Check the NSTableView instance in which the cell edition has been triggered\r\n   if (aTableView == consultTableView ) {\r\n      \/\/ Check the column identifier\r\n      if ([[aTableColumn identifier] isEqualToString:@"invoice"]) {\r\n         \/\/ Assign the typed value to the consult instance\r\n         aConsult = [consultArray objectAtIndex:rowIndex];\r\n         aConsult.paiementEncaisse = [NSString stringWithFormat:@"%@",anObject];\r\n         \/\/ modify the NSMutableArray\r\n         [consultArray replaceObjectAtIndex:rowIndex withObject:aConsult];\r\n         [consultTableView reloadData];\r\n      }\r\n   }\r\n   \/\/ some assertions, to make sure we are not making bad things\r\n   assert(aTableView == consultTableView || aTableView == chargeTableView );\r\n}\r\n<\/pre>\n
      Deal with NSTableView cell edition aborted by another event<\/h2>\n
      This is really something to be dealt precociously. If an NSButton<\/strong> is pressed while an NSTableView<\/strong> cell is being edited, this will make empty cells displayed and\/or some rows not in sync with what should be displayed. I did spend some time trying to figure this out. The most elegant solution is to make sure the NSTextFieldCell<\/strong> is not the firstResponder<\/em> anymore. Actually, we force the end of the cell edition so that we get something clean. In each IBAction<\/strong> method, we have to call the makeFirstResponder:<\/strong> method by giving any Graphical object outside the selected NSTableView<\/strong>. Let’s say we have an NSDatePicker<\/strong> object.<\/p>\n
      \r\n   program.h\r\n   IBOutlet NSDatePicker        *startDate;\r\n<\/pre>\n
      The following action method for an NSButton pressure will look like :<\/p>\n
      \r\n- (IBAction)currYear:(id)sender\r\n{\r\n   \/\/ Forces the end of the cell edition so that we get something clean.\r\n   [[startDate window] makeFirstResponder:startDate];\r\n}\r\n<\/pre>\n
      How to edit an NSTableView cell with a single-click<\/h2>\n
      As I have posted onto stackoverflow, I think the most elegant option is to subclass NSTableView as follows :<\/p>\n
      \r\n#import <Cocoa\/Cocoa.h>\r\n@interface myNSTableView : NSTableView {\r\n}\r\n- (void)singleClickEdit: (id)sender;\r\n@end\r\n<\/pre>\n
      \r\n#import "myNSTableView.h"\r\n@implementation myNSTableView\r\n- (void)awakeFromNib\r\n{\r\n   [self setAction:@selector(singleClickEdit:)];\r\n}\r\n\r\n- (void)singleClickEdit: (id)sender\r\n{\r\n   NSLog(@"singleClickEdit:");\r\n   [self editColumn:[self clickedColumn] row:[self clickedRow] withEvent:nil select:NO];\r\n}\r\n\r\n@end\r\n<\/pre>\n
      Instead of NSTableView, use the myNSTableview class, ie :<\/p>\n
      \r\n#import <Cocoa\/Cocoa.h>\r\n#import "myNSTableView.h"\r\n\r\n@interface Preference : NSPanel {\r\n   NSMutableArray             *chargeArray;\r\n   IBOutlet    myNSTableView  *chargeTableView;\r\n}\r\n<\/pre>\n
      From IB, select the NSTableView<\/strong> graphical object which has been put in the NSView<\/strong>. Select the “Indentity Inspector” Tab, and select myNSTableView<\/strong> instead of NSTableView<\/strong>.
      \nYou are done.<\/p>\n
      Change the background color of a selected row<\/h2>\n
      We just have to subclass NSTableRowView<\/strong>. It has methods for drawing the background for selected and deselected rows. To get the NSTableView instance to use your subclass, just implement the tableview delegate method : tableView:rowViewForRow:<\/strong>, and return an instance of the NSTableRowView<\/strong> subclass.<\/p>\n
      \r\n   #import <Cocoa\/Cocoa.h>\r\n   @interface MyNSTableRowView : NSTableRowView\r\n   @end\r\n<\/pre>\n
       <\/p>\n
      \r\n   #import "MyNSTableRowView.h"\r\n\r\n   @implementation MyNSTableRowView\r\n   - (id)init\r\n   {\r\n      if (!(self = [super init])) return nil;\r\n      return self;\r\n   }\r\n\r\n   - (void)drawSelectionInRect:(NSRect)dirtyRect {\r\n     if (self.selectionHighlightStyle != NSTableViewSelectionHighlightStyleNone) {\r\n        NSRect selectionRect = NSInsetRect(self.bounds, 2.5, 2.5);\r\n        [[NSColor colorWithCalibratedWhite:.65 alpha:1.0] setStroke];\r\n        [[NSColor colorWithCalibratedWhite:.82 alpha:1.0] setFill];\r\n        NSBezierPath *selectionPath = [NSBezierPath bezierPathWithRoundedRect:selectionRect\r\n                                                                      xRadius:6 yRadius:6];\r\n        [selectionPath fill];\r\n        [selectionPath stroke];\r\n     }\r\n   }\r\n   @end\r\n<\/pre>\n
      From the main delegate class, add this :<\/p>\n
      \r\n   - (NSTableRowView *)tableView:(NSTableView *)tableView rowViewForRow:(NSInteger)row\r\n   {\r\n      DLog(@"row =%ld",row);\r\n      MyNSTableRowView *rowView = [[MyNSTableRowView alloc]init];\r\n      return rowView;\r\n   }\r\n<\/pre>\n","protected":false},"excerpt":{"rendered":"
      Basic methods @interface PatientList : NSViewController { NSMutableArray *patientArray; \/\/ this array will genuinely contain the data to display IBOutlet NSTableView *tableView; \/\/ this array is a link for IB …<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"template-fullwidth.php","meta":{"_themeisle_gutenberg_block_has_review":false,"footnotes":""},"_links":{"self":[{"href":"https:\/\/fredpayet.fr\/index.php\/wp-json\/wp\/v2\/pages\/349"}],"collection":[{"href":"https:\/\/fredpayet.fr\/index.php\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/fredpayet.fr\/index.php\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/fredpayet.fr\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fredpayet.fr\/index.php\/wp-json\/wp\/v2\/comments?post=349"}],"version-history":[{"count":1,"href":"https:\/\/fredpayet.fr\/index.php\/wp-json\/wp\/v2\/pages\/349\/revisions"}],"predecessor-version":[{"id":350,"href":"https:\/\/fredpayet.fr\/index.php\/wp-json\/wp\/v2\/pages\/349\/revisions\/350"}],"wp:attachment":[{"href":"https:\/\/fredpayet.fr\/index.php\/wp-json\/wp\/v2\/media?parent=349"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}