CRMultiRowSelect
============

CRMultiRowSelect is a custom **UITableViewCell** for iOS that supports multiple row selection in a UITableViewController.

Customize the color you want in just one line of code.

Everything is drawn with **CoreGraphics** NO IMAGES, so it supports Retina Display and looks beauty.

![Demo screenshot](https://github.com/chroman/CRMultiRowSelect/raw/master/demo.png)

**Customizable mark colors:**

![Marks screenshot](https://github.com/chroman/CRMultiRowSelect/raw/master/marks.png)

How To Use
----------

 - Add **CRTableViewCell.m** and **CRTableViewCell.h** files to your XCode Project
 - In your **UITableViewController.h** add your 'selected marks' **NSMutableArray**:

```objective-c
@interface YourTableViewController : UITableViewController
{
    NSArray *dataSource;
    NSMutableArray *selectedMarks; // You need probably to save the selected cells for use in the future.
}
```

- Customize your **cellForRowAtIndexPath** method implementation:

```objective-c
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    static NSString *CRTableViewCellIdentifier = @"cellIdentifier";
    
    // init the CRTableViewCell
    CRTableViewCell *cell = (CRTableViewCell *)[tableView dequeueReusableCellWithIdentifier:CRTableViewCellIdentifier];
    
    if (cell == nil) {
        cell = [[CRTableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:CRTableViewCellIdentifier];
    }
    
    // Check if the cell is currently selected (marked)
    NSString *text = [dataSource objectAtIndex:[indexPath row]];
    cell.isSelected = [selectedMarks containsObject:text] ? YES : NO;
    cell.textLabel.text = text;
    
    return cell;
}
```

 - Customize your **didSelectRowAtIndexPath** method implementation:

```objective-c
 - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
    NSString *text = [dataSource objectAtIndex:[indexPath row]];
    
    if ([selectedMarks containsObject:text])// Is selected?
        [selectedMarks removeObject:text];
    else
        [selectedMarks addObject:text];
    
    [tableView reloadRowsAtIndexPaths:[NSArray arrayWithObject:indexPath] withRowAnimation:UITableViewRowAnimationAutomatic];
}
```

 - You can customize the mark color using a HEX color, just change this line in the **CRTableViewCell.m** file

```objective-c
#define kMarkColor                  kBlueColor // or your HEX color, example: 0xfff000
```

 - Optionally you can get the selected cells using your previous declared **NSMutableArray** (example):

```objective-c
- (void)done:(id)sender
{
    NSLog(@"%@", selectedMarks);
}
```

- Also, you can refer to the Demo Example in the **CRTableViewController.m** file

Requirements
----------
* Xcode 4.3 or higher
* LLVM compiler
* iOS 4.3 or higher
* CoreGraphics Framework
* ARC

## License
Copyright 2012 Christian H. Roman Mendoza / Daniel Rueda Jimenez

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.


Contact me
----------

**Christian Roman**  
  
Website: [http://chroman.me][1]

Contact: [chroman16@gmail.com][2]

Twitter: [http://twitter.com/chroman][3] 

Thanks for the support: Daniel Rueda [Xtr3m0][4]

  [1]: http://chroman.me
  [2]: mailto:chroman16@gmail.com
  [3]: http://twitter.com/chroman
  [4]: http://git.drj.mx/