Xamarin Edition Xamarin Edition 1
Total Page:16
File Type:pdf, Size:1020Kb
ComponentOne Xamarin Edition Xamarin Edition 1 Table of Contents Getting Started with Xamarin Edition 6 Breaking Changes for Xuni Users 6-7 NuGet Packages 7-8 Redistributable Files 8-9 Licensing 9 License App using GrapeCity ComponentOneMenu Extension 9-19 Licensing App using Website 19-20 Finding the Application Name 20-22 C1 Xamarin.Forms Project Templates 22-23 Creating a New Xamarin.Forms App 23-26 Adding NuGet Packages to your App 26-28 Adding Xamarin Components using C# 28-30 Adding Xamarin Components using XAML 30-31 About this Documentation 31 Technical Support 31-32 Controls 33 Calendar 33 Quick Start: Display a Calendar Control 33-35 Interaction Guide 35-37 Features 37 Customizing Appearance 37-39 Customizing Header 39-42 Customizing Day Content 42-46 Orientation 46-47 Selection 47-48 Customizing Selection 48-49 CollectionView 49 Quick Start: Add data to FlexGrid using CollectionView 49-54 Features 55 Grouping 55-56 Incremental Loading 56-60 Sorting 60-61 FlexChart 61-62 Quick Start: Add Data to FlexChart 62-66 Copyright © 2019 GrapeCity, Inc. All rights reserved. Xamarin Edition 2 Chart Elements 66-67 Chart Types 67-72 Features 72 Animation 72-73 Annotations 73-78 Axes 78-80 Customize Appearance 80-82 Data Binding 82-84 Data Labels 84-87 Manage Overlapped Data Labels 87-91 Header and Footer 91-92 Hit Test 92-95 Legend 95-96 Line Marker 96-100 Mixed Charts 100-101 Multiple Y Axes 101-103 Selection 104-105 Themes 105-107 Tooltip 107-111 Zooming and Panning 111-113 Zones 113-117 FlexGrid 117-118 Quick Start: Add Data to FlexGrid 118-122 Key Features 122-123 Features 123 Reordering Rows and Columns 123-124 Custom Cells 124-128 Custom Cell Editor 128 Custom Icon 128-130 Customize Appearance 130-131 Clipboard and Keyboard Support 131-132 Data Mapping 132-134 Defining Columns 134-135 Editing 135 Inline Editing 135-136 Add New Row 136-137 Copyright © 2019 GrapeCity, Inc. All rights reserved. Xamarin Edition 3 Export 137-138 Filtering 138 Search Box Filtering 138-140 Formatting Columns 140-142 Frozen Rows and Columns 142-143 Grouping 143-145 Material Theme 145-147 Merging Cells 147-148 Pull To Refresh 148-150 Resizing Columns/Rows 150-151 Row Details 151-160 Sorting 160-163 Selecting Cells 163-164 Star and Auto Sizing 164-165 Wordwrap 165-166 FlexPie 166-167 Quick Start: Add data to FlexPie 167-170 Features 170 Animation 170-171 Customize Appearance 171-172 Data Binding 172-173 Data Labels 173-176 Manage Overlapped Data Labels 176-177 Donut Pie Chart 177 Exploded Pie Chart 177-178 Header and Footer 178-179 Legend 179-181 Themes 181-182 Zooming and Panning 182-184 FlexViewer 184-185 FlexViewer Toolbar 185 Quick Start 185-188 Features 188 Navigation 188-189 Text Search 189-190 Appearance 190-191 Copyright © 2019 GrapeCity, Inc. All rights reserved. Xamarin Edition 4 Export 191-192 UI Virtualization 192 Gauge 192-193 Gauge Types 193-194 Quick Start: Add and Configure 194 BulletGraph Quick Start 194-196 LinearGauge Quick Start 196-199 RadialGauge Quick Start 199-202 Features 202 Animation 202 Customize Appearance 202-204 Direction 204-205 Range 205-206 User Scenario 206 Poll Results 206-210 Input 210 AutoComplete 210-211 Quick Start: Populating AutoComplete with Data 211-213 Features 213 Data Binding 213 AutoComplete Mode 213-214 Delay 214 Highlight Matches 214-215 Keyboard Navigation 215-216 CheckBox 216 ComboBox 216-217 Quick Start: Display a ComboBox Control 217-220 Features 220 Custom Appearance 220-221 Data Binding 221 Editing 221 Keyboard Navigation 221-222 DropDown 222 Creating a Custom Date Picker using DropDown 222-223 Keyboard Navigation 223-224 Copyright © 2019 GrapeCity, Inc. All rights reserved. Xamarin Edition 5 MaskedEntry 224 Quick Start: Display a MaskedEntry Control 224-226 Mask Symbols 226-227 Toggle Button 227 Quick Start: Change State and Customize the Control 227-228 Sunburst Chart 228-229 QuickStart 229-237 Features 237 Legend 237-239 Grouping 239-240 Selection 240-242 Zooming and Panning 242-243 TreeMap 243-244 Key Features 244-245 Elements 245 Layouts 245-247 QuickStart 247-251 Features 251 Drilldown 251-252 Selection 252-255 Theming 255-256 Copyright © 2019 GrapeCity, Inc. All rights reserved. Xamarin Edition 6 Getting Started with Xamarin Edition Xamarin Edition is a collection of cross-platform UI controls developed by GrapeCity for Xamarin.iOS, Xamarin.Android, and Xamarin.Forms. Xamarin Edition has been optimized for Xamarin development, and provides native experiences in Android, iOS, and UWP. This beta release provides an opportunity for users to try out the enhanced architecture and provide feedback. For existing Xuni users, the new architecture brings many new features: UWP Support The new architecture adds the ability to use our controls in Xamarin.Forms apps targeting UWP. This grows the number of potential platforms that you can target, and allows you to utilize Microsoft’s newest technologies together. Better Performance The new controls should generally perform better than the old controls (sometimes doubling performance). By specifically focusing on the Xamarin architecture, the controls cut out some intermediary logic and are optimized for the platform. Since they’re entirely in C#, so you can also expect a more consistent experience. Designer Support The new controls should also support Xamarin’s designers for iOS and Android applications. This makes it much easier to construct your Android XML or iOS Storyboards using these controls. New Control Features The controls have been rethought for the new architecture with the combined experience of Xuni, Wijmo, as well as ComponentOne controls. Some controls have a number additional features (such as FlexGrid). The controls will continue to be in active development throughout the course of the beta. Breaking Changes for Xuni Users New Package Names The packages have changed their prefix if you're coming from Xuni. For instance, Xuni.Android.Calendar now corresponds to C1.Android.Calendar Xuni.iOS.Calendar now corresponds to C1.iOS.Calendar Xuni.Forms.Calendar now corresponds to C1.Xamarin.Forms.Calendar We have also moved to a more consistent naming scheme for our controls based on the following pattern: C1.[Platform].[ControlName] For example, FlexGrid is available in C1.Xamarin.Forms.Grid Additionally, FlexChart, FlexPie, and ChartCore have all been consolidated into one single package instead of three different packages. To use FlexChart or FlexPie, you now need to add a single package developed for the platform of your choice: C1.Android.Chart C1.iOS.Chart C1.Xamarin.Forms.Chart Namespace Changes We’ve made some changes to the namespace of the current controls, which are in line with the changes in package names. For example, Xuni.Forms.Calendar now corresponds to C1.Xamarin.Forms.Calendar. Copyright © 2019 GrapeCity, Inc. All rights reserved. Xamarin Edition 7 Minor API Changes There are some minor changes in API between ComponentOne Xamarin Edition and Xuni. These should mostly amount to additions, slight change in syntax, and use of prefix 'C1' instead of 'Xuni' in class and object names. For FlexChart, however, the control is very actively growing in terms of API, so missing features are intended to be added in the future. NuGet Packages The following NuGet packages are available for download: Name Description C1.Android.Calendar Installing this NuGet package adds all the references that enable you to use the Calendar control in your Xamarin.Android application. C1.Android.Core This is the dependency package for the control NuGet packages and is automatically installed when any dependent package is installed. C1.Android.Chart Installing this NuGet package adds all the references that enable you to use the FlexChart and FlexPie controls in your Xamarin.Android application. C1.Android.Grid Installing this NuGet package adds all the references that enable you to use the FlexGrid control in your Xamarin.Android application. C1.Android.Gauge Installing this NuGet package adds all the references that enable you to use the Gauge control in your Xamarin.Android application. C1.Android.Input Installing this NuGet package adds all the references that enable you to use the Input controls in your Xamarin.Android application. C1.CollectionView This is the dependency package for the control NuGet packages and is automatically installed when any dependent package is installed. C1.Xamarin.Forms.Calendar Installing this NuGet package adds all the references that enable you to use the Calendar control in your project. C1.Xamarin.Forms.Core This is the dependency package for the control NuGet packages and is automatically installed when any dependent package is installed. C1.Xamarin.Forms.Chart Installing this NuGet package adds all the references that enable you to use the FlexChart and FlexPie controls in your project. C1.Xamarin.Forms.Grid Installing this NuGet package adds all the references that enable you to use the FlexGrid control in your project. C1.Xamarin.Forms.Gauge Installing this NuGet package adds all the references that enable you to use the Gauge control in your project. C1.Xamarin.Forms.Input Installing this NuGet package adds all the references that enable you to use the Input controls in your project. C1.iOS.Calendar Installing this NuGet package adds all the references that enable you to use the Calendar control in your Xamarin.iOS application. C1.iOS.Core This is the dependency package for the control NuGet packages and is automatically installed when any dependent package is installed. C1.iOS.Chart Installing this NuGet package adds all the references that enable you to use the Copyright © 2019 GrapeCity, Inc. All rights reserved. Xamarin Edition 8 FlexChart and FlexPie controls in your Xamarin.iOS application. C1.iOS.Grid Installing this NuGet package adds all the references that enable you to use the FlexGrid control as well as CollectionView interface in your Xamarin.iOS application.