Acollada ios Charting Components

Transcription

1 Acollada ios Charting Components

2 Acollada ios Charting Components... 1 LineChartView... 3 Description... 3 Screenshot... 3 Protocols to be implemented... 3 Customizing the LineChartView aspect... 4 How to provide data to LineChartView (Example)... 4 TimeChartView... 6 Description... 6 Screenshot... 6 Protocols to be implemented... 6 Customizing the TimeChartView aspect... 7 How to provide data to TimeChartView (Example)... 7 PieChartView... 9 Description... 9 Screenshot... 9 Protocols to be implemented... 9 How to provide data to PieChartView (Example) How to receive PieChartView events DataGridView Description Screenshot Protocols to be implemented Customize DataGridView aspect How to read data from DataGridView How to provide data to DataGridView (Example)... 12

3 LineChartView Description A LineChartView control allows you to sketch plot/bar charts just by implementing a simple data source protocol. The chart view control uses the MVC pattern and it needs a data source object. Screenshot Protocols to be LineChartDataSource <NSObject> -(LineChartType) linecharttype: (LineChartView *) view; -(NSString *) linecharttitle: (LineChartView *) view; -(int) linechartnumberofcharts: (LineChartView *) view; -(int) linechartnumberofpoints: (LineChartView *) view; -(float) linecharthorizontaldivisions: (LineChartView *) view; -(float) linechartverticaldivisions: (LineChartView *) view; -(float) linechart: (LineChartView *) view valueforxpointatindex: (int) index Chart: (int) chart; -(float) linechart: (LineChartView *) view valueforypointatindex: (int) index Chart: (int) chart; -(NSString *) linechart: (LineChartView *) view labelforxpointatindex: (int) index Chart: (int) chart; -(NSString *) linechart: (LineChartView *) view labelforypointatindex: (int) index Chart: (int)

4 Customizing the LineChartView aspect You can use the following public properties to set certain aspect options: //The font used to display (nonatomic, retain) NSString *fontname; //The font size for (nonatomic, assign) float fontsizetitle; //The font size for other (nonatomic, assign) float fontsizechart; //Text text (nonatomic, retain) UIColor *textcolor; //The chart should be (nonatomic, assign) bool chartbaselinezero; //Left chart (nonatomic, assign) float plotoffsethorizontalleft; //Right chart (nonatomic, assign) float plotoffsethorizontalright; //Top chart (nonatomic, assign) float plotoffsetverticaltop; //Bottom chart (nonatomic, assign) float plotoffsetverticalbottom; How to provide data to LineChartView (Example) #pragma mark - LineChartDataSource -(NSString *) linecharttitle: (LineChartView *) view { return view == chart" chart"; -(LineChartType) linecharttype:(linechartview *)view { return view == firstchart? LINECHART_PLOT : LINECHART_BAR; -(int) linechartnumberofcharts: (LineChartView *) view { return 4; -(int) linechartnumberofpoints: (LineChartView *) view { return 36; -(float) linecharthorizontaldivisions: (LineChartView *) view { return 36; -(float) linechartverticaldivisions: (LineChartView *) view { return 6;

5 -(float) linechart: (LineChartView *) view valueforxpointatindex: (int) index Chart: (int) chart { return index; -(float) linechart: (LineChartView *) view valueforypointatindex: (int) index Chart: (int) chart { return sin([utilities deg2rad: index * 10 + chart * 30]); -(NSString *) linechart: (LineChartView *) view labelforxpointatindex: (int) index Chart: (int) chart { return [NSString index]; -(NSString *) linechart: (LineChartView *) view labelforypointatindex: (int) index Chart: (int) chart { return [NSString [self linechart: nil valueforypointatindex:index Chart: chart]];

6 TimeChartView Description A TimeChartView control allows you to sketch plot charts along with milestone pins just by implementing a simple data source protocol. The timechartview control uses the MVC pattern and it needs a data source object. Screenshot Protocols to be mark TimeChartDataSource <NSObject> -(NSString *) timecharttitle: (TimeChartView *) view; -(float) timechartverticaldivisions: (TimeChartView *) view; -(int) timechartnumberofcharts: (TimeChartView *) view; -(int) timechartnumberofmilestones: (TimeChartView *) view; -(int) timechart: (TimeChartView *) view numberofpointsforchartatindex: (int) index; -(NSDate *) timechart: (TimeChartView *) view dateforpointatindex: (int) index Chart: (int) chart;

7 -(float) timechart: (TimeChartView *) view valueforpointatindex: (int) index Chart: (int) chart; -(TimeChartMilestone *) timechart: (TimeChartView *) view milestoneatindex: (int) Customizing the TimeChartView aspect You can use the following public properties to set certain aspect options: //The font used to display (nonatomic, retain) NSString *fontname; //The font size for (nonatomic, assign) float fontsizetitle; //The font size for other (nonatomic, assign) float fontsizechart; //Text text (nonatomic, retain) UIColor *textcolor; How to provide data to TimeChartView (Example) #pragma mark - TimeChartDelegate -(NSString *) timecharttitle: (TimeChartView *) view { is the title"; -(float) timechartverticaldivisions: (TimeChartView *) view { return 4; -(int) timechartnumberofcharts: (TimeChartView *) view { return 1; -(int) timechartnumberofmilestones: (TimeChartView *) view { return 5; -(int) timechart: (TimeChartView *) view numberofpointsforchartatindex: (int) index { return 20; -(NSDate *) timechart: (TimeChartView *) view dateforpointatindex: (int) index Chart: (int) chart { //Calculate date int now = [[NSDate date] timeintervalsince1970]; int week = 60 * 60 * 24 * 7; NSDate *date = [NSDate datewithtimeintervalsince1970: now + index * week]; NSLog(@"Point Index: %i Date: %@", index, date); return date;

8 -(float) timechart: (TimeChartView *) view valueforpointatindex: (int) index Chart: (int) chart { return index; -(TimeChartMilestone *) timechart: (TimeChartView *) view milestoneatindex: (int) index { //Calculate date int now = [[NSDate date] timeintervalsince1970]; int week = 60 * 60 * 24 * 7; NSDate *date = [NSDate datewithtimeintervalsince1970: now + index * 3 * week]; NSLog(@"Milestone Index: %i Date: %@", index, date); TimeChartMilestone *milestone = [[[TimeChartMilestone alloc] init] autorelease]; milestone.showdate = date; milestone.caption = [NSString index]; milestone.description = [NSString %i", index]; milestone.state = TIMECHART_MILESTONE_DELAYED; milestone.milestoneid = index; return milestone;

9 PieChartView Description A PieChartView control allows you to display pie data just by implementing a simple data source protocol. The piechartview control uses the MVC pattern and it needs a data source and (optional) a delegate object. Screenshot Protocols to be PieChartDataSource <NSObject> -(UILabel *) piechartlabelforselectedslice: (PieChartView *) view; -(int) piechartnumberofslices: (PieChartView *) view; -(float) piecharttotalvalue: (PieChartView *) view; -(float) piechart: (PieChartView *) view valueforsliceindex: (int) index; -(NSString *) piechart: (PieChartView *) view labelforsliceindex: PieChartDelegate <NSObject> -(void) piechart: (PieChartView *) view didselectslice: (PieChartWheelSlice *)

10 How to provide data to PieChartView (Example) #pragma mark - PieChartDataSource -(UILabel *) piechartlabelforselectedslice:(piechartview *)view { return nil; -(int) piechartnumberofslices:(piechartview *)view { return view == self.pie1? 3 : 6; -(float) piecharttotalvalue:(piechartview *)view { return 100; -(float) piechart:(piechartview *)view valueforsliceindex:(int)index { return [self piecharttotalvalue: view] / [self piechartnumberofslices: view]; -(NSString *) piechart:(piechartview *)view labelforsliceindex:(int)index { return [NSString [self piechart: view valueforsliceindex: index]]; How to receive PieChartView events #pragma mark - PieChartDelegate -(void) piechart: (PieChartView *) view didselectslice: (PieChartWheelSlice *) pcvs { if (view == self.pie1) self.label1.text = [NSString %i = %@", pcvs.index, pcvs.label]; else if (view == self.pie2) self.label2.text = [NSString %i = %@", pcvs.index, pcvs.label];

11 DataGridView Description A UITableView based control that allows you to display views (UILabels, UIImageViews, etc) in grid like form just by implementing a simple data source. The grid view control uses the MVC pattern and it needs a data source and (optional) a delegate object. Screenshot Protocols to be DataGridDataSource <NSObject> -(DataGridHeaderType) datagridheadertype: (DataGridView *) view; -(int) datagridnumberofrows: (DataGridView *) view; -(int) datagridnumberofcolumns: (DataGridView *) view; -(int) datagridrowheight: (DataGridView *) view; -(UIView *) datagrid: (DataGridView *) view cellforrow: (int) row column: (int) column; -(UIView *) datagrid: (DataGridView *) view cellforheadercolumn: DataGridDelegate <NSObject> -(void) datagrid: (DataGridView *) view didselectrow: (int) row; -(void) datagrid: (DataGridView *) view sortbycolumn: (int)

12 Customize DataGridView aspect You can use the following public properties to set certain aspect options: //Custom image for header (nonatomic, retain) UIImage *customheaderimage; //Custom color for row (nonatomic, retain) UIColor *oddrowcolor; //Custom color for row (nonatomic, retain) UIColor *evenrowcolor; How to read data from (nonatomic, readonly) int selectedindex; How to provide data to DataGridView (Example) #pragma mark DataGridDataSource -(DataGridHeaderType) datagridheadertype:(datagridview *)view { return DATAGRID_HEADER_TYPE_NORMAL; -(int) datagridnumberofcolumns:(datagridview *)view { return 6; -(int) datagridnumberofrows:(datagridview *)view { return 30; -(int) datagridrowheight:(datagridview *)view { return 30; -(UIView *) datagrid:(datagridview *)view cellforheadercolumn:(int)column { UILabel *newlabel = [[[UILabel alloc] init] autorelease]; newlabel.text = [NSString %i", column]; newlabel.font = [UIFont boldsystemfontofsize: 16]; newlabel.textcolor = [UIColor whitecolor]; return newlabel; -(UIView *) datagrid:(datagridview *)view cellforrow:(int)row column:(int)column { UILabel *newlabel = [[[UILabel alloc] init] autorelease]; newlabel.text = [NSString %i x %i", row, column]; newlabel.font = [UIFont systemfontofsize: 16];

13 newlabel.textcolor = [UIColor whitecolor]; return newlabel;