U3ParameterTableView Class Reference

#import <U3ParameterTableView.h>

Inheritance diagram for U3ParameterTableView:

Collaboration diagram for U3ParameterTableView:

Instance Methods
(id)	- initWithFrame:andComponents:inContainer:
(void)	- addParameter:
(void)	- updateParameter:
(NSInteger)	- isListedAlready:
(void)	- update:
(float)	- getViewHeightReqmt
(void)	- scrollInitially
(void)	- scrollForControlPanel
(void)	- scrollForInstructionPanel
(NSUInteger)	- parameterCount
(void)	- setViewForHead:
(void)	- setViewForTail:
(id)	- initWithFrame:andComponents:inContainer: [implementation]
(void)	- setViewForHead: [implementation]
(void)	- tableView:didSelectRowAtIndexPath: [implementation]
(NSInteger)	- numberOfSectionsInTableView: [implementation]
(NSInteger)	- tableView:numberOfRowsInSection: [implementation]
(UITableViewCell *)	- tableView:cellForRowAtIndexPath: [implementation]
(CGFloat)	- tableView:heightForHeaderInSection: [implementation]
(UIView *)	- tableView:viewForHeaderInSection: [implementation]
(CGFloat)	- tableView:heightForFooterInSection: [implementation]
(UIView *)	- tableView:viewForFooterInSection: [implementation]

Properties
NSMutableArray< NSDictionary * > *	givenParameters
id< U3ParameterTableDelegate >	givenContainer

Detailed Description

TODO: Wrap the 'cell' in a class.

The key thing is that UIScrollView (from which UITableView inherits) messes around with the responder chain so as to always return itself in the UIView method HitTest: WithEvent: It is this method that proved to be the key to getting the scroll view to play ball. (Note: it is important NOT to implement the touchesBegan, etc methods in this subclass or else you will override the default scrolling behaviour.)

Therefore, it is vital to subclass the UITableView and override the HitTest: WithEvent method so that it returns the current UITableViewCell (which can be obtained by locating the cellAtPoint: UITableView method) unless you determine that there is some vertical finger movement or it is scrolling (i.e. where tableView.decelerating == NO), in which case return self.

The table cell itself also needs to be subclassed and all the UIResponder methods touchesBegan: , touchesMoved and touchesEnded methods must be implemented. There you can pass a method to determine whether there is any vertical movement and, if so, set the next responder to be the table view. It is also here where you implement the code to work the swiping action (Apple's example code in the Events handling guide works well here).

Then, it's just a case of cleaning up a little by resetting the various parameters in the touchesEnded method. I have a tick button on the left of my cell, so I made sure that the hitTest method in UITableView subclass always returned self if the touch.x position was < 50, but you get the gist.

It is important to make sure that the delaysContentTouches property of the UITableView is set to YES or else you won't get any scrolling. It is also a good idea to turn off the swipe editing gesture because it will interfere with the custom swiping action.

Attribution: https://forums.macrumors.com/threads/problems-accessing-touch-events-in-a-uitableview-uiscrollview.640508/

Definition at line 15 of file U3ParameterTableView.h.

Method Documentation

addParameter:()

- (void) addParameter:

(NSDictionary *)

newComponentSpecDict

Definition at line 127 of file U3ParameterTableView.m.

                    : (NSDictionary *)newComponentSpecDict
{
    [[self givenParameters] addObject:newComponentSpecDict];
    
    [[self givenContainer] resizeParameterFrame];
    [[self givenContainer] updatedParameterArray:[self givenParameters]];
}

getViewHeightReqmt()

- (float) getViewHeightReqmt

Reimplemented in U3MenuChoicesTableView.

Definition at line 151 of file U3ParameterTableView.m.

{
    paramHeaderHeight = [tableHead heightRequirement];

    float ret = paramHeaderHeight;
    NSInteger parameterCount = [[self givenParameters] count];
    if (0 < parameterCount){
        ret += 2 + (parameterCount * 44);
    }
    NSInteger tailHeightReqmt = [tableTail heightRequirement];
    if (0 < tailHeightReqmt) {
        ret += 2 + [tableTail heightRequirement];
    }
    NSLog(@"U3ParameterTableView.getViewHeightReqmt: head: %3.2f  total: %3.2f", paramHeaderHeight, ret);
    return ret;
}

initWithFrame:andComponents:inContainer:() [1/2]

- (id) initWithFrame:		(CGRect)	frame
andComponents:		(NSArray *)	components
inContainer:		(id< U3ParameterTableDelegate >)	container

initWithFrame:andComponents:inContainer:() [2/2]

- (id) initWithFrame: (CGRect)  frame andComponents: (NSArray<NSDictionary *>*)  components inContainer: (id<U3ParameterTableDelegate>)  container

implementation

Definition at line 50 of file U3ParameterTableView.m.

                    :(CGRect)frame
       andComponents:(NSArray<NSDictionary *>*)components
         inContainer:(id<U3ParameterTableDelegate>) container
{
    NSLog(@"U3parameterTableView.init: #-components: %ld", (long)[components count]);

    self = [super initWithFrame:frame style:UITableViewStyleGrouped];
    [self setBackgroundColor:[[Z5DataController sharedInstance] wheatColor]];
    [self setDelegate:self];
    self.dataSource = self;
    
    mDateFormatter = [[NSDateFormatter alloc] init];
    [mDateFormatter setDateStyle:NSDateFormatterMediumStyle];
    [mDateFormatter setTimeStyle:NSDateFormatterShortStyle];
    
    [self setGivenParameters:[[NSMutableArray alloc] initWithArray:components]];
    [self setGivenContainer:container];
    
    [self setScrollEnabled:YES];
    paramHeaderHeight = 0.0f;
    paramFooterHeight = 0.0f;
    tableHead = nil;
    tableTail = nil;

    return self;
}

isListedAlready:()

- (NSInteger) isListedAlready:

(NSString *)

checkCaption

Definition at line 111 of file U3ParameterTableView.m.

                             : (NSString *)checkCaption
{
    NSInteger ret = -1;
    int parameterIndex = 0;
    for (NSDictionary *item in [self givenParameters]) {
        NSString *componentType = [item objectForKey:[Z5LocalDataController componentNameKey]];
        NSString *compoTypeClass = NSStringFromClass([componentType class]);
        if ([componentType isEqualToString:checkCaption]) {
            NSLog(@"Z6ParameterTableView.isListedAlready: yes, class: %@", compoTypeClass);
            ret = parameterIndex;
            break;
        }
        parameterIndex++;
    }
    return ret;
}

numberOfSectionsInTableView:()

- (NSInteger) numberOfSectionsInTableView: (UITableView *)  tableView

implementation

Reimplemented in U3MenuChoicesTableView.

Definition at line 221 of file U3ParameterTableView.m.

                                        :(UITableView *)tableView
{
    NSLog(@"U3ParameterTableView.numberOfSectionsInTableView: 1");
    // this is called at "Originate Item"?!!
    return 1;           // default is 1
}

parameterCount()

- (NSUInteger) parameterCount

Definition at line 207 of file U3ParameterTableView.m.

{
    return [[self givenParameters] count];
}

scrollForControlPanel()

- (void) scrollForControlPanel

Definition at line 174 of file U3ParameterTableView.m.

{
    NSInteger nParams = [[self givenParameters] count];
    if ( 0 < nParams) {
        NSIndexPath *lastIndex = [NSIndexPath indexPathForRow:nParams-1 inSection:0];
        [self scrollToRowAtIndexPath:lastIndex  atScrollPosition:UITableViewScrollPositionBottom animated:YES];
    }
}

scrollForInstructionPanel()

- (void) scrollForInstructionPanel

Definition at line 182 of file U3ParameterTableView.m.

{
    NSLog(@"ParameterTablView.scrollForInstructionPanel: entry");
    NSInteger nSections = [self numberOfSections];
    NSLog(@"   .. nSections: %ld", (long)nSections);
    for (int j=0;j<nSections;j++) {
        NSLog(@"    ... nRows, section %d: %ld", j, (long)[self numberOfRowsInSection:j]);
    }
    NSInteger endSection = nSections - 1;
    NSInteger nRows = [self numberOfRowsInSection:endSection];

    if (0 < nRows) {
        NSInteger lastRowEndSection = nRows - 1;
        NSLog(@"   .. last index: S:%ld R:%ld", (long)endSection, (long)lastRowEndSection);
        NSAssert(!(lastRowEndSection<0), @"empty last section");
        NSIndexPath *lastIndex = [NSIndexPath indexPathForRow:lastRowEndSection inSection:endSection];
        [self scrollToRowAtIndexPath:lastIndex  atScrollPosition:UITableViewScrollPositionBottom animated:YES];
    }
    NSLog(@"ParameterTablView.scrollForInstructionPanel: exit");
//    NSInteger nParams = [[self givenParameters] count];
//    if ( 0 < nParams) {
//        NSIndexPath *lastIndex = [NSIndexPath indexPathForRow:nParams-1 inSection:0];
//        [self scrollToRowAtIndexPath:lastIndex  atScrollPosition:UITableViewScrollPositionBottom animated:YES];
//    }
}

scrollInitially()

- (void) scrollInitially

Definition at line 167 of file U3ParameterTableView.m.

{
    if ( 0 < [[self givenParameters] count]) {
        NSIndexPath *firstIndex = [NSIndexPath indexPathForRow:0 inSection:0];
        [self scrollToRowAtIndexPath:firstIndex  atScrollPosition:UITableViewScrollPositionTop animated:YES];
    }
}

setViewForHead:() [1/2]

- (void) setViewForHead:

(UIView *)

headView

setViewForHead:() [2/2]

- (void) setViewForHead: (id <Z6ContainedView>)  headView

implementation

Definition at line 77 of file U3ParameterTableView.m.

                       : (id <Z6ContainedView>)headView
{
    tableHead = headView;
    paramHeaderHeight = [headView heightRequirement];
    NSLog(@"U3ParameterTableView.setViewForHead: paramHeaderHeight: %3.2f",paramHeaderHeight);
}

setViewForTail:()

- (void) setViewForTail:

(UIView<Z6ContainedView> *)

tailView

Definition at line 83 of file U3ParameterTableView.m.

                       : (UIView<Z6ContainedView> *) tailView
{
    tableTail = tailView;
    paramFooterHeight = [tailView heightRequirement];
    NSLog(@"U3ParameterTableView.setViewForTail: paramFooterHeight: %3.2f", paramFooterHeight);
}

tableView:cellForRowAtIndexPath:()

- (UITableViewCell *) tableView: (UITableView *)  tableView cellForRowAtIndexPath: (NSIndexPath *)  indexPath

implementation

Reimplemented in U3MenuChoicesTableView.

Definition at line 235 of file U3ParameterTableView.m.

                              :(UITableView *)tableView
         cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"usda-parameters-menu"];
    // NSLog(@"U3parameterTableView.tableCellForRow: %ld  cell: %@", (long)[indexPath row], cell);
    if (cell == nil) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleValue1 reuseIdentifier:@"usda-parameters-menu"];
        
        cell.contentView.autoresizingMask = UIViewAutoresizingFlexibleHeight|UIViewAutoresizingFlexibleWidth;
        [cell.layer setCornerRadius:7.0f];
        [cell.layer setMasksToBounds:YES];
        [cell.layer setBorderWidth:1.0f];
    }
    
    NSInteger nComponents = [[self givenParameters] count];
    
    if (nComponents > [indexPath row]) {
        
        NSObject *parameterObj = [[self givenParameters] objectAtIndex:[indexPath row]];
        if ([NSStringFromClass([parameterObj class]) containsString:@"Dictionary"]) {
            NSDictionary *focusNutritionComp = (NSDictionary *)parameterObj;
            // NSLog(@"U3parameterTableView.table-cellForRow: %ld focusNutritionComp: %@", (long)[indexPath row], focusNutritionComp);
            NSString *caption = [focusNutritionComp objectForKey:[Z5LocalDataController componentNameKey]];
            NSMutableString *captionWithSpace = [[NSMutableString alloc] initWithString:caption];
            if ([caption hasPrefix:@"Fat"]) {
                [captionWithSpace insertString:@" " atIndex:3];
            } else if ([caption hasPrefix:@"Vitamin"]) {
                [captionWithSpace insertString:@" " atIndex:7];
            }
            
            NSString *valueCaption = [focusNutritionComp objectForKey:[Z5LocalDataController componentValueKey]];
            NSString *compoTypeClass = NSStringFromClass([valueCaption class]);
            
            NSString *detailCaption;
            if ([compoTypeClass isEqualToString:@"HKQuantity"]) {
                // NSLog(@"U3parameterTableView.didSelectPickerRow: compo-class: %@", compoTypeClass);
                HKQuantity* hkq = (HKQuantity *)valueCaption;
                // NSLog(@"U3parameterTableView.tableCellForRow: desc: %@", hkq.description);
                // cell.detailTextLabel.text = hkq.description;
                detailCaption = hkq.description;
            } else {
                // cell.detailTextLabel.text = valueCaption;
                detailCaption = valueCaption;
            }
            // NSLog(@"U3parameterTableView.table-cellForRow: caption/valueCaption: %@/%@", caption, valueCaption);
            [Z5DataController labelizeCell:cell withText:captionWithSpace inColor:[UIColor redColor] andDetail:detailCaption];
            
            NSNumber *authoStat = [focusNutritionComp objectForKey:[Z5LocalDataController componentAuthorityKey]];
            // NSLog(@"U3parameterTableView: authoStat: %@", authoStat);
            UIColor *authorityColor = [Z5LocalDataController colorForAuthority:authoStat];
            [cell setBackgroundColor:authorityColor];
        } else if ([@"Meal" isEqualToString:NSStringFromClass([parameterObj class]) ]) {
            Meal *focusNutritionMeal = (Meal *)parameterObj;
            NSDate *mealDate = [focusNutritionMeal orderDate];
            NSString *mealDateStr = [mDateFormatter stringFromDate:mealDate];
            // NSString *caption = @"jklegr";
            NSString *detailCaption = @"none";
            [Z5DataController labelizeCell:cell withText:mealDateStr inColor:[UIColor orangeColor] andDetail:detailCaption];
        } else {
            NSLog(@"U3ParameterTableView.cellForRow: parameter-obj class: %@", NSStringFromClass([parameterObj class]));
        }
    } else if (0 == nComponents) {
        cell.textLabel.text = @"no parameter";
    }
    
    // NSLog(@"U3parameterTableView.tableCellForRow: %ld  return cell: %@", (long)[indexPath row], cell);
    return cell;
}

tableView:didSelectRowAtIndexPath:()

- (void) tableView: (UITableView *)  tableView didSelectRowAtIndexPath: (NSIndexPath *)  indexPath

implementation

Reimplemented in U3MenuChoicesTableView.

Definition at line 213 of file U3ParameterTableView.m.

                 :(UITableView *)tableView
didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
    NSLog(@"U3ParameterTableView.didSelectRowAtIndexPath: %ld", (long)indexPath.row);
    
    [[self givenContainer] didSelectParameterRow:indexPath];
}

tableView:heightForFooterInSection:()

- (CGFloat) tableView: (UITableView *)  tableView heightForFooterInSection: (NSInteger)  section

implementation

Reimplemented in U3MenuChoicesTableView.

Definition at line 318 of file U3ParameterTableView.m.

                    :(UITableView *)tableView heightForFooterInSection:(NSInteger)section {
    
    // height of the footer
    // this needs to be set, otherwise the height is zero and no footer will show
    // NSLog(@"U3ParameterTableView.heightForFooterInSection: %3.2f", paramFooterHeight);
    // return [tableTail heightRequirement];
    return paramFooterHeight;
}

tableView:heightForHeaderInSection:()

- (CGFloat) tableView: (UITableView *)  tableView heightForHeaderInSection: (NSInteger)  section

implementation

Reimplemented in U3MenuChoicesTableView.

Definition at line 304 of file U3ParameterTableView.m.

                    :(UITableView *)tableView heightForHeaderInSection:(NSInteger)section {
    
    // height of the section header
    // this needs to be set, otherwise the height is zero and no footer will show
    // NSLog(@"U3ParameterTableView.heightForHeaderInSection: %3.2f", paramHeaderHeight);
    return paramHeaderHeight;
}

tableView:numberOfRowsInSection:()

- (NSInteger) tableView: (UITableView *)  tableView numberOfRowsInSection: (NSInteger)  section

implementation

Reimplemented in U3MenuChoicesTableView.

Definition at line 227 of file U3ParameterTableView.m.

                      :(UITableView *)tableView
 numberOfRowsInSection:(NSInteger)section
{
    askedOnce = NO; // initialize somehow
    NSInteger ret = [[self givenParameters] count];
    NSLog(@"U3ParameterTableView.numberOfRowsInSection: # of rows in table: %ld", (long)ret);
    return ret;
}

tableView:viewForFooterInSection:()

- (UIView *) tableView: (UITableView *)  tableView viewForFooterInSection: (NSInteger)  section

implementation

Reimplemented in U3MenuChoicesTableView.

Definition at line 327 of file U3ParameterTableView.m.

                     :(UITableView *)tableView viewForFooterInSection:(NSInteger)section
{
    return (UIView *)tableTail;
}

tableView:viewForHeaderInSection:()

- (UIView *) tableView: (UITableView *)  tableView viewForHeaderInSection: (NSInteger)  section

implementation

Reimplemented in U3MenuChoicesTableView.

Definition at line 312 of file U3ParameterTableView.m.

                     :(UITableView *)tableView viewForHeaderInSection:(NSInteger)section {
    
    // NSLog(@"U3ParameterTableView.viewForHeaderInSecion: %ld", section);
    return (UIView *)tableHead;
}

update:()

- (void) update:

(NSArray<NSDictionary *> *)

components

Definition at line 94 of file U3ParameterTableView.m.

               :(NSArray<NSDictionary *> *)components
{
    NSLog(@"U3ParameterTableView.update: components: %@", components);
    
    [[self givenParameters] removeAllObjects];
    if (components) {
        for (NSDictionary *givenPrmDict in components) {
            NSLog(@"U3ParameterTableView.update: given-parameter-dictionary: %@", givenPrmDict);
        }
        [[self givenParameters] addObjectsFromArray:components];
    }
    [self reloadData];

    NSMutableArray<NSDictionary *> *givParam = [self givenParameters];
    [[self givenContainer] updatedParameterArray:givParam];
    [[self givenContainer] resizeParameterFrame];
}

updateParameter:()

- (void) updateParameter:

(NSDictionary *)

newComponentSpecDict

Definition at line 134 of file U3ParameterTableView.m.

                       : (NSDictionary *)newComponentSpecDict
{
    NSString *updateParamName = [newComponentSpecDict objectForKey:[Z5LocalDataController componentNameKey]];
    for (NSUInteger index = 0; index < [[self givenParameters] count]; index++) {
        NSDictionary *paramListed = [[self givenParameters] objectAtIndex:index];
        NSString *listedParamName = [paramListed objectForKey:[Z5LocalDataController componentNameKey]];
        if ([updateParamName isEqualToString:listedParamName]) {
            [[self givenParameters] replaceObjectAtIndex:index withObject:newComponentSpecDict];
            break;
        }
    }
    
    [[self givenContainer] resizeParameterFrame];
    NSMutableArray<NSDictionary *> *givParam = [self givenParameters];
    [[self givenContainer] updatedParameterArray:givParam];
}

Property Documentation

givenContainer

- (id<U3ParameterTableDelegate>) givenContainer

readwritenonatomicstrong

Definition at line 17 of file U3ParameterTableView.h.

givenParameters

- (NSMutableArray<NSDictionary *>*) givenParameters

readwritenonatomicstrong

Definition at line 16 of file U3ParameterTableView.h.

---

The documentation for this class was generated from the following files:

• TodaysMenu/tableViews/U3ParameterTableView.h
• TodaysMenu/tableViews/U3ParameterTableView.m